ZSFrp 文档
隧道管理

网站穿透

将本地 Web 服务(博客、管理后台、Webhook 回调等)暴露到公网。推荐 HTTP/HTTPS 隧道;也可用 TCP 映射端口作备选。

将本地 Web 服务(博客、管理后台、Webhook 回调等)暴露到公网。推荐 HTTP/HTTPS 隧道;也可用 TCP 映射端口作备选。

推荐配置

项目值
协议HTTP(或 HTTPS)
本地地址127.0.0.1:80 / 127.0.0.1:3000 等
访问控制台分配的 子域名 或 HTTP 地址

1787059198263.png

流程

1. 本地启动服务

浏览器访问 http://127.0.0.1:端口 正常即可。

框架/环境常见端口
Nginx / Apache80 / 443
Node (Express)3000
Vite 开发5173
Spring Boot8080

2. 创建 HTTP 隧道

  1. 模板 网站
  2. 本地地址填 实际监听 地址
  3. 子域名按创建页规则填写(如有)
  4. 保存并 启动 frpc

3. 外网访问

使用隧道详情中的 访问地址(如 http://xxx.节点域名)。

1787059231178.png

TCP 备选

节点不支持 HTTP 时,用 TCP 映射本地 80:

  • 访问:http://节点域名:远程端口
  • HTTPS 需自行配置证书

开发调试

场景说明
Host 校验应用需允许穿透域名,或关闭严格 Host 检查
Webhook支付/第三方回调 URL 改为穿透后的公网地址
前端 API勿仍指向 localhost,改为相对路径或公网 API
CORS后端配置允许前端穿透域名

反向代理

本地 Nginx 反代多服务时,隧道 本地地址 填 Nginx 监听端口(如 127.0.0.1:80),由 Nginx 再分发到各 upstream。

常见问题

问题处理
502 / 空白页本地服务未启动或端口错误
静态资源 404检查 base URL / 资源路径
需要 HTTPSHTTPS 隧道或 Nginx 终结 TLS
仅内网能访问确认绑定 0.0.0.0 或 127.0.0.1 与隧道一致

安全

  • 勿将未鉴权的管理页长期暴露公网
  • 生产环境使用 HTTPS 与强密码
  • 调试结束停止隧道

相关文档

On this page