多文件配置

自版本 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.confdir 或 V2RAY_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 配置中的inbounds和outbounds是数组结构，他们有特殊的规则：

当配置中的数组元素有 2 或以上，覆盖前者的 inbounds/outbounds；
当配置中的数组元素只有 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"
        }
    ]
}

# 多文件配置

# 多文件启动信息例子

# 用法说明

# 规则说明

# 普通对象（{}）

# 数组（[]）