Skip to content

Releases

v1.0.2 — 修复对外端口强制 TLS(mstsc 报 TLS 握手失败)

Choose a tag to compare

@zhiyuan-cyber zhiyuan-cyber released this 02 Nov 07:22

本次修复:对外端口不再强制 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: PASS
  • test_fix_e2e.py 四场景全部 PASS,含明文 TCP 真实数据转发
  • 服务端日志确认:用户端口已监听 0.0.0.0:9001 [明文,可直接用 mstsc/浏览器等连接]

升级步骤

  1. 下载本附件
  2. 服务端(有公网 IP 的机器):替换程序 → 重启服务端
  3. 客户端(内网机器):替换程序 → 重启客户端
  4. 两端日志确认用户端口显示为 [明文,可直接用 mstsc/浏览器等连接]

v1.0.1 — 修复服务端证书主机名不匹配(远程连接失败)

Choose a tag to compare

@zhiyuan-cyber zhiyuan-cyber released this 02 Nov 06:46

ℹ️ 本版本的 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_covers
  • ensure_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

Choose a tag to compare

@zhiyuan-cyber zhiyuan-cyber released this 31 Oct 16:34

⚠️ 此版本存在致命缺陷,请勿使用

服务端证书的主机名被硬编码为 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 构建)

Choose a tag to compare

@zhiyuan-cyber zhiyuan-cyber released this 13 Oct 13:57
6f01a44

⚠️ 此 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 分支。