For AI agents: the complete documentation index is available at https://aioproxy.dev/llms.txt, the full documentation bundle is available at https://aioproxy.dev/llms-full.txt, and this page is available as Markdown at https://aioproxy.dev/guide/configuration/proxy.md.
  • English
  • Proxy & High Availability (proxy)

    The proxy block sets global outbound networking policies, including proxy chains, connection limits, and error timeouts.

    config.jsonc
    {
      "proxy": {
        "url": "http://127.0.0.1:7890",
        "noProxy": ["localhost", "127.0.0.1", "*.internal.net"],
        "timeoutMs": 60000,
        "maxRetries": 3,
        "circuitBreaker": {
          "failureThreshold": 5,
          "resetTimeoutMs": 30000,
        },
      },
    }

    Key Configuration Fields

    • url: Outbound HTTP/HTTPS or SOCKS5 proxy URL for reaching upstream model services.
    • noProxy: Hostnames or CIDR domains that bypass the proxy.
    • timeoutMs: Maximum request timeout in milliseconds before triggering a failover.
    • maxRetries: Maximum number of failover attempts across available candidates for a single request.
    • circuitBreaker: Circuit breaker parameters. When an upstream provider accumulates consecutive network failures exceeding failureThreshold, it is temporarily cooled down for resetTimeoutMs before re-probing.