hsync-server

April 10, 2026 · View on GitHub

CI npm version License: ISC

Server component for hsync — creates unlimited public web URLs for your local web servers, no matter where they're running.

Features

  • 🌐 Reverse proxy - Expose local servers with public URLs
  • 🔌 WebSocket tunneling - Real-time bidirectional communication
  • 🔐 Authenticated & anonymous modes - Secure with shared secret or allow public tunnels
  • 📡 TCP relaying - Tunnel arbitrary TCP connections between peers via WebRTC
  • 🚀 One-click deploy - Deploy to Heroku, DigitalOcean, or self-host

Quick Start

npm install hsync-server

export HSYNC_SECRET="your-secret-here"
npm start

Server runs on port 3101 by default.

Deploy

Deploy to Heroku

Configuration

See docs/customization.md for full configuration options including:

  • Environment variables
  • Nginx reverse proxy setup
  • Docker deployment
  • Unauthenticated access settings

Client

Use with the hsync client:

npx hsync -s your-server.com -k your-secret -n myapp -p 3000

Your local port 3000 is now available at https://myapp.your-server.com

License

ISC