PortBuddy 🚀

PortBuddy is a powerful yet simple tool that allows you to expose a port opened on your local host or in a private network to the public internet. It works as a secure tunnel, similar to ngrok, providing a public URL for your local services.

Whether you're developing a web app, testing webhooks, or sharing access to a local database, PortBuddy makes it easy and secure.

✨ Features

• Multi-protocol support: Tunnel HTTP, TCP, and UDP traffic.
• SSL by default: All HTTP tunnels are automatically secured with SSL.
• Customizable: Support for static subdomains and custom domains.
• Websocket support: Full support for real-time applications.
• Private tunnels: Secure your tunnels with passcodes.
• Cross-platform CLI: Lightweight CLI built with Java 25 and GraalVM (native executable).
• Web Dashboard: Manage your tunnels, subscriptions, and team members easily.

🚀 Quick Start

1. Installation

Download the latest version of the portbuddy CLI for your platform (Windows, Linux, or Mac).

2. Authentication

Before exposing ports, you need to authenticate your CLI.

1. Log in to your account at portbuddy.dev.
2. Generate an API Token in your dashboard.
3. Run the following command:

   portbuddy init {YOUR_API_TOKEN}
   

3. Expose a Port

HTTP (Default)

Expose a local web server running on port 3000:

portbuddy 3000

Output: http://localhost:3000 exposed to: https://abc123.portbuddy.dev

TCP

Expose a local PostgreSQL database:

portbuddy tcp 5432

Output: tcp localhost:5432 exposed to: net-proxy-3.portbuddy.dev:43452

UDP

Expose a local UDP service:

portbuddy udp 9000

🛠️ CLI Usage

Usage: portbuddy [options] [mode] [host:][port]

Modes:
  http (default), tcp, udp

Options:
  -d,  --domain=<domain>        Requested static subdomain (e.g. my-app)
  -pr, --port-reservation=<hp>  Use specific port reservation host:port for TCP/UDP
  -pc, --passcode=<passcode>    Protect tunnel with a passcode
  -v,  --verbose                Enable verbose logging
  -h,  --help                   Show help message
  -V,  --version                Show version info

💳 Subscription Plans

📄 License

This project is licensed under the Apache License, Version 2.0.

GitHub

Source code is open and available on GitHub amak-tech/port-buddy