功能定位：为什么要在 Linux 端做“无人值守”

在服务器、软路由或迷你主机里，快连 kuailian 常被当成透明通道。如果每次重启都要人工点连接，既违背无人值守的初衷，也可能因遗忘触发监控告警、镜像同步失败。把“开机自启 + 静默回连”写进 systemd，节点状态就能随系统生命周期同生共灭，彻底把“人”从流程里摘掉。

经验性观察：在中小团队（<50 台）的 CI 流水线中，将 kuailian 封装成 systemd 服务后，因网络未就绪导致的构建失败从“每天零星几例”降到“一周难见一次”。代价是你必须接受 systemd 的日志、权限与升级策略，这也是下文的重点。

前置边界：官方接口与可脚本化程度

截至当前最新版本，快连 kuailian Linux 客户端并未开放正式 CLI，但安装目录会释放一个 kuailian-daemon 二进制，支持 --connect-by-id 与 --disconnect 参数。本文所有脚本均依赖该可执行文件；若后续版本移除参数，方案将直接失效，升级前务必在测试机验证。

另一处隐形门槛：节点列表缓存在 ~/.config/kuailian/servers.json，权限 600。systemd 以 root 运行时，必须显式指定 HOME= 环境变量，否则守护进程会重新生成空白配置，导致“上次节点”记忆丢失。

方案 A：systemd 用户级服务（推荐桌面/开发机）

1. 创建用户单元

# 文件位置：~/.config/systemd/user/kuailian-autoconnect.service
[Unit]
Description=Kuailian Auto Connect
After=graphical-session.target network-online.target
Wants=network-online.target

[Service]
Type=simple
# 假设 kuailian 安装在 /opt/kuailian
ExecStart=/opt/kuailian/kuailian-daemon --connect-by-id last
Restart=on-failure
RestartSec=10
# 关键：让 daemon 找到用户级配置
Environment="HOME=%h"

[Install]
WantedBy=default.target

保存后执行 systemctl --user daemon-reload && systemctl --user enable --now kuailian-autoconnect。该单元只在当前用户登录会话启动，不会把 root 拖下水；升级客户端时也无须改动系统级单元。

2. 验收标准

systemctl --user status kuailian-autoconnect 显示 active (running)
ip route | grep tun 出现默认路由指向 tun0
断开 Wi-Fi 再恢复，10 秒内路由自动恢复，无需人工干预

若验收失败，优先检查 servers.json 是否为空；若是，说明 HOME 变量未生效，可临时在 ExecStart 前加 bash -c 'sleep 5 && /opt/kuailian/kuailian-daemon ...' 做延迟重试。

方案 B：systemd 系统级服务（推荐服务器/软路由）

1. 创建系统单元

# 文件位置：/etc/systemd/system/kuailian-sys.service
[Unit]
Description=Kuailian System-level Auto Connect
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=kuailian-sys
# 单独建低权用户，避免 root 直接跑
ExecStart=/opt/kuailian/kuailian-daemon --connect-by-id last
Restart=on-failure
RestartSec=15
# 关键：把配置目录硬链接到该用户家目录
Environment="HOME=/var/lib/kuailian"
# 确保 tun 设备可读写
DeviceAllow=/dev/net/tun rw

[Install]
WantedBy=multi-user.target

创建专用用户 useradd -r -s /bin/false -d /var/lib/kuailian kuailian-sys，再把原先 root 用过的 servers.json 复制过去并 chown。这样即使客户端被入侵，攻击者也拿不到 root。

2. 日志与监控

系统级服务默认走 journald。可写一段简单脚本供 prometheus-node-exporter 采集：

# /usr/local/bin/kuailian_up.sh
#!/bin/bash
ip link show tun0 &>/dev/null && echo "kuailian_up 1" > /var/lib/node_exporter/kuailian.prom || echo "kuailian_up 0" > /var/lib/node_exporter/kuailian.prom

配合 cron 每 30 秒执行一次，即可在 Grafana 看到“通道在线”指标，方便在重启后确认是否成功静默回连。

节点记忆机制：last 到底指哪一条

快连 kuailian 把“最后一次成功握手”的节点 ID 写入 ~/.config/kuailian/last_connected（纯文本，仅一行）。当你调用 --connect-by-id last 时，daemon 读取该文件；若文件不存在，则随机选低延迟节点，行为等效于“快速连接”按钮。

经验性观察：若你在桌面端手动切换过节点，再回 Linux 开机，系统会沿用桌面最后一次成功节点。这在跨国团队里很香——美国同事白天切到 US 节点，北京服务器晚上重启，会自动连 US，避免再次握手亚欧美三洲。若不想“串记忆”，可把 last_connected 设为只读（chmod 444），daemon 会回退到随机选择，保证 Linux 始终就近接入。

回退与应急：如何快速关掉自启

升级内核或调试网络栈时，隧道常造成路由冲突。建议留一条“逃生通道”：

给 grub 加一条 kuailian.disable=1 自定义参数，在 initrd 阶段由脚本识别，若存在则 systemctl mask kuailian-sys.service
或者建一个 udev 规则：插入特定 USB 设备（如含“ESCAPE”标签）即 systemctl stop kuailian-sys，适合远程托管机房

验证：重启后插拔 USB，可见 journal 里出现“kuailian stopped by udev escape rule”，确认回退链路生效。

常见故障排查表

现象	最可能原因	验证命令	处置
systemd 反复重启	last_connected 文件指向已下架节点	cat ~/.config/kuailian/last_connected	删除该文件，daemon 会随机选新节点
tun0 未创建	缺少 /dev/net/tun 或权限不足	ls -l /dev/net/tun	chmod 600 + 属主改为 kuailian-sys
桌面登录后冲突	用户级与系统级同时启动	ip route show table all \| grep tun	停用其中一边，或给系统级单元加 `Conflicts=kuailian-autoconnect.service`

适用/不适用场景清单

适用：软路由、NAS、CI runner、远程数据采集节点、需要长期保活的反向代理。

不适用：多人共享的图形工作站（节点记忆会被别人带跑）、需要频繁切换出口 IP 的爬虫、合规要求“每次连接需人工审批”的政企内网。

最佳实践 6 条（检查表）

升级前先在测试机 systemctl stop，确认新版本仍支持 --connect-by-id
为系统级单元单独建低权用户，禁止 root 直跑
把 /var/lib/kuailian 做定期快照，方便回滚节点记忆
用 RestartSec≥10 避免网络抖动时疯狂重连被服务器 Ban IP
在 Ansible/SaltStack 里加一条“检查 tun0 存在”的 assert，防止批量重启后全军覆没
每月手动触发一次重启，验证逃生通道是否被内核更新破坏

FAQ（结构化数据）

快连 kuailian 的 last 文件丢失会怎样？

daemon 会回退到“快速连接”逻辑，随机挑选低延迟节点，不会导致服务崩溃。

可以用 crontab @reboot 代替 systemd 吗？

可以，但 crontab 缺少 Restart=on-failure 与依赖排序，网络未就绪时容易失败，且日志分散，不推荐。

节点记忆会跨平台同步吗？

不会。last_connected 只存在于本地文件，官方未提供云端同步。

如何确认 daemon 已真正连通而非仅 tun0 存在？

在 unit 里加一行 ExecStartPost=/bin/bash -c 'sleep 5 && curl -m 3 https://checkip.amazonaws.com'，看返回 IP 是否为目标出口。

收尾：下一步行动清单

读完本文，你可以：

在测试机按“方案 A”跑通用户级自启，验收 tun0 与路由
把 last_connected 机制验证一遍，确认节点记忆符合预期
若需上架生产，再按“方案 B”重做成系统级+低权用户+监控
留好 udev 或 grub 逃生通道，避免远程断网
订阅快连官方更新日志，一旦移除 --connect-by-id 参数，立即回退到手动方案

至此，快连 kuailian 在 Linux 下的“开机自启+静默连接上次节点”已具备无人值守、可监控、可回退能力，把“人”从重启后的第一公里彻底解放。未来若官方推出正式 CLI 或 REST API，可再评估迁移至更原生的集成方式。

快连kuailian在Linux下如何设置开机自启并静默连接上次节点？