配置文件格式

English German Russian

V2Ray 的配置文件形式如下，客户端和服务器通用一种形式，只是实际的配置不一样。

  1. {
  2.   "log": {},
  3.   "api": {},
  4.   "dns": {},
  5.   "stats": {},
  6.   "routing": {},
  7.   "policy": {},
  8.   "inbound": {},
  9.   "outbound": {},
  10.   "inboundDetour": [],
  11.   "outboundDetour": [],
  12.   "transport": {}
  13. }

其中：

  • log: 日志配置，见下文；
  • api: 内置的远程控置 API，详见远程控制配置；
  • dns: 内置的 DNS 服务器，若此项不存在，则默认使用本机的 DNS 设置。详见DNS 配置；
  • routing: 路由配置；
  • policy: 本地策略可进行一些权限相关的配置，详见本地策略；
  • inbound: 传入连接配置，见下文；
  • outbound: 传出连接配置，见下文；
  • inboundDetour: 额外的传入连接配置，见下文；
  • outboundDetour: 额外的传出连接配置，见下文；
  • transport: 用于配置 V2Ray 如何与其它服务器建立和使用网络连接。详见底层传输配置；
  • stats: 当此项存在时，开启统计信息。

日志配置 {#log}

  1. {
  2.   "access": "文件地址",
  3.   "error": "文件地址",
  4.   "loglevel": "warning"
  5. }

其中：

  • access: 访问日志的文件地址，其值可以是：
    • 一个合法的文件地址，如"/tmp/v2ray/_access.log"（Linux）或者"C:\\Temp\\v2ray\\_access.log"（Windows）；
    • 或者留空表示不记录访问日志，并将日志输出至 stdout。
  • error: 错误日志的文件地址，其值可以是：
    • 一个合法的文件地址，如"/tmp/v2ray/_error.log"（Linux）或者"C:\\Temp\\v2ray\\_error.log"（Windows）；
    • 或者留空表示不记录错误日志，并将日志输出至 stdout。
  • loglevel: 错误日志的级别，可选的值为"debug"、"info"、"warning"、"error" 和 "none"：
    • 其中"debug"记录的数据最多，"error"记录的最少；
    • "none"表示不记录任何内容；
    • 默认值为"warning"。

主传入连接配置 {#inbound}

传入连接用于接收从客户端（浏览器或上一级代理服务器）发来的数据，可用的协议请见协议列表。

  1. {
  2.   "port": 1080,
  3.   "listen": "127.0.0.1",
  4.   "protocol": "协议名称",
  5.   "settings": {},
  6.   "streamSettings": {},
  7.   "tag": "标识",
  8.   "domainOverride": ["http", "tls"],
  9.   "sniffing": {
  10.     "enabled": false,
  11.     "destOverride": ["http", "tls"]
  12.   }
  13. }

其中：

  • port: 端口。接受的格式如下:
    • 整型数值: 实际的端口号。
    • 环境变量 (V2Ray 3.23+): 以"env:"开头，后面是一个环境变量的名称，如"env:PORT"。V2Ray 会以字符串形式解析这个环境变量。
    • 字符串 (V2Ray 3.23+): 一个数值类型的字符串，如"1234"。
  • listen: 监听地址，只允许 IP 地址，默认值为"0.0.0.0"。
  • protocol: 连接协议名称，可选的值见协议列表。
  • settings: 具体的配置内容，视协议不同而不同。
  • streamSettings: 底层传输配置。
  • tag: 此传入连接的标识，用于在其它的配置中定位此连接。属性值必须在所有 tag 中唯一。
  • domainOverride: 识别相应协议的流量，并根据流量内容重置所请求的目标。
    • 接受一个字符串数组，默认值为空。
    • 可选值为 "http" 和 "tls"。
    • (V2Ray 3.32+) 已弃用。请使用 sniffing。当指定了 domainOverride 而没有指定 sniffing 时，强制开启 sniffing。
  • sniffing (V2Ray 3.32+): 尝试探测流量类型。
    • enabled: 是否开启流量探测。
    • destOverride: 当流量为指定类型时，按其中包括的目标地址重置当前连接的目标。
      • 可选值为 "http" 和 "tls"。

主传出连接配置 {#outbound}

主传出连接用于向远程网站或下一级代理服务器发送数据，可用的协议请见协议列表。

  1. {
  2.   "sendThrough": "0.0.0.0",
  3.   "protocol": "协议名称",
  4.   "settings": {},
  5.   "tag": "标识",
  6.   "streamSettings": {},
  7.   "proxySettings": {
  8.     "tag": "another-outbound-tag"
  9.   },
  10.   "mux": {}
  11. }

其中：

  • sendThrough: 用于发送数据的 IP 地址，当主机有多个 IP 地址时有效，默认值为"0.0.0.0"。
  • protocol: 连接协议名称，可选的值见协议列表。
  • settings: 具体的配置内容，视协议不同而不同。
  • tag: 此传出连接的标识，用于在其它的配置中定位此连接。属性值必须在所有 tag 中唯一。
  • streamSettings: 底层传输配置。
  • proxySettings: 传出代理配置。当传出代理生效时，此传出协议的streamSettings将不起作用。
    • tag: 当指定另一个传出协议的标识时，此传出协议发出的数据，将被转发至所指定的传出协议发出。
  • mux: Mux 配置。

额外的传入连接配置 {#inbound-detour}

此项是一个数组，可包含多个连接配置，每一个配置形如：

  1. {
  2.   "protocol": "协议名称",
  3.   "port": "端口",
  4.   "tag": "标识",
  5.   "listen": "127.0.0.1",
  6.   "allocate": {
  7.     "strategy": "always",
  8.     "refresh": 5,
  9.     "concurrency": 3
  10.   },
  11.   "settings": {},
  12.   "streamSettings": {},
  13.   "domainOverride": ["http", "tls"],
  14.   "sniffing": {
  15.     "enabled": false,
  16.     "destOverride": ["http", "tls"]
  17.   }
  18. }

其中：

  • protocol: 连接协议名称，可选的值见协议列表。
  • port: 端口。接受的格式如下:
    • 整型数值: 实际的端口号。
    • 环境变量 (V2Ray 3.23+): 以"env:"开头，后面是一个环境变量的名称，如"env:PORT"。V2Ray 会以字符串形式解析这个环境变量。
    • 字符串: 可以是一个数值类型的字符串，如"1234"；或者一个数值范围，如"5-10"表示端口 5 到端口 10 这 6 个端口。
  • tag: 此传入连接的标识，用于在其它的配置中定位此连接。属性值必须在所有 tag 中唯一。
  • listen: 监听地址，只允许 IP 地址，默认值为"0.0.0.0"。
  • allocate: 分配设置：
    • strategy: 分配策略，可选的值有"always"和"random"两个。"always"表示总是分配所有已指定的端口，port 是指定了多少个端口，V2Ray 就会监听这些端口。random 表示随机开放端口，每隔 refresh 分钟在 port 范围中随机选取 concurrency 个端口来监听。
    • refresh: 随机端口刷新间隔，单位为分钟。最小值为2，建议值为5。这个属性仅当 strategy = random 时有效。
    • concurrency: 随机端口数量。最小值为1，最大值为 port 范围的一半。建议值为3。
  • settings: 具体的配置内容，视协议不同而不同。
  • streamSettings: 底层传输配置。
  • domainOverride: 识别相应协议的流量，并根据流量内容重置所请求的目标。
    • 接受一个字符串数组，默认值为空。
    • 可选值为 "http" 和 "tls"。
    • (V2Ray 3.32+) 已弃用。请使用 sniffing。当指定了 domainOverride 而没有指定 sniffing 时，强制开启 sniffing。
  • sniffing (V2Ray 3.32+): 尝试探测流量类型。
    • enabled: 是否开启流量探测。
    • destOverride: 当流量为指定类型时，按其中包括的目标地址重置当前连接的目标。
      • 可选值为 "http" 和 "tls"。

额外的传出连接配置 {#outbound-detour}

此项是一个数组，可包含多个连接配置，每一个配置形如：

  1. {
  2.   "protocol": "协议名称",
  3.   "sendThrough": "0.0.0.0",
  4.   "tag": "标识",
  5.   "settings": {},
  6.   "streamSettings": {},
  7.   "proxySettings": {
  8.     "tag": "another-outbound-tag"
  9.   },
  10.   "mux": {}
  11. }

其中：

  • protocol: 连接协议名称，可选的值见协议列表；
  • sendThrough: 用于发送数据的 IP 地址，当主机有多个 IP 地址时有效，默认值为"0.0.0.0"。
  • tag: 当前的配置标识，当路由选择了此标识后，数据包会由此连接发出；
  • settings: 具体的配置内容，视协议不同而不同。
  • streamSettings: 底层传输配置。
  • proxySettings: 传出代理配置。当传出代理生效时，此传出协议的streamSettings将不起作用。
    • tag: 当指定另一个传出协议的标识时，此传出协议发出的数据，将被转发至所指定的传出协议发出。
  • mux: Mux 配置。