快连无法导入订阅链接时如何手动添加节点？

功能定位：订阅失败时的兜底方案

快连 privacy tool 的「订阅链接」本质是一段 HTTPS 地址，客户端定时拉取节点列表并自动填充。当域名被本地 DNS 污染、URL 返回 4xx/5xx 或 TLS 握手超时，客户端会提示「订阅更新失败」。此时手动添加节点成为唯一可用兜底通道，也是排查订阅源是否失效的快速验证手段。

手动节点与订阅节点的运行地位完全平等，均可参与「AI-Route 2.0」智能选路，也受「零日志」策略保护；差异仅在于更新方式：后者可被官方一键刷新，前者需用户自行维护。

前置检查：确认你手里有什么

在开始之前，先把订阅方提供的备用信息复制到备忘录，通常包括：

• 服务器地址（域名或 IP）
• 端口号
• 加密方式（QuickConnect / WireGuard / Openprivacy tool-over-QUIC）
• UUID 或公钥字符串
• 额外参数（如 MTU、keep-alive）

缺少任何一项都会导致「保存成功但无法握手」。若只有二维码，可用系统相机扫码后复制文本，再拆解上述字段。

平台差异：三条最短入口

Android / iOS

首页 → 右上角「+」→「手动输入节点」→ 选择协议标签页（QuickConnect 最快）→ 按提示粘贴 → 保存。

Windows / macOS

左侧导航「节点」→「添加自定义」→ 在弹出抽屉里切到对应协议 → 填写 → 确定；支持回车键快速跳转输入框。

Linux CLI（经验性观察）

截至当前的最新版本尚未提供原生 TUI，需编辑 ~/.config/quicklink/manual.json，格式与 WireGuard 官方配置 1:1 对应，保存后执行 qlctl reload 即可热加载。

填写规范：让 AI-Route 能认出你

1. 服务器地址不要带协议头，例如只写 sg-kr1.qc-link.com，而不是 https://。
2. 端口与加密方式必须和订阅源保持一致；若订阅方曾推送「443 走 QuickConnect」而你误填 51820，握手会返回「bad identity」。
3. WireGuard 公钥末尾的「=」不可省略，否则客户端会提示「key format error」。

连通性验证：三步确认节点可用

1. 保存后回到首页，点卡片右侧「测延迟」，若 <300 ms 且丢包 0%，说明网络层可达。
2. 开启「分应用代理」，仅把浏览器纳入隧道，访问 ip.skk.moe 看出口 IP 是否与节点所在地一致。
3. 播放 YouTube 4K 60 帧视频 30 秒，统计卡顿次数；若 0 次，则带宽与 QoS 正常。

任一步失败，回到「手动输入」界面检查端口或协议是否被本地防火墙拦截。

常见失败分支与回退

提示码	可能原因	处置
handshake timeout	IP 被封或端口未放行	换端口 443/853 再走 QuickConnect
bad identity	UUID/公钥写错	重新复制，注意大小写与尾部=
DNS resolve fail	域名被污染	把域名换成节点 IP 并关闭「域名嗅探」

何时不建议手动添加

1. 节点数量 >20 个：手动维护成本高，易与订阅源产生差异，建议让订阅方修复域名。
2. 公司 MDM 设备：部分企业 iPhone 会禁止「自定义 privacy tool 配置」描述文件，手动添加虽能保存但无法激活，徒劳。
3. 需要住宅 IP 轮换：手动节点固定不变，无法满足 TikTok 养号场景，应等待订阅源恢复。

与 Clash/v2ray 规则集协同

快连支持一键导入外部规则，但手动节点不会自动写入 config.yaml。若你同时用 Clash 做本地网关，需要把节点信息额外复制到 proxies: 段落，并确保名字与 proxy-groups 引用一致，否则 Clash 会报「proxy not found」而回退 DIRECT。

性能与成本取舍

经验性观察：手动节点因跳过订阅解析环节，启动耗时平均缩短约 0.3 秒；但失去「自动剔除高延迟节点」能力，若服务器端出现晚高峰拥堵，你需要手动删除并替换，否则 4K 视频峰值带宽可能从 150 Mbps 跌到 60 Mbps。

FAQ：手动添加节点常见疑问

验证与观测方法

1. 使用 ping -c 50 对节点 IP 采样，若丢包 >2%，判定链路不稳。
2. 打开「设置-诊断-导出日志」，搜索 handshake 关键字，若出现连续 3 次「retry」即需更换端口。
3. 在路由器端抓包，若看到大量 10 秒重传，可基本确定 MTU 不匹配，把手动节点 MTU 降到 1280 可恢复。

适用/不适用场景清单

场景	建议
出差 3 天，临时办公	手动添加 2 个低延迟节点，够用且省心
直播公司 50 人团队	必须等订阅恢复，否则维护成本爆炸
学术下载，需 24h 在线	手动节点可做冷备，主线路仍走订阅

最佳实践检查表

• 复制节点信息时，使用纯文本编辑器，防止隐藏字符。
• 保存后立刻「测延迟」，延迟 >400 ms 直接放弃。
• 每 7 天抽查一次节点是否被墙，发现超时立即删除。
• 不混用「游戏专线」与「普通节点」于同一策略组，避免 AI-Route 误判。
• 导出二维码给同事前，把「上行限速」设为 50 Mbps，防止单用户占满带宽。

收尾：下一步行动

手动添加节点是快连 privacy tool 在订阅链路失效时的最后一道保险，掌握填写规范与验证流程后，你可在 2 分钟内恢复联网。建议把本文「检查表」截图存为相册收藏，下次遇到「订阅更新失败」直接对照操作；同时给订阅方提交工单，敦促其修复域名，毕竟长期维护 4500+ 节点才是治本方案。

未来趋势：订阅自愈与本地缓存

经验性观察显示，快连正在灰度「订阅自愈」功能：当域名被污染，客户端会尝试内置 DoH 解析并回退到 IP 级请求，预计下一正式版将减少 60% 以上手动添加场景；与此同时，本地缓存节点列表的 TTL 有望延长至 72 小时，为订阅源抢修留出更宽裕的时间窗口。