快连如何在OpenWrt固件中配置透明代理实现全设备免客户端？

功能定位：为什么选透明代理而非传统客户端

核心关键词“快连透明代理”解决的是多设备免维护痛点：手机、电视、IoT 无需安装任何 App，只要连上路由器就能自动走海外线路。相比在每台终端装快连客户端，透明代理把维护工作量收敛到路由器单点，升级、换节点、分流规则一次配置全局生效。

从 2025 年末开始，快连官方把WireGuard 2.0 配置文件与V2Ray JSON 订阅同时下放到用户后台，意味着路由器端可直接拉取带 TTL 偏移、UDP-over-TLS 等参数的“路由器专用链接”，不再需要手动拼接密钥。只要固件支持 nftables 或 iptables，就能在三层把流量劫持到快连进程，实现“零感知”翻墙。

版本脉络：OpenWrt 21→23→24 的代理框架差异

OpenWrt 21 仍默认 iptables，透明代理靠 redsocks/tproxy 补丁；22 起官方推荐 nftables，但内核 5.10 驱动对 UDP 转发有 6% 左右性能回退；23.05 之后 firewall4 全面 nftables 化，快连后台提供的自动安装脚本已默认检测防火墙后端，回退到 iptables-legacy 或升级 nft 规则集，截至当前的最新版本可一键完成。

若你仍在 19.07 及更早版本，建议先 sysupgrade 到 23.05 稳定版，再执行快连脚本；否则会出现 kmod-tun 与内核 ABI 不匹配，导致 WireGuard 接口启动即崩溃。

决策树：我该用哪种透明代理方案

1. 终端数量 < 5、无 NAS/电视：继续用快连 App 即可，透明代理收益有限。
2. 终端数量 ≥ 5、含 Apple TV、PS5、智能投影：透明代理一次解决商店区域限制，无需每台配账号。
3. 主路由 CPU 单核 < 800 MHz：优先选 WireGuard 2.0，CPU 占用约为 V2Ray 的 1/3；若坚持 V2Ray，建议开“仅 TCP 转发”模式。
4. 需要精细分流（国内直连、海外代理）：用 V2Ray，支持 GeoSite/GeoIP 规则一键导入；WireGuard 方案需额外写 nftables set，维护成本高。

前置准备：拿到路由器专用订阅

登录快连网页后台 → 左侧“路由器/CLI” → 选择“WireGuard”或“V2Ray”标签 → 下方勾选“生成本地 NAT 映射” → 复制“自动配置脚本地址”。注意此链接含设备 UUID，切勿公开分享。

安装步骤：以 OpenWrt 23.05 + WireGuard 2.0 为例

1. 刷入固件与基本联网

使用官方 sysupgrade 镜像（squashfs-factory），刷机后先不拔 WAN，进 LUCI → System → Software → Update lists，确认能正常解析域名。

2. 一键脚本下载

ssh [email protected]
opkg update && opkg install curl
sh -c "$(curl -fsSL https://router.quicklink/v1/wg2/openwrt-init.sh)"

脚本会自动检测防火墙后端，若为 nftables，将安装 quicklink-nft 套件；若为 iptables，则拉取 quicklink-ipt。安装完会提示“QuickLink TPROXY service installed”。

3. 导入订阅

uci set quicklink.cfg.url='https://router.quicklink/v1/wg2/xxxxxxxx'
uci commit quicklink
/etc/init.d/quicklink restart

此时路由器会建立名为 qlwg0 的虚拟接口，并自动向 WAN 上游宣告 0.0.0.0/0 走该接口；局域网设备保持默认 DHCP，无需改网关。

4. 验证透明代理生效

在局域网任意终端访问 ipinfo.io，应显示“QuickLink LTD”出口；再执行 ping 1.1.1.1，延迟应与快连客户端一致（经验性观察：亚秒级握手）。

可选分流：让国内视频直连

编辑 /etc/quicklink/rules.nft，加入：

set cn_ipv4 { type ipv4_addr; flags interval; }
element cn_ipv4 { 223.252.199.0/24, 183.232.0.0/16 }
meta l4proto { tcp, udp } ip daddr @cn_ipv4 return

保存后 /etc/init.d/quicklink reload，B 站、爱奇艺流量即绕过快连，降低 30% 以上带宽占用。

平台差异：命令行与 LUCI 插件对照

操作	SSH	LUCI → Network →
查看 qlwg0 接口	ip -4 a show qlwg0	Interfaces → qlwg0
重启代理	/etc/init.d/quicklink restart	Services → QuickLink → Restart
更新订阅	quicklink-update	Services → QuickLink → Update

回退方案：脚本出错如何自救

若执行脚本后 LAN 断网，可插网线进 SafeMode：断电重启，指示灯闪烁时按 Reset 5 秒，系统会进入 192.168.1.1/24 的 failsafe，SSH 登录后执行：

mount_root
opkg remove quicklink-nft quicklink-ipt
rm -rf /etc/config/quicklink
/etc/init.d/network restart

即可回到纯净网络；之后再核对订阅链接是否过期或 UUID 是否含特殊字符。

性能观测：如何量化透明代理效果

1. 在路由器安装 collectd + luci-statistics，勾选 interface → qlwg0，可看到实时带宽曲线；
2. 用 quicklink-status 命令会输出“avg_latency=”与“peak_loss=”，经验性观察：晚高峰 <0.3% 丢包即达标；
3. 在终端跑 curl -o /dev/null -w '%{time_total}' https://registry.npmjs.org，对比直连与代理，拉包时间应缩短 40–60%。

不适用场景与合规边界

• 公司内网 802.1X 认证：透明代理会劫持 EAPOL 包，导致认证失败；需把办公 VLAN 排除在 nftables 之外。
• IPv6-only 网络：快连 WireGuard 2.0 目前仅分配 /128 地址，电视盒子若强制 AAAA 会超时；可在 LAN 口关闭 RA。
• 跨省聚合宽带（多拨）：qlwg0 接口只能绑定单一路由表，多拨后会出现源地址错位，需在 mwan3 里把 qlwg0 设为“独立策略”。

FAQ：透明代理高频疑问

最佳实践清单（可打印）

1. 刷机前用 sha256sum -c 核对固件，避免第三方植入挖矿。
2. 订阅链接用 uci set quicklink.cfg.url 写入，不要手写，防止 UUID 截断。
3. 每周跑一次 quicklink-update，节点掉线会自动切换，无需手工重启。
4. 把路由器时钟同步到 pool.ntp.org，WireGuard 对时间差 >30 秒会握手失败。
5. 备份 /etc/config/quicklink 与 /etc/quicklink/rules.nft，升级固件后可直接还原。

收尾：下一步行动建议

透明代理配置完成后，你的局域网已具备“零客户端”出海能力。先跑一周观测延迟与流量，确认无断流再把家人设备全部纳入；若追求 4K/8K 多屏，同时开 3 条 WireGuard 接口做负载均衡，也能在快连后台一键生成。记得把本文“最佳实践清单”贴在路由器外壳，下次固件升级就能 5 分钟无痛还原。