SSH Reverse Tunnel Manager · Light

一个面向 Windows 和 macOS 的轻量 SSH 反向代理管理器。新版采用清晰的卡片式工作区， 用于集中管理多台 Linux 服务器的反向端口转发、自动重连和网络检测。

当前版本：v0.3.0

English

新版界面

• 卡片列表替代密集表格，连接状态、隧道路由和检测结果一眼可见
• 右侧详情面板集中展示服务器、认证方式、跳板机和最近状态
• 新增/编辑表单按服务器、隧道路由、认证和远程代理分组
• 提供服务器搜索、状态筛选、批量启动和批量停止
• 适配 Windows 高 DPI、macOS 原生字体与窗口缩放
• 使用系统蓝作为主色，绿色、橙色、红色只表达状态语义

功能

• 管理多台 SSH 服务器
• 支持 SSH Config / Agent、密码和 OpenSSH 私钥认证
• 支持 ProxyJump / -J 跳板机
• 单独或批量启动、停止反向隧道
• SSH 断线后自动重连
• 独立显示隧道状态和远程联网检测结果
• 可选自动维护远程 ~/.bashrc 代理变量，并在修改前创建备份
• Windows 密码使用 DPAPI 加密；macOS 密码保存在登录钥匙串
• 关闭主窗口后继续在 Windows 系统托盘或 macOS 菜单栏运行
• 单实例保护，防止多个进程抢占同一远程监听端口

默认转发路径：

远程服务器 127.0.0.1:<远程端口>
    → SSH RemoteForward
本地电脑 <本地代理地址>:<本地代理端口>

系统要求

• Windows 10 / 11，或 macOS 11 Big Sur 及更高版本
• Windows OpenSSH Client（ssh.exe），或 macOS 系统 /usr/bin/ssh
• 本地代理服务，例如 127.0.0.1:7897
• 远程 SSH 服务允许 TCP 转发

下载

前往 Releases 下载最新的 Windows EXE；macOS 用户也可以按下文从源码构建 APP / DMG。

Windows 密码认证需要使用打包后的 EXE。macOS 源码版和 .app 均支持密码认证。

从源码运行

python -m pip install -r requirements.txt
python app.py

仅预览界面，不读写真实配置或启动系统托盘：

python app.py --preview

配置

新版配置保存在：

Windows: %APPDATA%\SshReverseTunnelManagerLight\servers.json
macOS:   ~/Library/Application Support/SshReverseTunnelManagerLight/servers.json

首次启动时，如果新版配置不存在，应用会只读导入旧路径中的服务器列表。之后的 修改只写入新版目录。

测试

python -m unittest discover -s tests -v

构建 EXE

python -m pip install -r requirements-build.txt
powershell -ExecutionPolicy Bypass -File .\build.ps1

构建结果：

dist\SshTunnelManagerLight.exe

构建 macOS APP / DMG

macOS 产物必须在 Mac 上构建：

python3 -m pip install -r requirements-macos.txt
bash packaging/macos/build_macos.sh

脚本会运行测试并生成 .app、ZIP 和 DMG。签名、universal2 构建及 Windows 配置 迁移说明见 README_MACOS.md。

安全说明

• 远程转发始终绑定到远程回环地址 127.0.0.1
• 不要提交 servers.json、私钥、密码、真实服务器地址或用户名
• 首次连接的主机指纹应先在终端中确认
• 自动远程代理配置只维护带有专用标记的区块，并在修改前备份 .bashrc

详见 SECURITY.md。

许可证

MIT