# 多文件配置

自版本 4.23.0 起,V2Ray 程序支持使用多个配置文件。

多配置文件的主要作用在于分散不同作用模块配置,便于管理和维护。该功能主要考虑是为了丰富 V2Ray 的生态链,比如对于 GUI 的客户端,一般只实现节点选择等固定的功能,对于太复杂的配置难以图形化实现;只需留一个 confdir 的自定义配置目录供配置复杂的功能;对于服务器的部署脚本,只需往 confdir 添加文件即可实现配置多种协议,等等。

# 多文件启动信息例子

TIP

启动信息中会提示依次读入的每个配置文件,留意启动信息是否符合你预设的顺序。

$ v2ray -c v2ray.json -c 00_base.json -c 01_info.json -c 02_log.json -c outbound.json
V2Ray v4.23.0-version (user) 20200311-000000 (go1.13.8 linux/mipsle)
A unified platform for anti-censorship.
2020/03/22 18:40:00 [Info] v2ray.com/core/common/platform/ctlcmd: <v2ctl message>
v2ctl> Read config:  00_base.json
v2ctl> Read config:  01_info.json
v2ctl> Read config:  02_log.json
v2ctl> Read config:  outbound.json
v2ctl> [ outbound.json ] updated outbound with tag:  proxy

# 用法说明

命令行的 -config 可以多次指定。(也可以简写为 -c ,完全等效。)

v2ray -config base.json -config cf1.json -c cf2.json -c cf3.json

或者用 -confdir 参数指定一个目录,程序会按文件名顺序读取目录内的 .json 文件。

v2ray -confdir /etc/v2ray/confs

也可组合使用。(注意,目录内的配置级别作用在 -config 参数后,不管 -confdir 参数的位置)

v2ray -c cf1.json -c cf2.json -confdir /etc/v2ray/confs

也可使用 环境变量 v2ray.location.confdirV2RAY_LOCATION_CONFDIR 指定 confdir。参数 -confdir 的作用优先于环境变量,如果参数指定了有效的目录则不再读取环境变量中的路径。

# 规则说明

# 普通对象({}

在 json 的顶级对象当中,后者覆盖或补充前者。

比如:

  • base.json
{
    "log": {},
    "api": {},
    "dns": {},
    "stats": {},
    "policy": {},
    "transport": {},
    "routing": {},
    "inbounds": []
}
  • outbounds.json
{
    "outbounds": []
}

以多配置启动 V2Ray:

v2ray -c base.json -c outbounds.json

这两个配置文件的就等效于合成一起的整配置。当需要修改出口节点,只需要修改 outbounds.json 内容。

如果需要改编日志 log 的级别,也不需要改 base.json,只需后续增加一个配置:

  • debuglog.json
{
    "log": {
        "loglevel": "debug"
    }
}

启动时放置在 base 后,即可输出 debug 级别的日志:

v2ray -c base.json -c outbounds.json -c debuglog.json

# 数组([]

在 json 配置中的inboundsoutbounds是数组结构,他们有特殊的规则:

  • 当配置中的数组元素有 2 或以上,覆盖前者的 inbounds/oubounds;
  • 当配置中的数组元素只有 1 个时,查找原有tag相同的元素进行覆盖;若无法找到:
    • 对于 inbounds,添加至最后(inbounds 内元素顺序无关)
    • 对于 outbounds,添加至最前(outbounds 默认首选出口);但如果文件名含有 tail(大小写均可),添加至最后。

借助多配置,可以很方便为原有的配置添加不同协议的 inbound,而不必修改原有配置。

以下例子不是有效配置,只为展示上述规则。

  • 000.json
{
    "inbounds": [
        {
            "protocol": "socks",
            "tag":"socks",
            "port": 1234
        }
    ]
}
  • 001.json
{
    "inbounds": [
        {
            "protocol": "http",
            "tag":"http"
        }
    ]
}
  • 002.json
{
    "inbounds": [
        {
            "protocol": "socks",
            "tag":"socks",
            "port": 4321
        }
    ]
}

三个配置将会合成为:

{
    "inbounds": [
        {
            "protocol": "socks",
            "tag":"socks",
            "port": 4321 // <--- 002顺序在000后,因此覆盖tag为socks的inbound端口为4321
        },
        {
            "protocol": "http",
            "tag":"http"
        }
    ]
}

# 推荐的多文件列表

执行:

for BASE in 00_log 01_api 02_dns 03_routing 04_policy 05_inbounds 06_outbounds 07_transport 08_stats 09_reverse; do echo '{}' > "/etc/v2ray/$BASE.json"; done

for BASE in 00_log 01_api 02_dns 03_routing 04_policy 05_inbounds 06_outbounds 07_transport 08_stats 09_reverse; do echo '{}' > "/usr/local/etc/v2ray/$BASE.json"; done
.
├── 00_log.json
├── 01_api.json
├── 02_dns.json
├── 03_routing.json
├── 04_policy.json
├── 05_inbounds.json
├── 06_outbounds.json
├── 07_transport.json
├── 08_stats.json
└── 09_reverse.json

0 directories, 10 files