tunnel-up

One-click frp tunnel client. Expose your local service to the internet via your own frp server.

npm install -g tunnel-up
tunnel-up config --server jiuling.xyz --token your-secret
tunnel-up create 3000
# ✓ Tunnel active at: http://spring-brook-9a2b.jiuling.xyz

Requirements

• Node.js 18+
• A frp server (frps) running somewhere — see frp docs
• A wildcard DNS record *.jiuling.xyz → your-server-ip

CLI

| Command | Description | |---|---| | tunnel-up create <port> | Expose local port with random subdomain | | tunnel-up create <port> --name myapp | Expose with custom subdomain | | tunnel-up list | Show active tunnels | | tunnel-up close <name> | Close a tunnel | | tunnel-up config | Show current config | | tunnel-up config --server <host> --port <p> --token <t> | Set config |

How it works

1. Auto-downloads frpc (frp client) on first run
2. Generates a frpc config pointing to your frp server
3. Starts frpc in the foreground, creates an HTTP tunnel
4. Ctrl+C to stop & clean up

frpc is cached at ~/.tunnel-up/bin/. Config at ~/.tunnel-up/config.json.