一、问题背景
在基于 FRP 的远程连接或内网穿透架构中，客户端通常以 systemd 服务方式长期运行，以确保设备重启后能够自动恢复连接。
在实际部署过程中，经常出现以下现象：
- 系统重启后客户端未自动上线
- 服务状态显示 failed
- 手动 restart 后恢复正常
- 运行一段时间后偶发退出
这些问题多数并非 FRP 本身造成，而是 systemd 启动顺序与网络就绪状态之间的不匹配。
二、常见错误配置
部分配置中会出现类似写法：
Restart=unless-stopped
该参数来源于容器编排系统，并 不属于 systemd 支持的语法。
结果是：
- systemd 忽略重启策略
- 服务退出后不会自动恢复
- 启动日志出现解析警告
因此必须使用 systemd 原生参数。
三、核心稳定原则
长期运行类网络服务需要满足三个条件：
- 网络完全初始化后再启动
- 服务异常退出可自动恢复
- 启动路径环境固定且可预测
systemd 中对应的关键机制为：
network-online.target
它表示：
- 网络接口已激活
- IP 地址已获取
- 默认路由已建立
- DNS 可正常工作
四、推荐的标准 systemd 服务模板（脱敏）
以下为经过泛化处理后的通用配置示例：
[Unit]
Description=generic-client-service
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=root
WorkingDirectory=/path/to/application
ExecStart=/path/to/application/client-binary -c /path/to/application/config-file
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
说明：
| 项目 | 含义 |
|---|---|
| Description | 服务描述（任意名称） |
| WorkingDirectory | 程序工作目录 |
| ExecStart | 客户端启动命令 |
| Restart=always | 退出后自动重启 |
| RestartSec | 重启等待时间 |
| network-online.target | 等待网络就绪 |
五、为什么必须等待 network-online
典型系统启动流程如下：
系统启动
↓
network.target 达成
↓
服务启动
↓
DHCP / DNS 尚未完成
↓
客户端连接失败
此时服务会直接退出。
加入：
After=network-online.target
后流程变为：
系统启动
↓
网络完全可用
↓
客户端启动
↓
连接成功
显著提升重启成功率。
六、自动恢复机制的重要性
网络客户端通常依赖：
- 外部服务器
- DNS
- 路由状态
- 临时网络抖动
因此推荐使用：
Restart=always
实现：
- 网络波动自动恢复
- 远端重启自动重连
- 长期无人值守运行
七、应用配置生效流程
修改服务文件后执行：
systemctl daemon-reload
systemctl enable service-name
systemctl restart service-name
验证状态：
systemctl status service-name
八、适用场景
该配置模式适用于：
- FRP 客户端
- VPN 客户端
- 反向隧道程序
- 长连接代理服务
- 边缘节点设备
包括但不限于：
- 单板计算机
- 低功耗网关设备
- 家庭服务器节点
- 远程接入终端
九、结论
稳定运行的关键不在应用本身，而在于：
- 正确的 systemd 启动依赖
- 合理的自动重启策略
- 明确的网络就绪判定
通过标准化服务模板，可以显著降低远程节点在重启或网络波动后的失联概率，实现长期稳定运行。