Local proxy that signs in to corporate NTLM, Negotiate, and Kerberos proxies.
For developers and AI agents on Windows, macOS, and Linux. Go port of px.
Corporate proxies ask for NTLM or Kerberos. curl, editors, package managers, and agents usually cannot answer. px-go listens on localhost, authenticates upstream, and forwards what those tools already send.
- One binary: about 15 MB, no runtime to install. Windows releases also include a headless build for Task Scheduler.
- Existing clients: point them at px-go like any HTTP proxy. CONNECT covers HTTPS.
- Wherever the proxy is: an upstream host, a PAC file, or the Windows system proxy.
Download a build from GitHub Releases (px-go on Linux and macOS, px-go.exe and headless pxw-go.exe on Windows). Or run the image:
docker run --rm -p 3128:3128 ghcr.io/blackdark/px-go:latest \
--server=corp-proxy:8080 --auth=NONE --gateway --foreground --log=4 \
--allow='10.0.0.0/8,172.16.0.0/12,192.168.0.0/16' \
--noproxy='localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,169.254.0.0/16'px-go --server=upstream.proxy:8080 --port=3128 --auth=NONE
curl --proxy http://127.0.0.1:3128 http://example.comUpstream needs NTLM, Negotiate, or a password? See Authentication.
Config precedence: defaults, then px.toml (else px.ini), then .env / PX_*, then CLI flags. See px.toml or px.ini.
--config=path/to/px.toml --server=proxy:8080 --pac=http://wpad/proxy.pac
--listen=127.0.0.1 --port=3128 --gateway / --hostonly
--username=DOMAIN\\user --auth=NTLM|NEGOTiate|...
--client-auth=BASIC --noproxy=localhost,10.0.0.0/8
--log=4 --log-file=/var/log/px-go/px-go.log
--health-check --test=http://httpbin.org/getEnvironment variables use PX_* (for example PX_SERVER, PX_PASSWORD, PX_LOG_FILE, PX_CLIENT_AUTH).
- HTTP and CONNECT: direct connections, or forwarding through an upstream proxy.
- Upstream auth: BASIC, DIGEST, NTLM, NEGOTIATE. Windows can use SSPI. Other systems use a username and password, and Kerberos from a ticket or a password.
- Client auth: BASIC, DIGEST, NTLM, NEGOTIATE for programs that connect to px-go.
- PAC, allow, noproxy: run a PAC file, and match IPs, CIDRs, wildcards, and domains.
- Health:
GET /healthreturns 200.GET /PxQuitfrom a local caller shuts the process down. - PAC reload: PAC files reload on the
proxyreloadinterval. - Logs: stdout or a file. The Windows headless build has no console, so set
log=1or--log-file.
On Windows, SSPI uses the signed-in user. Elsewhere, pass --username and a password (prompt, keyring, or PX_PASSWORD). See Authentication.
Image: ghcr.io/blackdark/px-go. Compose and manifests: Docker & Kubernetes. Build a local image with mise run docker-build.
px-go.exe has a console. pxw-go.exe does not; Task Scheduler should run that one. --install looks for a headless sibling named from the binary you started (pxw.exe beside px.exe, px-gow.exe beside px-go.exe). See Windows.
| Guide | Contents |
|---|---|
| Deployment overview | Choose a pattern; shared allow / noproxy defaults |
| Authentication | Upstream SSPI, NTLM, Kerberos, client auth, K8s secrets |
| VM & bare metal | systemd, per-service, hostonly / gateway |
| Docker & Kubernetes | Compose, K8s manifests, sizing |
| Windows | SSPI, WSL2, Task Scheduler, release binary names |
| Security | Open-proxy risk, credentials, TLS |
Requires mise.
git clone https://github.com/BlackDark/px-go && cd px-go
mise install
mise run checkProxy changes: go test -v ./internal/proxy/ -run TestIntegration.
Contributor notes: AGENTS.md.
Report a bug · License: Apache-2.0
px-go is not affiliated with genotrance/px.