nomad-port-forward

Description

nomad-port-forward is a simple utility to forward ports from a Nomad job to a local machine.

Thanks to @picatz for showing how to do this in hashicorp/nomad#6925

Install

Homebrew

brew install Mongey/tap/nomad-port-forward

From source

go install github.com/Mongey/nomad-port-forward/cmd/nomad-port-forward@latest

Download binary

Download a pre-built binary from the releases page.

Usage

nomad-port-forward -alloc-id <alloc-id> -task nginx -p 8080:localhost:80

How it works

nomad-port-forward embeds a tiny static Go TCP proxy binary (tcpfwd) for linux/amd64 and linux/arm64. At runtime it:

1. Detects the target allocation's architecture via nomad alloc exec ... uname -m
2. Uploads the matching tcpfwd binary into the allocation at /tmp/tcpfwd
3. For each local connection, runs nomad alloc exec ... /tmp/tcpfwd addr:port to proxy traffic

No package manager, network access, or root permissions are needed inside the allocation.