快连端口转发配置指南

功能定位：为什么要在快连里开“端口转发”

2025 版快连把“端口转发”归入【安全隧道→高级策略】，官方描述为“基于 WireGuard-2025 内核的定向流量映射”，核心作用是：让对端节点以 127.0.0.1:端口形式访问本机服务，全程走加密隧道，不暴露真实公网地址。与“智能组网”相比，它多了三层审计钩子：每条映射都会写一条 JSON 日志到本地 datastore，企业版可直接推送至 Splunk，满足等保 3.0 关于“南北向流量可回溯”要求。

经验性观察：如果只想临时传文件，用“智能组网”就够了；一旦涉及数据库、PLC、RTSP 这些需要固定端口、长期在线的场景，就必须上端口转发，否则重启客户端后虚拟 IP 漂移，会导致服务失联。

操作路径（分平台最短入口）

Windows / macOS v8.4

主界面右上角【≡】→【安全隧道】→【高级策略】→【端口转发】→【新增映射】。
填写“本地服务端口”（如 5432）、“协议”（TCP/UDP/Both）、“对端节点别名”（下拉自动带出已组网设备）。
打开【生成合规日志】开关，选择留存周期（7/30/90 天，默认 30）。
点击【保存并下发】，约 3 秒后在事件栏看到“PortMap OK”。

回退：在同一列表左滑即可“暂停”或“删除”；暂停后日志仍保留，删除则立即清空本地缓存（企业后台有备份除外）。

Android / iOS v8.4

首页【隧道】页签→【高级】→【端口转发】→右下角“＋”。
由于屏幕限制，协议与对端节点被折叠到二级菜单，需点【展开】。
移动端默认不开启“日志上传”，若需要合规，手动打开【记录到本地】，后续通过【我→设置→导出日志】以 .zip 形式发送邮件。

群晖 / QNAP 插件

在 DSM 7.2 的【套件中心→快连→端口映射】即可看到与桌面版同源界面；NAS 重启后映射由守护进程自动重载，无需额外写 rc.script。

场景映射：谁在用、怎么用

连锁零售：总部 ERP → 分店 PostgreSQL

某 300 家便利店品牌，每家店内迷你工控机跑 PostgreSQL。总部 BI ��要凌晨 02:00 拉取日结数据。做法：在分店侧把 5432 做端口转发，对端写“总部-BI”；总部 BI 侧连接字符串改成 host=10.252.x.x port=5432，走加密隧道。实测 150 MB 数据 38 秒传完，丢包 0。合规要点：打开【生成合规日志】，Splunk 每天自动归档，留存 90 天，方便审计。

家庭 NAS：外出访问 TrueNAS WebUI

用户把 TrueNAS 管理口 443 映射到手机端，旅游时通过 https://10.252.8.5 直接登录。注意：TrueNAS 默认证书不被信任，需在“对端节点”侧手动信任一次；否则浏览器会阻断，日志里会出现“TLS handshake fail”记录。

工业采集：PLC Modbus-TCP 回传 MES

边缘网关没有公网，通过 502 端口转发把 PLC 数据送到云端 MES。经验性观察：若 PLC 扫描周期 <100 ms，建议把映射协议设成“TCP＋Keepalive 30 s”，否则隧道空闲 60 s 会被网关 NAT 回收，导致首包超时。

不适用清单：何时不该用端口转发

服务端口频繁变动（如 Docker 随机端口）——应改用“智能组网”的别名解析。
高并发短连接 >5 万/分钟——目前快连单节点会话表上限 6 万，超过会触发“Session Table Full”告警，需拆分到多节点。
需要客户端侧零配置——端口转发要求对端手动填写端口，终端用户易输错；此时推荐“远程桌面加速模板”，一键下发。

例外与取舍：国密/量子双证书的影响

2025 年 11 月 v8.4 新增“国密/量子双证书”后，加密套件改为 SM4+Kyber，CPU 占用比单 AES-256 高约 12%。经验性观察：在 ARM v8 路由器（MT7622）上单条 100 Mbps 转发，开启后整机 CPU 从 38% 涨到 50%，若继续开 5 条以上映射，可能出现软中断堆积，延迟抖动 +8 ms。缓解方法：在【安全→加密级别】把“数据面”降为 SM4 only，控制面保持双证书，即可把 CPU 降回 42%，延迟抖动 <2 ms。

故障排查：从现象到验证

现象	可能原因	验证步骤	处置
对端提示“Connection refused”	本地服务未监听；监听在 127.0.0.1 以外	netstat -an \| findstr 端口号	把服务绑定到 0.0.0.0 或 127.0.0.1
日志里“Handshake timeout”	两端版本不一致；中继被封锁	事件栏看“Version”字段	统一升级到 8.4；切到 TCP 中继
能 ping 通但端口不通	协议选错；Windows 防火墙阻截	对端 telnet 10.252.x.x 端口	把映射协议改成 Both；加防火墙入站规则

验证与观测方法

日志字段速读

合规日志为单行 JSON，关键字段：src_virtual_ip、dst_port、bytes_sent、bytes_recv、session_end_reason。可以用 Splunk 语句

index=kuailian dst_port=5432 | stats sum(bytes_sent) as 出站流量 by src_virtual_ip

快速统计每个分店上传字节数，误差 <1%（经验性结论，样本 30 天）。

性能基线

在 100 Mbps 对称光纤、RTT 28 ms 环境下，单条 TCP 映射 iperf3 可跑到 96 Mbps，CPU 占用（i5-1235U）12%；再开第 4 条，总带宽 380 Mbps，CPU 38%，接近线性。超出 8 条后边际衰减明显，可视为软上限。

版本差异与迁移建议

v8.3 及更早版本把端口转发放在【实验室功能】，需手动打开“开发者模式”，且日志格式为 CSV，字段少 3 项（无 session_end_reason）。若企业已用 8.3 采集半年数据，建议：①先在 8.4 控制台把“日志格式兼容”开关打开，可同时输出新旧两种格式；②等 Splunk 解析脚本更新后，再关闭兼容，防止断档。

最佳实践清单（可直接打勾）

端口转发前检查表

服务已绑定 127.0.0.1 或 0.0.0.0，确认 netstat 无 127.0.0.53 之类特殊地址。
本地防火墙已放行对应端口（Windows 需同时开“专用+公用”）。
对端节点版本号≥8.4，防止量子密钥协商失败。
映射协议选“Both”，除非明确知道只用 TCP 或 UDP。
打开【生成合规日志】，留存周期≥审计要求。
单节点映射数≤8，CPU 占用<50%，留 20% 余量给突发。
关键业务在控制台加“告警阈值”，如单会话流量>5 GB/小时自动邮件。

未来趋势：端口转发会消失吗？

官方路线图 2026 Q2 提到“无端口化”试点，即通过 QUIC Stream 直接把服务名解析到隧道，用户不再需要填端口。但日志侧仍需记录流 ID→服务端口的映射表，以满足审计。换言之，端口转发界面可能简化成“服务别名”，底层仍是端口映射，合规逻辑不变。建议现阶段继续按本文配置，未来只需把“端口”字段换成“服务名”，迁移成本接近零。

收尾结论

快连 Lets快连的端口转发不是简单的“打洞”，而是把加密、会话、审计做在一条策略里。按本文路径 3 步完成映射后，你得到的是：①可回溯的 JSON 日志；②国密/量子双证书加密；③不依赖公网 IP 的直连隧道。只要记住“≤8 条、Both 协议、开日志”这三条硬规则，就能在连锁门店、NAS、工业 PLC 任何场景下复制落地。2026 年即使界面无端口化，审计字段也会保留，现在打下的日志规范不会白费。

案例研究

案例 A：50 人初创团队——GitLab 内网暴露

背景：团队无固定公网，代码库在内网 10.0.0.30:80，外包人员需临时只读。

做法：在 GitLab 宿主机开 80→Both，对端节点给外包电脑设只读别名；开启 7 天日志留存。

结果：3 天完成代码审计，总流量 1.2 GB，无中断；结束后暂停映射，日志打包发 HR 归档。

复盘：临时场景宜选最短留存周期，减少硬盘占用；外包侧若用 Mac，需提前在钥匙串信任自签证书，避免浏览器拦截浪费时间。

案例 B：2000 点位巡检机器人——MQTT 上行

背景：机器人跑 4G/5G，每 30 秒上报 4 KB MQTT，峰值 2000 并发。

做法：将云端 EMQX 1883 映射到机器人侧，采用“TCP＋Keepalive 60 s”，日志关闭减少写盘。

结果：上线首周会话峰值 5.8 万，未触发“Session Table Full”；CPU 占用 45%，延迟 18 ms。

复盘：高并发短连接务必开 Keepalive，避免 NAT 超时重连；若点位再增加 30%，需提前拆分到第二中继节点，防止触及 6 万上限。

监控与回滚

Runbook：异常信号、定位、回退

异常信号：控制台事件栏出现“PortMap FAIL”或“Session Table Full”；Splunk 告警 bytes_recv=0 持续 5 分钟。

定位步骤：

对端执行 telnet 10.252.x.x 端口，若立刻返回“Connection refused”→本地服务宕机。
若 telnet 卡 3 s 后超时→检查两端版本号，事件栏搜索“Version mismatch”。
若事件栏出现“CPU softirq >90%”→加密级别过高，切入【安全→加密级别】降级。

回退指令：

# 暂停单条映射（不删配置）
curl -X PATCH https://console.kuailian.net/api/v1/portmap/$map_id/status \
  -H "Authorization: Bearer $token" -d '{"status":"pause"}'

# 一键还原
同上，status 改回 "active"

演练清单（季度）：

模拟本地服务宕机→5 分钟内收到 Splunk 邮件。
模拟版本降级→事件栏出现“Handshake timeout”，确认脚本自动切中继。
模拟 CPU 占满→软中断 >90%，人工降级加密级别，延迟恢复 <30 s。

FAQ

Q1：端口转发能否映射一段连续端口？

A：目前 UI 仅支持单端口；需批量请调用 REST API 循环下发。

背景：控制台设计遵循最小权限原则，防止误操作大开区间。

Q2：映射后本地服务改用 IPv6 会怎样？

A：快连虚拟网仍走 IPv4，服务若只监听 ::1，对端会“Connection refused”。

证据：WireGuard-2025 内核尚未启用 v6 数据面，官方文档明确标注“仅限 v4”。

Q3：日志能否直接送到 Syslog 而非 Splunk？

A：企业版支持 RFC5424 UDP/TLS，需在【日志推送→第三方】填写服务器:端口。

证据：控制台帮助页“Syslog 配置示例”附带 rsyslog 模板。

Q4：家用宽带无公网 IP，转发后速度为何反而更快？

A：UDP 打洞成功，流量走 P2P 中继，不再绕运营商 NAT，RTT 下降。

经验性观察：北京联通 100 M 下行，打洞后测速可提升 15%。

Q5：能否把 RDP 3389 映射到公网？

A：端口转发仅在对端虚拟网可见，不暴露公网，符合最小权限。

如需额外安全，可在【访问控制】限定源虚拟 IP 白名单。

Q6：映射数已达 8 条，再加会提示什么？

A：事件栏报错“PortMap limit exceeded”，需删除旧映射或拆新节点。

背景：单节点会话表硬限 6 万，8 条映射在高并发下已接近阈值。

Q7：Mac 端口号 <1024 需 sudo 吗？

A：快连已自带 network entitlement，映射 80/443 无需 sudo。

若本地服务监听 80，仍需 root，但这是服务自身限制，非快连。

Q8：日志留存 90 天，硬盘大概占多少？

A：经验公式：每条映射 1 KB/小时，8 条 90 天≈ 70 MB，可忽略。

样本：300 分店 PostgreSQL，90 天日志 68.3 MB， gzip 后 11 MB。

Q9：端口转发与“远程桌面加速模板”冲突吗？

A：两者底层均用同一隧道，但模板额外启用 UDP 前向纠错；同时开无冲突。

经验：RDP 场景优先用模板，端口转发留作其它服务。

Q10：能让映射走特定中继吗？

A：控制台【中继策略】支持“映射级”标签，填写中继别名即可。

背景：跨国场景下可强制走香港中继，降低丢包。

术语表

WireGuard-2025

快连基于 WireGuard 1.0 的二次开发内核，首现于 2025 版客户端。

虚拟 IP

快连组网后自动分配的 10.252.0.0/16 地址，用于隧道内互访。

Both 协议

端口转发选项，等价于 TCP+UDP 双协议同时映射。

国密/量子双证书

v8.4 新增加密套件，数据面 SM4，控制面 SM4+Kyber。

Session Table Full

单节点并发会话达 6 万时触发的系统告警，需拆节点。

JSON 日志

单行结构化日志，含 src_virtual_ip 等字段，用于审计。

Splunk

第三方日志分析平台，企业版快连内置 HEC 推送。

Keepalive

TCP 保活参数，推荐 30–60 s，防止 NAT 回收。

PortMap OK

事件栏成功下发映射的提示关键字。

中继策略

控制台功能，可按标签强制流量走指定中继。

开发者模式

v8.3 及更早隐藏功能的总开关，v8.4 后已废除。

HEC

Splunk HTTP Event Collector，接收快连日志的端点。

SoftIRQ

Linux 内核软中断指标，过高说明 CPU 因加密被占满。

网络 entitlement

macOS 权限声明，允许 App 监听低端口。

QUIC Stream

官方 2026 无端口化底层技术，仍处试点阶段。

等保 3.0

中国网络安全等级保护标准，要求南北向流量可回溯。

风险与边界

不可用情形：

服务端端口随机（Docker ephemeral）→ 映射无法固定。
高并发短连接 >5 万/分钟→ 单节点会话表硬顶 6 万，易丢包。
需要零配置终端→ 端口转发要求对端手动填端口，易输错。
内核 <4.14 的旧路由器→ 无法加载 WireGuard-2025 kmod。

副作用：国密/量子双证书下 CPU 上涨 12%，ARM 路由延迟抖动 +8 ms；若降级为 SM4 only 可缓解。

替代方案：

智能组网：适用于端口常变、无需固定地址场景。
远程桌面加速模板：RDP/SSH 零配置，一键下发。
SaaS 反向代理：把服务直接搬到云端，弃用端口映射。