SuperAPI AI 工具集

ssh-dev-suite/tunnel

部署与运维

查看项目

更新于 10-24 04:38

技能介绍

ssh-dev-suite/tunnel 是一个面向 SSH 通道管理的智能体技能,用于创建和维护 SSH 端口转发与代理通道,并对这些通道进行生命周期管理。

用途 该技能主要用于管理 SSH 隧道,覆盖本地端口转发、远程端口转发、SOCKS 代理和反向代理等常见通道形式,适合需要经由 SSH 连接建立网络访问路径的开发和运维场景。

主要能力 支持四类通道操作:forward(本地端口转发)、reverse(远程端口转发)、socks(SOCKS 代理)和 proxy(反向代理)。同时提供通道生命周期管理,包括列出当前通道(list)、停止单个通道(stop <tunnel_id>)和停止全部通道(stop-all)。隧道记录写入 ~/.ssh/tunnels.json,list 命令会自动清理失效进程。proxy 命令会输出远程端需要执行的环境变量命令。命令成功返回 0,失败返回非 0。

使用方式 配置需参考 config.example.yaml 的 tunnels 段,其中 profile 引用 connect 配置。命令示例如下: bash tunnel/scripts/ssh-tunnel.sh forward <profile> <lport>:<rhost>:<rport> bash tunnel/scripts/ssh-tunnel.sh reverse <profile> <rport>:<lhost>:<lport> bash tunnel/scripts/ssh-tunnel.sh socks <profile> <local_port> bash tunnel/scripts/ssh-tunnel.sh proxy <profile> [--local-proxy-port 7890] bash tunnel/scripts/ssh-tunnel.sh list bash tunnel/scripts/ssh-tunnel.sh stop <tunnel_id> bash tunnel/scripts/ssh-tunnel.sh stop-all

适用场景 适用于需要通过 SSH 建立端口转发或代理通道,并对多个通道进行统一查看、停止与清理的工作流,例如开发调试期间的端口映射和代理访问。

限制 资料未提供具体的系统依赖、SSH 服务端配置要求、并发数量上限或安全注意事项等细节,暂未提供。实际使用前需按 config.example.yaml 准备 tunnels 与 connect 配置。