ssh-dev-suite/tunnel

Manage SSH tunnel lifecycle with profiles and JSON status tracking.

31|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/Ascend/agent-skills --skill ssh-dev-suite-tunnel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh-dev-suite/tunnel
Source: https://github.com/Ascend/agent-skills/tree/main/skills/drivingsdk-ascend-model-migration/ssh-connection/tunnel
Command: npx skills add https://github.com/Ascend/agent-skills --skill ssh-dev-suite-tunnel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, ssh, sshpass, and includes scripts (resource) components.

What problem does it solve?

SSH隧道管理常导致手动配置繁琐、无法可靠地维持本地/远程端口转发与代理通道。该 Skill 提供一个自包含的机制来创建、跟踪和终止隧道,提升远程访问的安全性和稳定性。

Core Features & Use Cases

  • 本地端口转发、远程端口转发、SOCKS代理和反向代理的生命周期管理,适用于需要稳定隧道的开发、运维场景。
  • 使用 profile 配置快速创建隧道并在后台运行,记录到 ~/.ssh/tunnels.json,便于监控和清理。
  • 提供停止、列出和清理无效隧道的能力,降低运维成本。

Quick Start

Use the tunnel script to establish a local port forward by specifying a profile and target host:port.

Frequently Asked Questions about ssh-dev-suite/tunnel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage SSH tunnel lifecycle and keep background port forwarding processes running stably?

SSH tunnel lifecycle management automates creating and tracking background port forwarding processes. It launches tunnels via profile configurations, records active sessions to ~/.ssh/tunnels.json, and provides commands to stop or list running tunnels for stable remote access.

What is the best way to set up local port forwarding and SOCKS proxy profiles for remote DevOps access?

The best way to set up local port forwarding and SOCKS proxy profiles is using a dedicated tunnel script. You specify a profile name and target host:port to quickly establish background SSH connections, bypassing manual configuration for reliable remote DevOps workflows.

Do I need sshpass and python to automate SSH reverse proxy and tunnel creation?

Yes, you need python, ssh, and sshpass installed to automate SSH reverse proxy and tunnel creation. These dependencies allow the script to handle authentication and execute the underlying SSH commands required for managing local and remote port forwards.

How can I track active SSH tunnels and clean up invalid or orphaned port forwarding sessions?

You can track active SSH tunnels and clean up invalid sessions using built-in status tracking. The system records all active port forwarding sessions in ~/.ssh/tunnels.json, enabling you to list running tunnels and automatically clean up orphaned or invalid connections.

Can I use a single profile to switch between local port forwarding, remote port forwarding, and SOCKS proxy modes?

Yes, you can configure a single profile to handle local port forwarding, remote port forwarding, and SOCKS proxy modes. The tunnel script applies these configurations to launch background SSH processes suitable for various remote-access scenarios.

Why does my manually configured SSH tunnel drop frequently compared to using lifecycle management scripts?

Manually configured SSH tunnels often drop because they lack lifecycle management and auditable tracking. Using a tunnel script maintains stable connections by running processes in the background and actively tracking their status in a centralized JSON registry.