SSH-Tunnel 安装指南

首次安装

一键安装脚本会识别 Windows、macOS、Linux 的平台与架构，下载对应的服务版二进制，并在安装过程中交互采集首装所需的最小配置。

curl -fsSL https://idefav.github.io/ssh-tunnel/install | sh

irm https://idefav.github.io/ssh-tunnel/install | iex

安装器行为

• 首次安装时会采集 server.ip、server.ssh.port、login.username、ssh.private_key_path。
• 会自动扫描当前用户 .ssh 目录中的本地 SSH 私钥和公钥，优先用已存在的公钥作为默认输入，并自动推导对应私钥。
• 如果本机还没有任何 SSH 密钥，安装器会提示自动生成新的密钥对，或直接进入交互式 ssh-keygen 生成流程，生成后自动继续安装。
• 密钥输入框支持直接改成其他公钥路径或私钥路径；如果输入公钥路径，安装器会校验对应私钥是否存在。
• 会先用当前选定的私钥检测目标服务器是否已完成 SSH 免密登录；若未完成，会自动尝试将本地公钥写入远程 ~/.ssh/authorized_keys，然后再次校验。
• 会询问服务监听范围，并据此生成 local.address、http.local.address、admin.address。
• 会先检查选中的 SSH 密钥是否存在，并在默认端口冲突时要求输入新端口。
• 会下载最新 Release 的目标资产与 SHA256SUMS，校验成功后再写入磁盘和注册服务。
• 默认配置为 socks5.enable=true、http.enable=false、admin.enable=true、自动更新开启。

落盘与服务布局

手动安装服务时，也请沿用上面的服务名和路径，这样管理页中的重启和升级逻辑才能准确识别当前平台服务。

配置示例

下面是与当前程序实现一致的规范配置键示例：

home.dir=/var/lib/ssh-tunnel
server.ip=your-ssh-server
server.ssh.port=22
ssh.private_key_path=/path/to/id_rsa
login.username=root
local.address=127.0.0.1:1081
http.local.address=127.0.0.1:1082
http.enable=false
socks5.enable=true
http.over-ssh.enable=false
http.domain-filter.enable=false
http.domain-filter.file-path=/var/lib/ssh-tunnel/domain.txt
admin.enable=true
admin.address=127.0.0.1:1083
log.file.path=/var/log/ssh-tunnel.log
auto-update.enabled=true
auto-update.owner=idefav
auto-update.repo=ssh-tunnel
auto-update.current-version=v0.0.0
auto-update.check-interval=3600

后续更新

一键安装只用于首装。升级现有实例时，请打开管理页面版本页：

http://127.0.0.1:1083/view/version

如果安装时自定义了管理端口，请使用当前 admin.address 对应的地址访问版本页。