skills.rest
orianna-ai
orianna-aiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

start-tunnel

Create a reverse tunnel from a local port to Softlight using frpc.

Updated Feb 24, 2026
Search Tags:#devops#tunnel#frp#reverse-tunnel#local-port#softlight
One-click install
npx skills add https://github.com/orianna-ai/claude-plugin --skill start-tunnel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: start-tunnel
Source: https://github.com/orianna-ai/claude-plugin/tree/main/plugins/softlight/skills/start-tunnel
Command: npx skills add https://github.com/orianna-ai/claude-plugin --skill start-tunnel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, curl, tar.

What problem does it solve?

Expose a locally running service to Softlight by creating a secure reverse tunnel that is accessible remotely without inbound connections.

Core Features & Use Cases

  • Reverse, rewriting tunnel: tunnels a local port to Softlight using frpc, with the service served under the /api/tunnel/<tunnel_id>/ prefix.
  • Return values for management: prints TUNNEL_ID and PID for monitoring and termination.
  • Use Case: when developing an API locally, start a tunnel and view the app at https://softlight.orianna.ai/api/tunnel/<tunnel_id>/ to test from remote locations.

Quick Start

Run the start-tunnel script with a local port to create a tunnel between Softlight and your application, then use the tunnel URL to access the service.

Frequently Asked Questions about start-tunnel

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

FAQPage Schema
How do I expose a local port for remote access without inbound network connections?▼

To expose a local port without inbound connections, you create a reverse tunnel using frpc that maps your local service to Softlight, generating a remote URL accessible from anywhere.

What dependencies do I need to run a reverse tunnel to Softlight?▼

Running a reverse tunnel to Softlight requires python3, curl, and tar. The script automatically downloads and launches frpc, so no manual binary installation is needed.

How do I access my locally running API from a remote location for testing?▼

Access your locally running API remotely by starting a tunnel with your local port. The service is then available at https://softlight.orianna.ai/api/tunnel/<tunnel_id>/ for remote testing.

How does the reverse tunnel rewrite local service requests under a specific prefix?▼

The reverse tunnel rewrites requests by serving your locally tunneled port under the /api/tunnel/<tunnel_id>/ prefix on Softlight, routing remote traffic directly to your local application.

How do I monitor or terminate a running local port tunnel after it starts?▼

To monitor or terminate a running local port tunnel, use the TUNNEL_ID and PID values printed when the tunnel starts. These identifiers allow you to track and stop the frpc process.

Does the start-tunnel script validate local ports before opening a connection?▼

Yes, the start-tunnel script validates the specified local port before downloading and launching frpc, ensuring the local service is listening and ready for the reverse tunnel connection.

Related Skills

Explore More Software Engineering Skills→
xiaoquqixiaoquqi

github-install-skill-offline

Install or upgrade skills and pip packages by downloading GitHub API tarballs.

Community
Intermediate
anthrilanthril
3

resource-dashboard-stop

Stop the Resource Manager dashboard via HTTP shutdown or PID file fallback.

Official
Intermediate
RheasilviaRheasilvia

pinggy-tunnel

Expose local network services to the public internet via SSH-based reverse tunneling.

Community
Intermediate
Quill-AgentQuill-Agent
3

pinggy-tunnel

Establish SSH reverse tunnels to expose local ports via public URLs.

Community
Intermediate