Proxies
Orb supports routing requests through HTTP and SOCKS5 proxies.
HTTP Proxy
Section titled “HTTP Proxy”Use -x or --proxy with an HTTP proxy URL:
orb -x http://proxy.example.com:8080 https://api.example.comWith Authentication
Section titled “With Authentication”orb -x http://user:password@proxy.example.com:8080 https://api.example.comHTTPS Proxy (CONNECT)
Section titled “HTTPS Proxy (CONNECT)”For HTTPS requests through an HTTP proxy, orb uses the CONNECT method:
orb -x http://proxy.example.com:8080 https://secure.example.comThe proxy creates a tunnel, and TLS is established end-to-end with the target server.
SOCKS5 Proxy
Section titled “SOCKS5 Proxy”Use a socks5:// URL:
orb -x socks5://proxy.example.com:1080 https://api.example.comSOCKS5 with Authentication
Section titled “SOCKS5 with Authentication”orb -x socks5://user:password@proxy.example.com:1080 https://api.example.comProxy Types Comparison
Section titled “Proxy Types Comparison”| Type | Use Case | DNS Resolution |
|---|---|---|
| HTTP | Web traffic, corporate proxies | Proxy resolves |
| SOCKS5 | Generic TCP, anonymity | Proxy resolves |
Common Proxy Scenarios
Section titled “Common Proxy Scenarios”Corporate Proxy
Section titled “Corporate Proxy”orb -x http://corporate-proxy.internal:8080 \ https://external-api.example.comSSH Tunnel as SOCKS5
Section titled “SSH Tunnel as SOCKS5”If you have an SSH tunnel:
# In another terminal: ssh -D 1080 user@serverorb -x socks5://localhost:1080 https://api.example.comLocal Development Proxy
Section titled “Local Development Proxy”# Charles Proxy, Fiddler, mitmproxy, etc.orb -x http://localhost:8888 https://api.example.com
# May need to trust proxy's CA for HTTPS inspectionorb -x http://localhost:8888 \ --cacert ~/.mitmproxy/mitmproxy-ca-cert.pem \ https://api.example.comProxy with Other Options
Section titled “Proxy with Other Options”With Authentication
Section titled “With Authentication”orb -x http://proxy:8080 \ -u api-user:api-password \ https://api.example.com/protectedWith Custom Headers
Section titled “With Custom Headers”orb -x http://proxy:8080 \ -H "X-Forwarded-For: 192.168.1.1" \ https://api.example.comWith Verbose Output
Section titled “With Verbose Output”orb -v -x http://proxy:8080 https://api.example.comShows proxy connection details:
* Connecting via proxy http://proxy:8080* CONNECT api.example.com:443 HTTP/1.1* Proxy CONNECT response: 200* TLS handshake completedEnvironment Variables
Section titled “Environment Variables”Limitations
Section titled “Limitations”- Only HTTP CONNECT and SOCKS5 proxies are supported
- No SOCKS4 support
- No automatic proxy detection
- No proxy bypass/exclusion lists