fips-proxy

Lightweight HTTP reverse-proxy manager for routing traffic to .fips services. Configure targets in YAML, start them all with one command.

Quickstart

# Install dependencies
npm install

# Add a proxy (port auto-assigned if omitted)
node index.js add -t http://some-service.fips:50001 -a "my alias"

# List configured proxies
node index.js list

# Start all proxies
node index.js start

# Delete a proxy
node index.js delete 1          # by list number
node index.js delete -p 8000    # by port

Usage

node index.js start                          Start all proxies
node index.js list                           List configured proxies
node index.js add -t <url> [-p <port>] [-a <alias>]
                                              Add a proxy (port auto-assigned if omitted)
node index.js delete <number>                 Delete by list number (1-based)
node index.js delete -p <port>                Delete by port

Configuration

Proxies are stored in config.yaml (gitignored — create your own):

proxies:
  - port: 50001
    target: http://example.fips:50001
    alias: my service
  - port: 3003
    target: http://another.fips:3001

Fields

Field	Required	Description
port	Yes	Local port to listen on
target	Yes	Upstream URL to proxy requests to
alias	No	Human-readable label for the proxy

How it works

Each proxy is an Express server with http-proxy-middleware that forwards all incoming requests to the configured .fips target. WebSocket connections (ws://) are upgraded transparently.

Auto-assigned ports start from 8000 and increment until a free port is found.

Press Ctrl+C to gracefully stop all running proxies.

Dependencies

• Express 5
• http-proxy-middleware
• js-yaml