
네트워크 인식 SSH 라우터 - 활성 VPN 또는 네트워크에 따라 다른 IP/포트/키/점프 호스트로 연결을 라우팅합니다.
| CI | 코드 | OpenSpec | 보안 |
|---|---|---|---|
|
|
|
|
|
네트워크 인식 SSH 라우터. 현재 활성화된 네트워크 또는 VPN을 감지하고, ~/.ssh/config를 건드리지 않고도 각 SSH 연결에 맞는 올바른 호스트, 포트, 아이덴티티 파일, 점프 호스트를 자동으로 선택합니다.
각 논리적 호스트를 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
여러분의 랩에는 아마 최소 두 가지 현실이 있을 것입니다. 집에서 LAN에 연결되어 있거나, 외부에서 WireGuard 또는 다른 VPN을 통해 접속하는 경우입니다. 문제는 ~/.ssh/config가 여러분이 어느 쪽에 있는지 알지 못한다는 것입니다. 그래서 별도의 별칭(server-lan, server-vpn)을 만들거나, 절반의 경우에만 작동하는 점프 호스트를 두거나, 그냥 IP를 외우게 됩니다.
sshroute는 모든 연결 전에 현재 네트워크를 감지하여 이 문제를 해결합니다. WireGuard 인터페이스가 활성화되어 있고 피어 라우트가 존재하면 터널 IP로 직접 연결합니다. LAN에 있을 때는 로컬 주소를 사용합니다. 둘 다 도달할 수 없을 때는 공용 호스트 이름으로 폴백합니다. 하나의 별칭, 세 가지 현실, 수동 전환 제로.
또한 SSH를 투명하게 가로챕니다. 섀도 모드를 설정하면 git push, rsync, scp 모두 자동으로 이를 통과합니다. 래퍼도, 셸 함수도, 고민도 필요 없습니다.
엔터프라이즈 네트워크는 더 심합니다. 공용 인터넷, 어쩌면 사이트 간 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
~/.bashrc 또는 ~/.profile에서 ~/.local/bin을 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
# See what network is currently active
sshroute network
이 플래그들은 모든 명령에 적용됩니다: