用途:作为轻量 SSH 操作网关,处理登录远程服务器、执行远程命令、检查服务器状态、上传下载部署文件、跳板机(ProxyJump)内网访问、隧道与端口转发、以及 ~/.ssh/config 的别名新增与查找。不用于本机 localhost、本地文件操作或网络概念解释。
主要能力:不维护独立服务器数据库,只读写标准 OpenSSH 配置 ~/.ssh/config,以 Host 别名标识服务器,优先密钥认证和 OpenSSH 原生命令。脚本包括 ssh_config.py(list/find/resolve/show/add)、ssh_exec.py、ssh_transfer.py、ssh_tunnel.py、ssh_probe.py。ssh_exec/transfer/tunnel 支持 --accept-new-host-key 与 --known-hosts-file;exec 返回含 success、exit_code、stdout、stderr 的 JSON;resolve 仅在结果唯一时继续,退出码 2 表示多候选需用户确认;add 写入前自动备份配置。
使用方式:常用命令如 python scripts/ssh_config.py list、find <关键词>、resolve <关键词...>、show <别名>;python scripts/ssh_exec.py <别名> "命令" --timeout 30;ssh_transfer.py upload/download;ssh_tunnel.py <别名> --local-port <本地端口> --remote-host 127.0.0.1 --remote-port <远程端口>。配置支持 description/aliases/groups/tags/location 注释元数据与 ProxyJump 跳板机。
限制:配置中禁止写入真实密码、Token、私钥等敏感信息。新增修改前须备份;删除配置、覆盖远程文件、部署、批量执行、端口转发等风险操作须先确认。不直接运行裸 ssh/scp,脚本不可用或用户明确要求时才回退。探测入口禁用 ProxyCommand,且配置含 Match exec 时可能执行本地命令,仅对可信配置使用。隧道前台运行,后台长期保持需先说明影响与停止方式。部分细节(如具体超时/权限默认值)资料未提供。