快连如何在OpenWrt上安装IPK并设置开机自启？

功能定位与版本演进

在路由器侧运行快连（QuickLink）客户端，可把整网流量统一接管，省去逐台设备配置的麻烦。官方自 2025Q4 起提供 mipsel_24kc、aarch64_cortex-a53 等主流架构的 IPK，体积约 3.8 MB，集成 QuickEngine 内核与 procd 启动脚本，适配 21.02 以上 OpenWrt。与旧版 Shell 脚本相比，IPK 支持 UCI 配置、Syslog 分级日志，升级时自动备份 /etc/quicklink/conf.ini，回滚更方便。

若你仍在使用 19.07 或更低版本，需先手动编译 libwolfssl 5.x，否则会出现 "symbol not found" 错误；经验性观察显示，22.03+ 系统可直接安装，无需额外源。

前置检查：固件、空间与依赖

1. 确认架构与剩余空间

SSH 登录路由器，执行：opkg print-architecture | grep -E 'arch|all'，返回行中需包含与下载文件名一致的 arch，如 mipsel_24kc。随后 df -h / 确保剩余空间 ≥ 10 MB，否则先清理 /tmp/opkg-lists 或卸载无关的 LuCI 主题。

2. 更新软件列表与核心依赖

依次执行：opkg update && opkg install libustream-wolfssl ca-bundle ca-certificates。若使用 mbedtls 固件，可把 wolfssl 换成 mbedtls 变体，但需保证与快连 IPK 的 SSL 库一致，避免启动时 TLS 握手失败。

获取官方 IPK 与校验

在电脑端浏览器打开 https://kuailian.today/openwrt，选择「路由器固件→IPK 下载」。页面提供 sha256 校验值，下载完成后执行：sha256sum quicklink_*.ipk，比对一致再继续。经验性观察：部分 Chromium 内核浏览器会把文件标记为「不安全」而中断，换 Firefox 或 wget 可绕过。

安装步骤：最短可达路径

将 IPK 上传至 /tmp：

scp quicklink_6.4.0_mipsel_24kc.ipk [email protected]:/tmp

SSH 登录并安装：
```
opkg install /tmp/quicklink_*.ipk
```
若提示「Unknown package 'quicklink'」，先执行 opkg update 刷新索引。
立即启动一次，验证无 segfault：
```
/etc/init.d/quicklink start
logread -e quicklink | tail -20
```
看到「QuickEngine core ready, latency 12 ms」即表示加载成功。

设置开机自启：procd 与 UCI 双保险

1. procd 级自启

安装包已内置 procd 脚本，只需：/etc/init.d/quicklink enable，该命令实质创建 /etc/rc.d/S95quicklink 软链，开机时由 procd 拉起守护进程。

2. UCI 参数固化

编辑 /etc/config/quicklink，把账号、区域、分流模式写进 UCI，可避免升级后配置被覆盖。示例：

config quicklink 'main'
    option username '12345678'
    option region 'auto'
    option split_apps '1'

保存后执行 /etc/init.d/quicklink restart 让 UCI 生效。

提示：若你习惯手动改 conf.ini，请关闭 UCI 同步选项，否则重启后会被覆盖。

例外与副作用：何时不该用

1. 64 MB 内存老路由：QuickEngine 常驻约 18 MB，加上 OpenWrt 基础进程后剩余不足 10 MB，容易出现 OOM。可改用「轻量转发模式」，在 /etc/config/quicklink 里关闭 AI 分流，内存降至 8 MB 左右。

2. 已部署 iptables 重定向的旁路由：快连默认会接管 0.0.0.0/0，可能与 SSRP、PassWall 等产生冲突。解决思路：在「自定义防火墙规则」里把 127.0.0.1/8 与局域网段排除，或改用策略路由。

警告：开启「全局代理」后，路由器自身访问国内 NTP、opkg 也会被转发，导致时间校准失败。可在「路由器本机直连域名」里填写 *.openwrt.org、*.aliyun.com。

验证与观测：如何确认生效

客户端验证：手机连接 Wi-Fi，访问 ip.skk.moe，应显示出口与所选区域一致。
延迟测试：ping 1.1.1.1 -c 10，经验性观察，在广东 200M 宽带下平均延迟 28 ms，比直连提升约 15 ms。
日志监控：logread -f | grep -E 'quicklink|QuickEngine'，若出现 "handshake retry 5/5" 连续报错，说明节点被限速，可手动切区。

回退与卸载：干净移除方案

1. 停止服务：/etc/init.d/quicklink stop && /etc/init.d/quicklink disable

2. 卸载包：opkg remove quicklink，系统会提示是否删除 /etc/config/quicklink，选择 N 可保留配置待下次重装。

3. 清理防火墙残留：检查 /etc/firewall.user 是否含有 quicklink 注入规则，手动删除后重启防火墙。

性能调优：让老路由多撑两年

1. 关闭 debug 日志

默认日志级别为 info，每小时写入约 1.2 MB。把 /etc/config/quicklink 里的 log_level 改为 2（warning），闪存寿命可延长约 30%。

2. 降低并发连接数

家庭 20 终端场景下，把 max_conn 从 1024 调到 512，CPU 占用下降 5–8 个百分点，网页打开主观无差异。

FAQ：最常见 5 个问题

安装时提示「Architecture mismatch」怎么办？

说明你下载的 IPK 与 CPU 架构不符，重新核对 cat /proc/cpuinfo | grep machine 给出的型号，选择对应文件夹重新下载即可。

启动后 30 秒自动退出，日志显示「Out of memory」？

设备内存不足，先关闭其他插件（如 AdGuardHome），再在 /etc/config/quicklink 里设置 lightweight='1'，重启即可。

如何指定出口区域而不是 auto？

把 /etc/config/quicklink 中的 region 选项从 'auto' 改为 'jp'、'us' 等两位字母缩写，保存后重启服务。

升级 OpenWrt 后快连消失？

系统升级会清掉 /overlay 上层，需重新安装 IPK；若之前做了 /etc/config 备份，直接 opkg install 后把备份文件还原即可。

想完全禁止路由器自身流量走隧道，如何设置？

在 /etc/config/quicklink 中添加 list router_exempt '1'，重启后，路由器本机进程将使用原始 WAN 出口，局域网设备仍走隧道。

适用/不适用场景清单

场景	推荐	原因/边界
家庭 100 M 以下宽带，终端 ≤15	✔	CPU 占用 <30%，内存余量充足
公司 500 M 出口，员工 50+	✘	单核路由性能瓶颈，需 x86 软路由或企业版
已跑 Suricata/AdGuardHome 全规则	△	内存吃紧，需关闭 AI 分流或加内存
出差酒店，携带 GL-MT3000 做旁路由	✔	便携、即插即忘，USB-C 供电即可

核心结论与下一步行动

在 OpenWrt 上安装快连 IPK 并启用开机自启，整体耗时不足十分钟，却能给全屋设备带来无缝加速。只要提前核对架构、留足空间，并按文内「例外与副作用」评估自身场景，就能在性能与稳定性之间取得平衡。

下一步，你可以：

把 region 改成自己常用的区域，减少每日 auto 切换的 3–5 秒等待；
配合 crontab 每周一凌晨 /etc/init.d/quicklink restart，防止长连接堆积导致的内存碎片；
若设备内存 <128 MB，优先开启 lightweight 模式，并关闭 debug 日志，老路由还能再战两年。

完成上述三步后，你的 OpenWrt 路由器就拥有了与客户端版本几乎一致的 AI 分流、4K 流媒体解锁与无日志审计能力，而维护成本仅是一条重启命令。祝安装顺利，有问题先到官方 GitHub Issues 搜索关键词，再开新帖附上 logread -e quicklink 输出，响应速度会更快。