端口转发隧道

Reeve 集成 SSH-L（本地转发）隧道管理：用 SSH 连接把远端服务的端口映射到本机，可视化管理生命周期。

进入

• 主界面左侧导航 → 端口转发
• 服务器清单行 → 隧道 按钮（仅显示该服务器的转发）

什么是 SSH-L 本地转发

本机                  Reeve              远端服务器
localhost:3306 <──> Reeve <──ssh──> mysql:3306
        ^                                   ^
        │                                   │
   你的 DBeaver                      只在内网可达的 MySQL

效果：你在本机 localhost:3306 上连接 MySQL，流量通过 SSH 隧道转到远端的 MySQL 服务。

适合场景：

• 远端数据库只对内网开放，不暴露公网
• 用 DBeaver / TablePlus / pgAdmin 本地图形界面连远端 DB
• 临时调试 Web 服务（远端 8080 映射到本机）

列表视图

每条隧道显示：

字段	示例
名称	prod-mysql
服务器	prod-db-1
本地端口	localhost:3306
远端目标	127.0.0.1:3306（在远端的视角）
状态	运行中 / 已停止 / 错误
用时	2h 34m

操作列：启动 / 停止 / 编辑 / 删除。

创建隧道

右上 新建隧道 按钮：

字段	说明
名称	自取，方便识别
服务器	从已有服务器选
本地端口	本机监听端口（如 3306）
远端主机	远端能访问的目标（如 127.0.0.1 / 内网 DB 主机）
远端端口	目标端口

保存后默认停止状态。点 启动 激活。

自动管理

• 空闲回收：超过 10 分钟没有连接通过隧道，自动停止（避免占端口）
• 优雅关闭：Reeve 退出时所有隧道优雅关闭
• 重启策略：如果远端 SSH 连接断了，下次手动启动会重新建立

数据库工作台不用在这里建隧道

在 Reeve 自己的数据库工作台里连服务器上的数据库，不需要先在本页建隧道：

• 连接的归属选了服务器，就默认经它的 SSH 隧道连接（连接表单里的「经服务器 SSH 隧道访问」开关）
• 隧道在连接时自动建立、闲置自动回收，不会出现在本页列表里
• AI 装好的数据库（MySQL / PostgreSQL / Redis 等）登记的凭据同样默认走隧道，装完即可在工作台直接连

本页适合给 DBeaver / TablePlus 等外部工具用。若一定要让工作台的连接走本页建的隧道：连接的归属选「本机 / 本地」，主机填 127.0.0.1、端口填隧道的本地端口，详见经服务器 SSH 隧道连接。

典型用法

MySQL 远端映射本地

• 远端：172.17.0.5:3306（Docker 网络内的 MySQL）
• 本地：localhost:3306
• 在 DBeaver 连 localhost:3306 像连本地一样

远端 Web UI 临时调试

• 远端：127.0.0.1:9090（Prometheus）
• 本地：localhost:9090
• 浏览器开 http://localhost:9090 看面板

Grafana 共用

• 远端：localhost:3000
• 本地：localhost:3000

限制

项目	说明
反向转发 (SSH-R)	暂不支持，规划中
动态转发 (SSH-D / SOCKS)	暂不支持
转发到 0.0.0.0	永不允许，本地始终绑 127.0.0.1，不暴露公网

安全

• 隧道只在本机 127.0.0.1 监听，不暴露公网
• 远端流量走 SSH 加密
• 凭据加密同服务器管理
• 停止 / 删除隧道都写审计

下一步

• 服务凭据
• 数据库工作台