leefer
199b46b593
根因:非 Windows 走 keyring 加密,无桌面环境的服务器上 keyring 后端不可用, 保存时抛异常/挂起 → 第2步不出现且配置未落盘。 - storage: 非 Windows 改为明文保存 + 文件权限 600(与 ~/.ssh 私钥同级),不再依赖 keyring - cli: 顶层异常兜底(打印堆栈,不再无声退出);向导显示配置文件路径 - 兼容读取旧 kr: 前缀配置;install.sh 去掉 keyring 依赖
SSH 隧道管理器
跨平台 SSH 本地端口转发工具:Windows 图形界面,Linux/macOS 命令行。
一键安装
Windows(图形界面,自动装好依赖、建快捷方式并启动):
powershell -c "irm https://gitea.xbay.cc/leefer/ssh-e2e/raw/branch/main/install.ps1 | iex"
Linux / macOS(命令行版,安装到 ~/ssh-e2e,提供 ssh-tunnel 命令):
curl -fsSL https://gitea.xbay.cc/leefer/ssh-e2e/raw/branch/main/install.sh | bash
安装完成会自动进入中文配置向导:按提示输入 SSH 地址、密码、远程端口等 (直接回车采用方括号里的默认值),填完隧道立即建立,Ctrl+C 断开。
典型场景
远程主机上有个服务只监听它自己的 127.0.0.1:3000,公网访问不到。
建一条隧道后,在本机打开 http://127.0.0.1:3000 即可直接访问该服务。
命令行用法(Linux/macOS,Windows 亦可 python cli.py)
ssh-tunnel # 交互向导:选已有主机/隧道或新建,建好直接运行
ssh-tunnel start web # 直接启动某条已配置的隧道(前台,Ctrl+C 断开)
ssh-tunnel list # 查看全部
ssh-tunnel test 我的服务器 # 测试主机认证
ssh-tunnel remove tunnel web
ssh-tunnel --help # 完整参数(host add / tunnel add 等)
图形界面(Windows)
双击仓库里的 启动.bat,或用上面的一键安装命令。
- 主机:添加 SSH 主机(密码/私钥认证,可「测试连接」)。
- 隧道:选主机,填远程地址(一般
127.0.0.1)、远程端口、本地端口,点「启动」。 - 本机访问
127.0.0.1:本地端口即等于远程服务;点「最小化/关闭」驻留系统托盘,隧道后台保持。
数据与安全
配置文件位置:Windows %APPDATA%\SshTunnelManager\、Linux ~/ssh-e2e/.config/、
macOS ~/ssh-e2e/Library/。密码与私钥口令:Windows 经 DPAPI 加密(绑定系统用户);
Linux/macOS 以明文保存,但文件权限已收紧为仅本用户可读(600),与 ~/.ssh/ 私钥同级。
主机公钥记录在配置目录 known_hosts,主机密钥变更时拒绝连接。
开发
main.py GUI 入口(pywebview + WebView2,仅 Windows)
cli.py 命令行入口(跨平台)
engine.py 隧道引擎:paramiko 转发、保活、自动重连
storage.py 配置存储:JSON + 平台加密
ui/ 图形界面(HTML/CSS/JS)
install.sh / install.ps1 一键安装脚本
test_sshd.py / test_e2e.py 本地自测(见下)
自测:
.venv/Scripts/python test_sshd.py # 窗口1:本地测试 SSH 服务端
.venv/Scripts/python test_e2e.py # 窗口2:端到端隧道验证
.venv/Scripts/python cli.py list # CLI 冒烟