Proxy

March 18, 2026 ยท View on GitHub

Proxy endpoints configure geo-spoofing for tunnels. When enabled, HTTP requests from the tunnel are routed through a proxy that makes them appear to originate from a different geographic location. This affects the apparent location reported by websites and services that use IP geolocation.


get_proxy_config

Returns the current proxy configuration for a tunnel.

Parameters

ParameterRequiredDescription
tokenYesAuth token
tunnel_tokenYesTunnel token

Example

curl -s -X POST https://config.doxx.net/v1/ \
  -d "get_proxy_config=1&token=$TOKEN&tunnel_token=TUNNEL_TOKEN" | jq .

Response

{
  "status": "success",
  "config": {
    "tunnel_token": "abc...",
    "assigned_ip": "10.1.0.226",
    "assigned_v6": "2602:f5c1:1::1c0:8916",
    "enabled": false,
    "location": "newyork-us",
    "browser": null,
    "custom_lat": null,
    "custom_lon": null
  }
}

Response Fields

FieldTypeDescription
enabledboolWhether the proxy is currently active
locationstringLocation ID determining the apparent geographic origin of proxied requests
browserstring or nullBrowser fingerprint identifier for HTTP header spoofing
custom_latfloat or nullCustom latitude for geolocation spoofing (overrides location-based coordinates)
custom_lonfloat or nullCustom longitude for geolocation spoofing (overrides location-based coordinates)

update_proxy_config

Updates the proxy configuration for a tunnel. Only provided parameters are changed.

Parameters

ParameterRequiredDescription
tokenYesAuth token
tunnel_tokenYesTunnel token
enabledNo1 to enable the proxy, 0 to disable
locationNoLocation ID (e.g. newyork-us, london-uk, tokyo-jp)
browserNoBrowser fingerprint string for HTTP header spoofing

Example: Enable proxy with New York location

curl -s -X POST https://config.doxx.net/v1/ \
  -d "update_proxy_config=1&token=$TOKEN&tunnel_token=TUNNEL_TOKEN&enabled=1&location=newyork-us" | jq .

Example: Change location

curl -s -X POST https://config.doxx.net/v1/ \
  -d "update_proxy_config=1&token=$TOKEN&tunnel_token=TUNNEL_TOKEN&location=london-uk" | jq .

Example: Disable proxy

curl -s -X POST https://config.doxx.net/v1/ \
  -d "update_proxy_config=1&token=$TOKEN&tunnel_token=TUNNEL_TOKEN&enabled=0" | jq .

Response

{
  "status": "success",
  "message": "Proxy configuration updated"
}

Geo-Spoofing Details

When the proxy is enabled:

  1. IP Geolocation: HTTP requests appear to originate from the configured location, affecting IP-based geolocation services.
  2. Browser Fingerprint: If a browser value is set, HTTP headers (User-Agent, Accept-Language, etc.) are modified to match the specified browser profile.
  3. Custom Coordinates: When custom_lat and custom_lon are set, they override the location's default coordinates for services that check GPS-level geolocation via JavaScript APIs.

Notes

  • The proxy only affects HTTP/HTTPS traffic, not raw IP connections.
  • Enabling the proxy requires the tunnel to be connected.
  • Proxy is a Pro subscription feature.