A Fast, Reliable SSH Tunnel Manager
A desktop app that keeps SSH tunnels stable, organized, and easy to manage on macOS and Windows.
TunnelBoard is a cross-platform desktop app that lets you create, manage, and monitor SSH tunnels through a graphical interface. It wraps the power of SSH port forwarding into a user-friendly UI, with automatic reconnection to keep your tunnels alive even when the network is unstable.
Designed for developers and ops engineers who frequently work with remote servers, databases, and internal services behind firewalls — without touching the command line every time.
- 🖥️ Graphical tunnel management — create, edit, start, stop, and monitor all your SSH tunnels from a clean desktop UI; no command line needed day-to-day
- 🔄 Smart Automatic Reconnection — intelligent exponential backoff ensures tunnels recover seamlessly from network drops or SSH interruptions, with real-time status visibility in the UI
- ⚡ Real-time latency monitoring with fastest-route selection — continuously measure and display SSH latency across lines, sort by response time, and switch to the fastest route in one click
- 📥 Import tunnels from SSH command — paste any
sshcommand and all-L/-R/-Dport-forwarding flags are parsed at once, creating multiple tunnels in a single step - 📋 Duplicate tunnel for fast setup — clone an existing tunnel with one click to quickly create variants without re-entering all the fields
- ⛓️ Multi-hop jumper chains — configure multiple SSH jumper servers per tunnel for deeply nested networks (e.g. bastion → internal host)
- 🔀 Local, remote and dynamic (SOCKS5) port forwarding — all standard SSH tunnel modes supported
- ✅ Built-in connection test — verify a tunnel is reachable before saving, directly from the create/edit dialog
▶️ Auto-start tunnels on launch — mark tunnels to open automatically when the app starts- 🌍 Cross-platform — macOS and Windows supported
- 💬 Multi-language UI — English and 简体中文
Import tunnels from an SSH command:
Real-time SSH connection latency:
Download the latest release from the Releases page.
- macOS:
.dmginstaller - Windows:
.exeinstaller
When running the macOS version for the first time, you may encounter a system security block. Here are two methods to bypass it:
Method 1: System Settings
- When you see the security block popup, click "Cancel"
- Open "System Settings" -> "Privacy & Security"
- Scroll down to the Security section and click "Open Anyway"
Method 2: Terminal Command
Open Terminal and run the following command (you may need to enter your computer password):
sudo xattr -rd com.apple.quarantine /Applications/tunnelboard.appPrerequisites:
git clone https://github.com/HanZephyr/TunnelBoard.git
cd TunnelBoard
# Install frontend dependencies
cd frontend && pnpm install && cd ..
# Run in development mode
wails dev
# Build production binary
wails buildTunnelBoard currently stores its configuration in a TOML file under the operating system's per-user application data directory.
- Windows:
%AppData%\TunnelBoard\config.toml - macOS:
~/Library/Application Support/TunnelBoard/config.toml
If the target config file does not exist or is empty, TunnelBoard creates a default configuration on first run.
Example configuration:
[[jumpers]]
name = "my-server"
host = "example.com"
port = 22
user = "ubuntu"
auth_method = "agent" # or "key"
# identity = "~/.ssh/id_rsa"
[[tunnels]]
name = "local-db"
jumper = "my-server"
mode = "local" # local | remote | socks5
local_port = 5432
remote_host = "127.0.0.1"
remote_port = 5432| Mode | Description |
|---|---|
local |
Forward a local port to a remote address via the SSH server |
remote |
Forward a remote port on the SSH server to a local address |
socks5 |
Use the SSH server as a SOCKS5 proxy (dynamic forwarding) |
| Layer | Technology |
|---|---|
| Desktop framework | Wails v2 |
| Backend | Go |
| Frontend | Vue 3 + Vite |
| SSH | Go golang.org/x/crypto/ssh |
Use GitHub Issues for bug reports and feature requests.
Apache License 2.0.