
ネットワーク認識型SSHルーター - アクティブなVPNやネットワークに基づいて、異なるIP/ポート/キー/踏み台ホストへ接続をルーティングします
| CI | コード | OpenSpec | セキュリティ |
|---|---|---|---|
|
|
|
|
|
ネットワークを認識する SSH ルーター。現在接続しているネットワークや VPN を検出し、各 SSH 接続に適切なホスト、ポート、ID ファイル、ジャンプホストを自動的に選択します — ~/.ssh/config には一切触れません。
各論理ホストを default プロファイルと、必要に応じてネットワークごとのオーバーライドで一度だけ定義します。接続のたびに、sshroute は現在どのネットワーク上にいるか(VPN、オフィス LAN、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
あなたのラボにはおそらく少なくとも2つの現実があります。自宅の LAN 上に座っているか、外出先から WireGuard などの VPN 経由で入ってくるかです。問題は ~/.ssh/config がどちらにいるのかを知らないことです。その結果、別々のエイリアス(server-lan、server-vpn)を持つか、半分の時間しか動かないジャンプホストを使うか、単に IP を暗記するかのどれかになります。
sshroute は、接続のたびに現在のネットワークを検出することでこれを解決します。WireGuard インターフェースが起動していてピアルートが存在する場合、トンネル IP に直接接続します。LAN 上にいる場合はローカルアドレスを使用します。どちらにも到達できない場合は、パブリックホスト名にフォールバックします。1つのエイリアス、3つの現実、手動切り替えはゼロです。
また、SSH を透過的にインターセプトします。シャドウモードを設定すれば、git push、rsync、scp はすべて自動的にそれを経由します。ラッパーもシェル関数も、何も考える必要もありません。
エンタープライズネットワークはさらに厄介です。パブリックインターネット、場合によってはサイト間 VPN、場合によっては個人用 VPN のスプリットトンネルがあり、その内部にはターゲットとする環境に応じて異なるジャンプホストがあります。dev、staging、prod それぞれに独自の bastion とキーがあります。これを ~/.ssh/config で整理しようとすると、インフラが変わるたびに壊れる巨大な設定か、チームの誰もが異なる方法でメンテナンスするスクリプトのどちらかになります。
sshroute では、ルーティングロジックを宣言的に定義し、バージョン管理された YAML ファイルに保持し、チーム全体で共有できます。同じ設定が全員に対して機能します。各マシンでどのインターフェースやルートがアクティブかに基づいて、適切なネットワークが自動的に検出されます。キー、ポート、ユーザー、ジャンプホストは、ユーザーが意識することなく解決されます。
| 機能 | ~/.ssh/config | WireGuard のみ | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| 現在のネットワークを検出 | ❌ | ❌ | ❌ | ✅ |
| 最適なパスを自動選択 | ❌ | ❌ | ❌ | ✅ |
| 接続失敗時にフォールバック | ❌ | ❌ | ✅ | ✅ |
| 切断時の自動再接続 + 再ルーティング | ❌ | ⚠️ トンネルローミング | ⚠️ 固定プロキシ経由 | ✅ |
| ホストごとに1コマンド、どの場所からでも | ❌ | ⚠️ 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バイナリを公開していないため、Termuxが提供するものを使うにはGOTOOLCHAIN=localを設定します:
GOTOOLCHAIN=local go install github.com/thereisnotime/sshroute@latest
インストール後、Termuxには/usr/bin/sshが存在しないため、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
$PATH のより前の位置に sshroute を ssh としてインストールします。ターミナル、git、rsync、scp からのすべての SSH 呼び出しは自動的にインターセプトされます。設定に含まれていないホストは、そのまま /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