使用指南
下载安装
从官方下载站获取最新版本客户端:
bash
# 一键下载并安装(以 AMD64 为例)
wget https://download.liumou.site/ssh-go-automatic-upgrade/v2.10.9/ssh-go-automatic-upgrade_v2.10.9-linux-amd64.tar.gz
tar -xzf ssh-go-automatic-upgrade_v2.10.9-linux-amd64.tar.gz
sudo chmod +x ssh-go-automatic-upgrade_*
sudo mv ssh-go-automatic-upgrade_* /usr/local/bin/ssh-go-automatic-upgradeTIP
版本号 v2.10.9 请替换为实际最新版本,访问 https://download.liumou.site/ssh-go-automatic-upgrade 查看所有可用版本。
命令行参数
字符串参数
| 参数 | 默认值 | 描述 |
|---|---|---|
-i | /usr/local/openssh | OpenSSH 安装目录 |
-d | /tmp/ssh-go-automatic-upgrade | 下载目录 |
-l | /var/log/ssh-go-automatic-upgrade | 日志目录 |
-data-dir | /var/lib/ssh-go-automatic-upgrade | 数据目录(状态文件存储) |
-t | 00:00:00-08:00:00 | 升级时间段,格式 HH:MM:SS-HH:MM:SS,支持跨午夜 |
-rl | auto | Root 登录配置:auto(智能检测), yes(启用), no(禁用) |
-kl | auto | 仅密钥登录配置:auto(智能检测), yes(启用), no(禁用) |
-server-url | https://demo.ssh.liumou.site | 服务端地址 |
-api-key | 空 | API Key,服务端要求认证时提供 |
-sw | 空 | SSH IP 白名单,支持 CIDR 和具体 IP,逗号分隔 |
整数参数
| 参数 | 默认值 | 描述 |
|---|---|---|
-interval | 1 | 检测间隔(小时),范围 1-48 |
-report-interval | 5 | 状态上报间隔(分钟) |
-guardian-interval | 180 | SSH 守护检测间隔(秒) |
布尔参数
| 参数 | 默认值 | 描述 |
|---|---|---|
-f | false | 强制升级,即使版本相同也执行安装 |
-su | false | 注册或更新 systemd 服务 |
-uninstall | false | 卸载 systemd 服务 |
-stv | false | 跳过 HTTPS 证书检测(内网环境) |
-v | false | 显示版本号 |
-report | false | 启用客户端状态上报 |
-use-original-config | true | 保留原始 sshd_config 配置文件 |
-experimental | false | 启用灰度升级模式。标记设备为灰度节点,优先获取最新版本验证,验证通过后晋升为稳定版推全(需专业版及以上。至尊版支持远程开关) |
-self-upgrade | false | 启用客户端自身自动升级 |
-auto-restart | true | 版本不一致时自动重启 SSH 服务 |
基本使用
bash
# 自动检测配置并升级
sudo ssh-go-automatic-upgrade
# 跳过 HTTPS 证书检测(内网环境)
sudo ssh-go-automatic-upgrade -stv
# 强制升级
sudo ssh-go-automatic-upgrade -f连接管理平台
bash
# 启用状态上报(使用默认服务端)
sudo ssh-go-automatic-upgrade -report
# 自定义服务端地址并启用上报
sudo ssh-go-automatic-upgrade -server-url https://your-server.com -report
# 完整示例
sudo ssh-go-automatic-upgrade \
-server-url https://your-server.com \
-report \
-report-interval 5服务管理
bash
# 注册或更新为系统服务
sudo ssh-go-automatic-upgrade -su
# 注册服务并启用上报
sudo ssh-go-automatic-upgrade -su -report -server-url https://your-server.com
# 注册服务但禁用自动重启
sudo ssh-go-automatic-upgrade -su -auto-restart=false
# 注册服务并启用客户端自升级
sudo ssh-go-automatic-upgrade -su -self-upgrade
# 卸载服务
sudo ssh-go-automatic-upgrade -uninstall日志查看
bash
# 查看程序日志
sudo tail -f /var/log/ssh-go-automatic-upgrade/*.log
# 查看 systemd 服务日志
sudo journalctl -u ssh-go-automatic-upgrade -f