Appearance
使用指南
命令行参数
字符串参数
| 参数 | 默认值 | 描述 |
|---|---|---|
-m | https://mirrors.aliyun.com/openssh/portable/ | OpenSSH 镜像源 URL |
-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-api | false | 启用 API 服务端获取最新版本 |
-use-original-config | true | 保留原始 sshd_config 配置文件 |
-experimental | false | 启用实验性特性,提前获取镜像最新版本 |
-self-upgrade | false | 启用客户端自身自动升级 |
-auto-restart | true | 版本不一致时自动重启 SSH 服务 |
基本使用
bash
# 自动检测配置并升级
sudo ssh-go-automatic-upgrade
# 使用自定义镜像源
sudo ssh-go-automatic-upgrade -m https://mirrors.tuna.tsinghua.edu.cn/openssh/portable/
# 跳过 HTTPS 证书检测(内网环境)
sudo ssh-go-automatic-upgrade -m https://internal-mirror.company.com/ -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 \
-m https://mirrors.aliyun.com/openssh/portable/服务管理
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