Skip to content

使用指南

命令行参数

字符串参数

参数默认值描述
-mhttps://mirrors.aliyun.com/openssh/portable/OpenSSH 镜像源 URL
-i/usr/local/opensshOpenSSH 安装目录
-d/tmp/ssh-go-automatic-upgrade下载目录
-l/var/log/ssh-go-automatic-upgrade日志目录
-data-dir/var/lib/ssh-go-automatic-upgrade数据目录(状态文件存储)
-t00:00:00-08:00:00升级时间段,格式 HH:MM:SS-HH:MM:SS,支持跨午夜
-rlautoRoot 登录配置:auto(智能检测), yes(启用), no(禁用)
-klauto仅密钥登录配置:auto(智能检测), yes(启用), no(禁用)
-server-urlhttps://demo.ssh.liumou.site服务端地址
-api-keyAPI Key,服务端要求认证时提供
-swSSH IP 白名单,支持 CIDR 和具体 IP,逗号分隔

整数参数

参数默认值描述
-interval1检测间隔(小时),范围 1-48
-report-interval5状态上报间隔(分钟)
-guardian-interval180SSH 守护检测间隔(秒)

布尔参数

参数默认值描述
-ffalse强制升级,即使版本相同也执行安装
-sufalse注册或更新 systemd 服务
-uninstallfalse卸载 systemd 服务
-stvfalse跳过 HTTPS 证书检测(内网环境)
-vfalse显示版本号
-reportfalse启用客户端状态上报
-use-apifalse启用 API 服务端获取最新版本
-use-original-configtrue保留原始 sshd_config 配置文件
-experimentalfalse启用实验性特性,提前获取镜像最新版本
-self-upgradefalse启用客户端自身自动升级
-auto-restarttrue版本不一致时自动重启 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

基于 MIT 许可证发布