| CI | 代码 | OpenSpec | 安全 |
|---|---|---|---|
|
|
|
|
|
网络感知型 SSH 路由器。检测你当前所在的网络或 VPN,并为每个 SSH 连接自动选择正确的主机、端口、身份文件和跳板主机——无需改动 ~/.ssh/config。
为每个逻辑主机定义一次 default 配置文件,并可选地为每个网络设置覆盖项。在每次连接时,sshroute 会检测你当前所在的网络(VPN、办公局域网、WireGuard 对等节点等),并在交给真正的 /usr/bin/ssh 之前解析出正确的 SSH 参数。
ssh myserver
→ sshroute detects: corp-vpn is active
→ resolves: 10.100.0.50:2222 via bastion.corp.internal
→ exec /usr/bin/ssh -p 2222 -i ~/.ssh/corp_key -J bastion.corp.internal 10.100.0.50
你的实验室可能至少存在两种现实:你要么坐在家里的局域网上,要么身在外地并通过 WireGuard 或其他 VPN 接入。问题在于 ~/.ssh/config 并不知道你处于哪种情况——于是你最终要么使用单独的别名(server-lan、server-vpn),要么使用一个只有一半时间能用的跳板机,要么干脆记住 IP 地址。
sshroute 通过在每次连接前检测你当前的网络来解决这个问题。当 WireGuard 接口已启用且对等路由存在时,它会直接连接到隧道 IP。当你在局域网上时,它会使用本地地址。当两者都不可达时,它会回退到公共主机名。一个别名,三种现实,零手动切换。
它还会透明地拦截 SSH——一旦你设置好影子模式,git push、rsync、scp 都会自动经过它。无需包装器,无需 shell 函数,无需思考。
企业网络更糟。你有公共互联网,也许有站点到站点 VPN,也许有个人 VPN 的分流隧道,而在其内部,根据你目标的环境不同,你还有不同的跳板机——dev、staging、prod,每个都有自己的堡垒机和密钥。要在 ~/.ssh/config 中理清这些,意味着要么是一个庞大的配置,一旦基础设施发生变化就会失效,要么是你写一个脚本,而团队中每个人维护它的方式都各不相同。
sshroute 让你以声明式的方式定义路由逻辑,将其保存在一个受版本控制的 YAML 文件中,并在团队中共享。同一份配置对所有人都适用——正确的网络会根据每台机器上活跃的接口或路由自动检测。密钥、端口、用户和跳板机都会自动解析,用户无需操心。
| 功能 | ~/.ssh/config | 仅 WireGuard | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| 检测你当前的网络 | ❌ | ❌ | ❌ | ✅ |
| 自动选择最佳路径 | ❌ | ❌ | ❌ | ✅ |
| 连接失败时回退 | ❌ | ❌ | ✅ | ✅ |
| 断开后自动重连 + 重新路由 | ❌ | ⚠️ 隧道漫游 | ⚠️ 通过固定代理 | ✅ |
| 每个主机一条命令,任意位置 | ❌ | ⚠️ VPN 必须已启用 | ✅ | ✅ |
| 10 台主机 × 4 条路径的配置大小 | 📄 约 600 行 | 📄 约 600 行 + VPN 配置 | 📄 服务端配置 | 📄 约 60 行 |
| 移动设备漫游 | ⚠️ 手动别名 | ⚠️ 需要 VPN | ✅ | ✅ |
| 跳板机自动链式连接 | ⚠️ 手动 -J | ➖ 不适用 | ✅ | ✅ |
| 与 scp / rsync / git / Ansible 配合使用 | ✅ | ✅ | ⚠️ 部分支持 | ✅ |
| 目标端无需服务端安装 | ✅ | ❌ | ❌ | ✅ |
| 无需运行认证服务器或守护进程 | ✅ | ❌ | ❌ | ✅ |
| 无客户端代理 | ✅ | ❌ | ❌ | ✅ |
| 开源,完全自托管 | ✅ | ✅ | ⚠️ 开放核心 | ✅ |
Teleport 和 Boundary 属于不同的类别——它们在路由之上增加了访问控制、审计日志和基于证书的认证。如果这正是你需要的,就使用它们。sshroute 适用于你想要路由智能,但又不想承担运行中央认证服务器的运维开销的场景。
从 GitHub Releases 下载最新版本。二进制文件适用于 Linux、macOS 和 Android 上的 AMD64 和 ARM64 架构。
go install github.com/thereisnotime/sshroute@latest
从 GitHub Releases 下载 android_arm64 tarball,解压后将二进制文件放入 ~/.local/bin:
mkdir -p ~/.local/bin
curl -Lo "$TMPDIR/sshroute.tar.gz" \
https://github.com/thereisnotime/sshroute/releases/latest/download/sshroute_android_arm64.tar.gz
tar -xzf "$TMPDIR/sshroute.tar.gz" -C ~/.local/bin sshroute
chmod +x ~/.local/bin/sshroute
如果尚未添加,请将 ~/.local/bin 添加到 ~/.bashrc 或 ~/.profile 中的 PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
或者,使用 Termux 的 Go 从源码编译。由于官方 Go 工具链不发布 android/arm64 二进制文件,请设置 GOTOOLCHAIN=local 以使用 Termux 提供的版本:
GOTOOLCHAIN=local go install github.com/thereisnotime/sshroute@latest
安装完成后,请设置 SSH 二进制文件路径,因为 Termux 没有 /usr/bin/ssh:
# ~/.config/sshroute/config.yaml
ssh_binary: /data/data/com.termux/files/usr/bin/ssh
或通过环境变量:export SSHROUTE_SSH=$(which ssh)
docker run --rm -v ~/.config/sshroute:/root/.config/sshroute \
ghcr.io/thereisnotime/sshroute network
podman run --rm -v ~/.config/sshroute:/root/.config/sshroute \
ghcr.io/thereisnotime/sshroute network
在启用了 SELinux 的系统(Fedora、RHEL 等)上,为卷标志添加 :Z:
podman run --rm -v ~/.config/sshroute:/root/.config/sshroute:Z \
ghcr.io/thereisnotime/sshroute network
将 sshroute 以 ssh 之名安装到 $PATH 中更靠前的位置。所有 SSH 调用——无论是来自你的终端、git、rsync 还是 scp——都会被自动拦截。不在你配置中的主机将原样透传给 /usr/bin/ssh。
mkdir -p ~/.local/bin
ln -s $(which sshroute) ~/.local/bin/ssh
# Add to ~/.bashrc or ~/.zshrc if not already present:
export PATH="$HOME/.local/bin:$PATH"
# Add a host with a default profile
sshroute add myserver --host myserver.example.com --user alice --key ~/.ssh/id_ed25519
# Add a VPN-specific override
sshroute add myserver --network vpn --host 10.8.0.50 --port 2222 --jump bastion.vpn
# Connect — network is detected automatically
sshroute connect myserver
# Preview the resolved command without running it
sshroute connect myserver --dry-run
# See what network is currently active
sshroute network
这些标志适用于所有命令:
| 标志 | 环境变量 | 默认值 | 描述 |
|---|---|---|---|
--config | SSHROUTE_CONFIG | ~/.config/sshroute/config.yaml | 配置文件路径 |
-o, --output | table | 输出格式:table、json、yaml | |
-v, --verbose | SSHROUTE_VERBOSE=1 | false | 将调试日志输出到 stderr |
--dry-run | false | 打印解析后的 SSH 命令而不执行 |
init创建一个带有注释示例的初始配置文件。如果文件已存在则失败。
| 标志 | 默认值 | 描述 |
|---|---|---|
--force | false | 覆盖已存在的配置文件 |
connect <alias>检测当前活动网络,为 alias 解析 SSH 参数,并执行真实的 SSH 二进制文件。别名之后的任何额外参数都会原样传递给 SSH。