内网穿透实现公网访问HeyGem：frp/ngrok配置教程
内网穿透实现公网访问HeyGem：frp/ngrok配置实战
在AI应用快速落地的今天，越来越多团队选择将数字人、语音合成、图像生成等系统部署在本地服务器上——既保障数据隐私，又能充分利用高性能GPU资源。但问题也随之而来：你的HeyGem视频生成系统跑得好好的，同事却在外地没法查看进度；客户想试用演示版，你只能发录屏……明明服务就在localhost:7860，却像被关在玻璃房里，看得见摸不着。
这背后的核心障碍，就是网络隔离。大多数实验室、办公室甚至家用宽带都没有固定公网IP，防火墙和NAT层层阻隔，外部设备根本无法直接连接到内网主机。这时候，内网穿透就成了那把“钥匙”。
frp 和 ngrok 正是目前最主流的两套解决方案。一个适合长期稳定运行，一个主打即开即用，各有千秋。接下来我们就以HeyGem 数字人视频生成系统为例，手把手带你打通从本地WebUI到公网访问的全链路。
frp：自建隧道，掌控全局
如果你希望搭建一个可长期使用、安全可控的远程访问通道，frp 是首选方案。它采用“客户端-服务端”架构，通过一台拥有公网IP的中转服务器（如阿里云ECS），为内网服务建立加密反向代理隧道。
它是怎么工作的？
想象一下：你在家里运行 HeyGem，而公网服务器像是一个24小时在线的邮局。frpc（客户端）主动向这个邮局注册：“我是192.168.1.100上的HeyGem服务，请帮我转发发往heygem.yourdomain.com的信件。” 当外部用户访问该域名时，请求先到达邮局（frps），再由它通过已建立的安全通道转交给你的本地机器。
整个过程对用户完全透明，就像直接访问了一个公网网站。
部署步骤详解
第一步：准备公网服务器（frps）
你需要一台有公网IP的Linux服务器（推荐腾讯云/阿里云轻量应用服务器）。下载对应平台的frp发行包：
wget https://github.com/fatedier/frp/releases/latest/download/frp_0.51.3_linux_amd64.tar.gz tar -zxpf frp_0.51.3_linux_amd64.tar.gz cd frp_0.51.3_linux_amd64编写服务端配置文件：
# frps.ini [common] bind_port = 7000 vhost_http_port = 8080 dashboard_port = 7500 dashboard_user = admin dashboard_pwd = your_secure_password token = very_long_and_random_string_here启动服务端：
nohup ./frps -c frps.ini > frps.log 2>&1 &此时：
-7000端口用于接收 frpc 连接；
-8080端口用于HTTP服务映射；
- 访问http://你的公网IP:7500可查看实时连接状态（账号密码见配置）。
别忘了在云平台安全组中放行这些端口！
第二步：配置本地客户端（frpc）
在运行 HeyGem 的主机上同样解压 frp 客户端，并创建配置文件：
# frpc.ini [common] server_addr = x.x.x.x # 替换为你的公网服务器IP server_port = 7000 token = very_long_and_random_string_here [heygem-web] type = http local_ip = 127.0.0.1 local_port = 7860 custom_domains = heygem.yourdomain.com保存后启动：
./frpc -c frpc.ini如果看到日志输出类似start proxy success，说明隧道已建立成功。
第三步：绑定域名 & 启动服务
将heygem.yourdomain.com的 DNS A 记录指向你的公网服务器IP。没有域名？也可以直接访问http://x.x.x.x:8080（注意开放8080端口）。
最后，在本地启动 HeyGem：
bash start_app.sh现在，无论你在世界哪个角落，打开浏览器输入http://heygem.yourdomain.com，就能看到熟悉的 WebUI 界面了。
🔐安全建议
token必须足够复杂，避免暴力破解；- 生产环境建议配合 Nginx + Let’s Encrypt SSL 证书启用 HTTPS；
- 使用 systemd 将 frpc 设为开机自启：
```systemd
/etc/systemd/system/frpc.service
[Unit]
Description=frp client
After=network.target[Service]
Type=simple
ExecStart=/path/to/frpc -c /path/to/frpc.ini
Restart=always[Install]
WantedBy=multi-user.target
```启用服务：
systemctl enable frpc && systemctl start frpc
ngrok：一行命令，立即可用
如果说 frp 是自己盖房子，那 ngrok 就是拎包入住的公寓。它最大的优势在于无需任何服务器部署，一条命令即可获得临时公网地址，特别适合调试、演示或短期协作。
它为什么这么方便？
ngrok 背后是一整套中心化基础设施。当你执行ngrok http 7860，ngrok 的云端服务会为你分配一个唯一的子域名（如https://a1b2c3d4.ngrok.io），并自动建立加密隧道。所有流量都经过其全球节点转发，省去了自建服务器的麻烦。
实战操作流程
- 注册账号并获取 authtoken（登录 ngrok.com 后可见）
- 下载客户端并授权：
./ngrok config add-authtoken <your_token>- 映射 HeyGem 服务：
./ngrok http 7860输出示例：
Forwarding https://a1b2c3d4.ngrok.io -> http://localhost:7860复制链接发给任何人，他们就能立即访问你的本地 HeyGem 页面！
适合哪些场景？
- 远程调试：开发过程中让同事快速复现问题；
- 客户演示：临时分享体验链接，结束后关闭终端即失效；
- 教学培训：学生无需理解网络原理，一键暴露本地项目；
- 移动办公：出差时用笔记本跑模型，仍能远程访问。
⚠️ 注意事项
- 免费版每次重启都会变链接，不适合长期使用；
- 带宽和并发有限制，大文件下载可能卡顿；
- Pro版本支持自定义域名、静态TCP端口、私有区域部署，适合企业级需求；
- 开源替代品如
inlets或localtunnel也可考虑，但功能较弱。
在 HeyGem 系统中的实际集成
在一个典型的数字人视频生成流程中，内网穿透并不参与核心计算，但它决定了系统的可达性与协作效率。
典型架构图
[外部用户] ↓ (HTTPS) [heygem.ai-company.com] ↓ [frps / ngrok cloud] ↑↓ 加密隧道 [frpc / ngrok agent] ←→ [HeyGem @ :7860] ↓ [音频驱动 | 视频渲染 | 输出存储]当用户上传一段音频和参考视频，提交生成任务后，即使你正在地铁上，也能通过手机浏览器随时查看任务进度条。处理完成后的MP4文件可通过WebUI一键打包下载，全程无需U盘拷贝或微信传文件。
实际痛点解决案例
| 场景 | 解法 |
|---|---|
| 实验室服务器无公网IP | frp隧道穿透校园网限制 |
| 客户不想安装软件只想试用 | 提供ngrok临时链接在线体验 |
| 批量生成耗时数小时需监控 | 外网实时查看日志与进度 |
| 团队多地协同制作内容 | 统一入口+权限管理 |
结合 Linux 命令还可实现自动化运维：
# 实时观察运行日志 tail -f /root/workspace/运行实时日志.log # 检查frpc是否存活 ps aux | grep frpc # 清理输出目录防止爆盘 find outputs/ -mtime +7 -exec rm -rf {} \;如何选择？frp vs ngrok 怎么选
| 维度 | frp | ngrok |
|---|---|---|
| 是否需要自建服务器 | 是 | 否 |
| 成本 | 低（约￥50/月起） | 免费版免费，Pro版$10+/月 |
| 稳定性 | 高（自主可控） | 中（依赖第三方服务） |
| 配置难度 | 中等 | 极简 |
| 适用周期 | 长期运行 | 临时/短期 |
| 自定义域名 | 支持 | Pro版支持 |
| 数据安全性 | 高（可私有部署） | 中（流量经第三方） |
| 适合人群 | 企业、开发者、运维 | 快速原型、教学、个人项目 |
简单来说：
- 想要稳定、安全、长期使用→ 选frp
- 想要秒级上线、快速分享→ 选ngrok
两者甚至可以共存：日常开发用 ngrok 快速测试，上线后切换至 frp 提供正式服务。
最佳实践建议
命名规范
使用清晰的子域名，如heygem-dev.company.com、heygem-demo.company.com，便于区分环境。进程守护
不要让 frpc 运行在前台终端！务必用 systemd 或 supervisor 管理，防止意外中断。日志监控
定期检查 frp 日志，关注重连次数、延迟变化，及时发现网络波动。带宽评估
HeyGem 生成的视频通常较大（几十MB~数GB），确保中转服务器带宽充足（建议至少5Mbps上行）。安全加固
- 关闭不必要的 dashboard 接口；
- 使用 TLS 加密通信（frp 支持tls_only = true）；
- 结合 Nginx 添加 Basic Auth 认证层。成本控制
对于非7×24小时使用的场景，可选用按量计费的云服务器，不用时关机节省开支。
这种“本地运行 + 公网可访”的模式，正在成为AI工程化的新常态。无论是 Stable Diffusion、本地大模型对话系统，还是语音克隆工具，只要有一个Web界面，都可以通过同样的方式对外暴露。
掌握 frp 和 ngrok 的使用方法，不只是为了访问一个 HeyGem 页面，更是构建现代AI工作流的基础能力之一。下一次当你在本地跑完一个惊艳的生成结果，别再截图发群了——直接甩出一个链接：“点开就能看，不限地域。”