upnpc

Configure UPnP port forwarding on routers

TLDR

Forward external port to local

$ upnpc -a [192.168.0.1] 8080 80 tcp

Delete port forwarding

$ upnpc -d 80 tcp

Get device information

$ upnpc -s

List existing redirections

$ upnpc -l

upnpc configures port forwarding rules on a router using the UPnP (Universal Plug and Play) protocol. It allows applications to automatically set up port forwarding without manual router configuration.The tool can add, remove, and list port mappings, as well as query information about UPnP-enabled devices on the network.

PARAMETERS

-a IP INTERNALPORT EXTERNALPORT PROTOCOL

Add port mapping

-d EXTERNALPORT PROTOCOL_

Delete port mapping

-s

Show UPnP device information

-l

List existing port redirections

INSTALL

sudo apt install miniupnpc

sudo dnf install miniupnpc

sudo pacman -S miniupnpc

sudo apk add miniupnpc

sudo zypper install miniupnpc

brew install miniupnpc

nix profile install nixpkgs#miniupnpc

CAVEATS

Router must support and have UPnP enabled. Some ISP routers disable UPnP for security. Port mappings may be temporary. UPnP has security implications.

HISTORY

upnpc is part of the miniupnpc library, providing command-line access to UPnP Internet Gateway Device functionality.