Repository navigation
Releases
v1.0.2 — 修复对外端口强制 TLS(mstsc 报 TLS 握手失败)
本次修复:对外端口不再强制 TLS
症状
隧道已经建立(日志显示"鉴权通过,已注册"),但外部用 mstsc / 浏览器 连对外端口时报
"TLS 握手失败",转发计数始终为 0。
根因
frps.py 的 _ensure_user_port() 给对外用户端口也套了 TLS:
server = await asyncio.start_server(..., port=port, ssl=self.ssl_ctx)这一层的对端是 mstsc、浏览器、ssh 这类普通 TCP 客户端 —— 它们只会按自己的协议直接发包,
不会先做 TLS 握手。握手在第一步就失败,frp 的转发逻辑根本没机会执行。
实测坐实(修复前):
$ openssl s_client -connect 124.221.46.169:9002
depth=0 CN=124.221.46.169, O=aio-frp ← 端口在等 TLS ClientHello
修复
对外端口默认改为明文转发,新增 --user_tls 开关保留端到端加密能力。
- 控制通道(客户端 ⇄ 服务端
serve_port)仍全程 TLS + token 鉴权,加密不省。 - 用户数据加密交给应用协议:RDP 自带 CredSSP/TLS、HTTPS 自带 TLS,
这类场景明文转发才是正确做法(官方 frp 的对外端口同样不做 TLS 包装)。
frps.py(服务端)。服务端和客户端都必须更新,只换客户端无效。
同时包含此前 v1.0.1 的全部修复
| 编号 | 问题 |
|---|---|
| BUG-1 | 服务端证书主机名硬编码 localhost,公网 IP 场景无法连接 |
| BUG-2 | 每个客户端注册让服务端干等 10 秒(已降至 1 秒内) |
| BUG-3 | 客户端启动时误生成无用的服务端证书 |
| BUG-4 | 对外端口强制 TLS,普通客户端连不上(本版新增) |
验证
--selftest→SELFTEST: PASStest_fix_e2e.py四场景全部 PASS,含明文 TCP 真实数据转发- 服务端日志确认:
用户端口已监听 0.0.0.0:9001 [明文,可直接用 mstsc/浏览器等连接]
升级步骤
- 下载本附件
- 服务端(有公网 IP 的机器):替换程序 → 重启服务端
- 客户端(内网机器):替换程序 → 重启客户端
- 两端日志确认用户端口显示为
[明文,可直接用 mstsc/浏览器等连接]
v1.0.1 — 修复服务端证书主机名不匹配(远程连接失败)
ℹ️ 本版本的 exe 存在对外端口 TLS 问题,mstsc/浏览器连不上,请改用 v1.0.2。
本次修复
BUG-1(致命)证书 SAN 与连接地址不匹配,公网 IP 场景永远连不上
服务端证书主机名被硬编码为 localhost,客户端又强制校验主机名,
用公网 IP 连接必然 certificate is not valid for 'x.x.x.x'。
界面里没有任何可以修改的入口,重导连接包也无效(包里不含 server.crt)。
protocol.py新增verify_hostname参数:可只校验 CA 链、不比对地址gen_cert.py新增load_ca/cert_san_hosts/cert_coversensure_certs()改为比对 SAN,缺地址则复用原 CA 自动重签(客户端无需换 ca.crt)- 服务端页新增「对外访问地址」,客户端页新增「严格校验证书主机名」开关
BUG-2(严重)每个客户端注册让服务端干等 10 秒
客户端不启用 UDP 时不发送可选的端口字段,服务端却用 HANDSHAKE_TIMEOUT(10s) 试探读取。
新增 REGISTER_UDP_PROBE_TIMEOUT = 0.5,注册延迟 10s → 1s 以内。
BUG-3 客户端启动时误生成一套无用的服务端证书
误导排查方向。新增 ensure_client_ca(),客户端只检查 ca.crt。
验证
test_fix_e2e.py 用本机局域网地址模拟公网 IP,四个场景全部 PASS:
| 场景 | 内容 | 结果 |
|---|---|---|
| A | 证书无该地址 + 严格校验 | 握手被拒(复现故障) |
| B | 同一证书 + 不校验主机名 | 注册成功,回声 ECHO:hello-frp |
| C | 自动补签 | SAN 含新地址,CA 指纹不变 |
| D | 补齐地址 + 严格校验 | 注册成功,回声 ECHO:hello-frp |
回归:--selftest 仍 PASS。
使用
下载 内网穿透助手.exe,放进程序数据目录(如 C:\Program Files\frp\),
重命名为原来的 frp.exe 即可。原有 certs/、tokens.txt 继续有效。
服务端启动时在「对外访问地址」填公网 IP,证书会自动重签。
补充修正
界面文案「证书有效期 1 年」与实际不符(build_server_cert 默认 days=825),
已改为「825 天(约 2 年 3 个月)」,并说明续期阈值(剩余不足 30 天自动续期)。
本附件已同步为该源码的构建产物。
内网穿透助手 v1.0.0
⚠️ 此版本存在致命缺陷,请勿使用服务端证书的主机名被硬编码为
localhost,而客户端强制校验证书主机名。
只要服务端部署在公网 IP 上(云主机都是如此),客户端连接必然在 TLS 阶段失败:[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: IP address mismatch, certificate is not valid for 'x.x.x.x'界面里没有任何可以修改的入口,重导连接包也无效。请改用 v1.0.1。
内网穿透助手 v1.0.0
基于 asyncio 实现的 FRP 内网穿透,带 token 鉴权 + TLS 加密 + 限流 + 运行统计,
免安装单文件 GUI 版(Windows x64,双击即用)。
主要能力
- TLS 加密 + token 鉴权;支持多客户端、token 轮换与热重载
- TCP 转发与 UDP 转发;P2P 打洞探测,失败自动回退中转
- 连接限流(每 IP 上限 / 活跃上限 / 排队上限)与方向性流量统计
- 证书自动续期(依赖
cryptography) - 图形界面 + 系统托盘;手机控制接口(鸿蒙客户端见
harmonyos/)
本版修复
- 修复打包版客户端 TLS 不可用:旧包在 asyncio 层拿不到
ssl模块,
任何 TLS 客户端连接都会失败,且该异常被兜底except捕获后只打一行日志、
静默退避重连,表面看像网络问题。本版重新打包,--selftest通过。
自检
frp-gui-v1.0.0-x64.exe --selftest
# 预期输出:SELFTEST: PASS
文件校验
| 项目 | 值 |
|---|---|
| 附件名 | frp-gui-v1.0.0-x64.exe |
| 下载后建议改名 | 内网穿透助手.exe(GitHub 附件名不支持中文,故用英文名) |
| 大小 | 18,857,779 字节(18.0 MB) |
| SHA256 | B12E3C9371D2917BF4A3BFB2A03DFD1125181E0073C702743C5E0DEC790B356A |
自行打包
pip install -r requirements.txt
python build_exe.py⚠️ 已废弃 · 旧版 x86-64(2026-10-13 构建)
⚠️ 此 Release 已废弃,请勿下载此处的附件。本页附件
frp-X64.exe(2026-10-13 构建)存在已确认的缺陷:
打包版客户端 TLS 不可用 —— 打包时 asyncio 一层拿不到ssl模块,
任何 TLS 客户端连接都会失败;该异常又不属于ConnectionError/OSError,
被兜底except捕获后只打一行日志便退避重连,
用户侧表现是「一直连不上,日志里也看不出原因」。另:本包也缺少 10-15 之后新增的托盘、规则引擎、手机控制接口等模块。
请改用 👉 v1.0.0
v1.0.0 已修复上述问题,
--selftest通过,并附带 SHA256 校验值。
保留此页面仅为历史记录。源码请见
main分支。