tunl.cc

A simple tunneling service to expose your localhost to the internet.

Installation

via NPM

npm install -g tunl.cc

via Binary

Linux:

curl -L https://github.com/rishikesh-suvarna/tunl.cc/releases/latest/download/tunl-linux-x64 -o tunl
chmod +x tunl
sudo mv tunl /usr/local/bin/tunl

macOS (Intel):

curl -L https://github.com/rishikesh-suvarna/tunl.cc/releases/latest/download/tunl-macos-x64 -o tunl
xattr -d com.apple.quarantine tunl
chmod +x tunl
sudo mv tunl /usr/local/bin/tunl

macOS (Apple Silicon):

curl -L https://github.com/rishikesh-suvarna/tunl.cc/releases/latest/download/tunl-macos-arm64 -o tunl
xattr -d com.apple.quarantine tunl
chmod +x tunl
sudo mv tunl /usr/local/bin/tunl

Windows:

Invoke-WebRequest -Uri "https://github.com/rishikesh-suvarna/tunl.cc/releases/latest/download/tunl-win-x64.exe" -OutFile "tunl.exe"

Usage

Start a tunnel to your local server:

tunl <port> [subdomain]

Examples

# Tunnel port 8080 with random subdomain
tunl 8080

# Tunnel port 3000 with custom subdomain
tunl 3000 myapp

Your local server will be accessible at https://<subdomain>.tunl.cc

Server Setup

To run your own tunnel server:

# Install dependencies
npm install

# Build
npm run build

# Start server
BASE_DOMAIN=tunl.cc PORT=80 npm start

Environment Variables

• PORT - Server port (default: 3000)
• BASE_DOMAIN - Your domain (default: localhost:3000)
• HTTPS - Enable HTTPS (default: false)
• TUNNEL_SERVER - Tunnel server URL for client (default: wss://tunl.cc)

Development

# Install dependencies
npm install

# Run server in development mode
npm run dev:server

# Run client in development mode
npm run dev:client

# Build TypeScript
npm run build

# Run tests
npm test

DNS Configuration

For production deployment, add a wildcard DNS record:

*.<your-domain>.cc  →  YOUR_SERVER_IP

License

MIT

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Support

For issues and questions, please visit GitHub Issues