配置概览

Pavonis 使用 YAML 格式的配置文件，通过 --config 参数指定路径。

顶层字段

字段	类型	是否必填	说明
debug	bool	否	是否开启 Debug 日志，默认 false
server	ServerConfig	否	服务器监听与可信代理配置
request	RequestConfig	否	出站请求配置（代理、IP 池、请求头修改）
response	ResponseConfig	否	响应配置（最大重定向次数、响应头修改）
resource_limit	ResourceLimitConfig	否	流量速率与请求速率限制
diagnostics	DiagnosticsConfig	否	诊断服务配置
sites	[]SiteConfig	是	站点列表，每项配置一个代理站点

Config 为顶层配置结构体。

完整配置示例

以下是一份涵盖多种功能的完整配置文件示例（所有域名已脱敏）：

debug: false

server:
  listen: 0.0.0.0:8009
  trusted_proxy_ips:
    - '127.0.0.1/24'
    - '10.0.0.0/8'
  trusted_proxy_headers:
    - 'CF-Connecting-IP'
    - 'X-Forwarded-For'
    - 'X-Real-IP'

request:
  ip_pool:
    enabled: true
    default_strategy: none
    subnets:
      - '2001:db8::/48'

resource_limit:
  traffic_avg_mibps: 100
  traffic_burst_mib: 50
  traffic_max_mibps: 200
  request_per_second: 100
  request_timeout: 30m

diagnostics:
  enabled: true
  listen: 127.0.0.1:6009

sites:
  # GitHub 文件加速
  - id: ghproxy
    host: gh.example.com
    mode: gh_proxy
    settings:
      size_limit: 104857600

  # Docker Hub 代理
  - id: dockerhub
    host: docker.example.com
    mode: container_registry_single
    self_url: https://docker.example.com

  # GHCR 代理
  - id: ghcr
    host: ghcr.example.com
    mode: container_registry_single
    self_url: https://ghcr.example.com
    settings:
      upstream_v2_url: https://ghcr.io/v2
      upstream_auth_realm_url: https://ghcr.io/token

  # 任意仓库代理
  - id: mirror
    host: mirror.example.com
    mode: container_registry_any
    self_url: https://mirror.example.com

  # Minecraft 认证聚合代理
  - id: mcauth
    host: mc.example.com
    mode: http
    settings:
      mappings:
        - path: '/auth'
          destination: https://authserver.mojang.com
        - path: '/account'
          destination: https://api.mojang.com
        - path: '/session'
          destination: https://sessionserver.mojang.com
        - path: '/services'
          destination: https://api.minecraftservices.com

  # PyPI 镜像
  - id: pypi
    host: pypi.example.com
    mode: pypi

  # HuggingFace 下载代理
  - id: huggingface
    host: hf.example.com
    mode: hugging_face
    self_url: https://hf.example.com

  # 测速（与 PyPI 共用主机，通过路径前缀区分）
  - host: pypi.example.com
    mode: speed_test
    path_prefix: /speedtest