PortUP

🚀 PortUP is a simple command-line tool that uses UPnP to expose local ports, making your services accessible from the internet.

🌐 Features

• ✅ Supports TCP and UDP port forwarding
• ✅ Add multiple port mappings at once
• ✅ Supports IGDv2 and IGDv1
• ✅ Friendly console output with colorized formatting

🛠️ Installation

go install github.com/IIpho3nix/PortUP@latest

or download the binaries from Releases

⚙️ Usage

PortUP <tcp|udp> <port mapping> [<port mapping> ...]

🧾 Port Mapping Formats

• <port>
  Forward local port to the same remote port.

• <local>~<remote>
  Forward local port to a different remote port.

• <ip:port>
  Forward from a specific local IP and port to same remote port.

• <ip:port>~<remote>
  Forward from specific local IP and port to remote port.

📌 Examples

PortUP tcp 8080

Forwards local TCP port 8080 to external port 8080.

PortUP udp 5000~6000

Forwards local UDP port 5000 to external port 6000.

PortUP tcp 8080~12345 9090 7070~7071

Forwards multiple TCP ports with custom mappings.

PortUP tcp 192.168.1.50:8080~80

Forwards external TCP port 80 to 192.168.1.50's port 8080.

PortUP cleanup

Cleans up previous port mappings left behind after a improper shutdown.

✨ mDNS mode!

with the new mDNS mode, you can register .local domains for your services on your local network!

PortUP mdns machine

registers machine.local for the current computer

PortUP mdns 192.168.1.50~service

registers service.local for 192.168.1.50

⚠️ Requirements

• A router that supports UPnP and has it enabled.

🙌 Acknowledgments

• charmbracelet/log — for beautiful logging
• huin/goupnp — for UPnP
• pion/mdns — for mDNS

📝 License

Released under MIT by IIpho3nix.