Skip to main content

@keeb/nginx

v2026.04.22.3

Configure nginx as a TCP/UDP stream proxy on a remote host over SSH, with bootstrap and per-service proxy configuration.

Repository

https://github.com/keeb/swamp-nginx

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/nginx

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/nginx/streamv2026.02.14.1nginx_stream.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname for the proxy server
sshUserstringSSH user (default 'keeb')
streamDirstringPath to stream proxy directory
initBootstrap nginx stream proxy directory and start container
configureConfigure nginx stream proxy for a service
ArgumentTypeDescription
vmNamestringService name used for config filename
targetIpstringTailscale IP of the backend service
portMapstringPort mappings: 'listen:backend[/proto],...' e.g. '25565:25565,7777:7777/udp'

Resources

server(infinite)— Proxy server init result
proxy(infinite)— Proxy configuration result

@keeb/configure-proxy08985fcf-edbe-4353-8bcb-2ee26d14614c

Configure nginx stream proxy for a backend service

configureSync tailnet, then write nginx config and update docker-compose ports
1.tailscale-statustailscaleStatus.execute
2.sync-machinestailnet.sync
3.configure-proxystreamProxy.configure— Configure stream proxy for the service

nginx1 file