Chevnia Blog

Appearance

autossh 部署检查清单 ​

这份清单适合在配置 autossh 时逐项核对，避免漏步骤。

1. 安装前检查 ​

  • [ ] 已安装 Homebrew
  • [ ] 已执行 brew install autossh
  • [ ] 已确认 which autossh 输出正确
  • [ ] 已确认本机 autossh 路径

常见路径：

  • Apple Silicon: /opt/homebrew/bin/autossh
  • Intel: /usr/local/bin/autossh

2. SSH 连通性检查 ​

  • [ ] 已确认可以执行 ssh your_user@100.x.x.x
  • [ ] 已确认远端 IP 为 100.x.x.x
  • [ ] 已确认远端用户名正确
  • [ ] 已确认远端 SSH 服务正常

推荐补充：

  • [ ] 已生成本机 SSH 密钥：ssh-keygen -t ed25519
  • [ ] 已配置免密登录
  • [ ] 已确认 SSH 登录时不再要求输入密码

3. 手动代理检查 ​

  • [ ] 已执行手动启动命令
bash
autossh -M 0 -f -N -D 1080 \
  -o "ServerAliveInterval 30" \
  -o "ServerAliveCountMax 3" \
  -o "ExitOnForwardFailure yes" \
  your_user@100.x.x.x
  • [ ] 已确认本机 1080 端口开始监听
bash
lsof -i :1080
  • [ ] 已确认错误日志无明显报错
bash
cat /tmp/autossh-socks1080.err
  • [ ] 已验证代理能正常工作
bash
curl --socks5 127.0.0.1:1080 https://ifconfig.me

4. LaunchAgent 配置检查 ​

  • [ ] 已创建目录 ~/Library/LaunchAgents
  • [ ] 已创建 ~/Library/LaunchAgents/com.autossh.socks1080.plist
  • [ ] 已把 your_user 改成真实远端用户名
  • [ ] 已确认 ProgramArguments 中的 autossh 路径正确
  • [ ] 已确认 StandardOutPath 和 StandardErrorPath 已配置
  • [ ] 已确认 RunAtLoad 为 true
  • [ ] 已确认 KeepAlive 为 true

可参考模板文件：

com.autossh.socks1080.example.plist

5. 服务加载检查 ​

  • [ ] 已执行新写法加载命令
bash
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.autossh.socks1080.plist
  • [ ] 已确认服务已加载
bash
launchctl list | grep autossh
  • [ ] 已确认 1080 端口仍在监听
bash
lsof -i :1080

6. 日常维护配置检查 ​

  • [ ] 已把快捷函数加入 ~/.zshrc
  • [ ] 已执行 source ~/.zshrc
  • [ ] 已测试以下命令可用
bash
autossh-start
autossh-stop
autossh-reload
autossh-status
autossh-log
autossh-log-follow

7. 故障排查准备 ​

  • [ ] 已知道如何查看状态：autossh-status
  • [ ] 已知道如何看日志：autossh-log
  • [ ] 已知道如何持续跟踪日志：autossh-log-follow
  • [ ] 已知道如何测试代理：curl --socks5 127.0.0.1:1080 https://ifconfig.me
  • [ ] 已知道出现问题时可前台测试一次，不加 -f

8. 最终通过标准 ​

下面这些都满足时，就可以认为配置基本完成：

  • [ ] launchctl list | grep autossh 能看到服务
  • [ ] lsof -i :1080 显示 localhost:socks (LISTEN)
  • [ ] /tmp/autossh-socks1080.err 没有明显报错
  • [ ] curl --socks5 127.0.0.1:1080 https://ifconfig.me 能返回 IP
  • [ ] 重启或重新登录后服务仍能自动拉起