Proxy Intro

Proxy Documentation

This section contains product documentation for TitaniumGuard Proxy.

Run with Docker

The Proxy image is published as:

ghcr.io/titaniumguardlabs/source/proxy:latest

The process accepts config via --config <path>.

1. Create a local config file

Example ./proxy-config.json (HTTP mode):

{
  "bind_address": "0.0.0.0",
  "http": { "enabled": true, "port": 8080 },
  "https": { "enabled": false },
  "socks5": { "enabled": false }
}

2. Run container and mount config

docker run --rm \
  -p 8080:8080 \
  -v "$PWD/proxy-config.json:/etc/titaniumguard/proxy-config.json:ro" \
  ghcr.io/titaniumguardlabs/source/proxy:latest \
  --config /etc/titaniumguard/proxy-config.json

3. Verify

curl -I http://127.0.0.1:8080

Optional modes

If you enable additional listeners in config, publish their ports as well:

HTTPS mode: map 8443:8443, and mount TLS cert/key paths referenced in config.
SOCKS5 mode: map 1080:1080.

Traffic policy

HTTP and CONNECT traffic allow/deny is configured exclusively through the proxy rule engine policy file.
See /docs/proxy/rule-engine-policy and /docs/proxy/configuration.