对于使用 V2Ray 的朋友来说，config.json 绝对是核心中的核心——它就像 V2Ray 的“操作手册”，所有的代理规则、连接方式、端口设置，都需要通过这个 JSON 格式的配置文件来定义。无论是新手刚接触时的“无从下手”，还是老手调试时的“细节翻车”，本质上都是对 config.json 的理解不够透彻。今天就来一篇保姆级科普，从基础定位、核心配置拆解、实用示例到避坑技巧，帮你彻底搞懂它～
一、先搞懂：config.json 是什么 & 在哪里
V2Ray 本身是一款灵活的代理工具，而 config.json 是它唯一的配置文件，负责告诉 V2Ray“如何监听请求”“如何转发流量”“如何对接服务器/客户端”。简单说，没有正确配置的 config.json，V2Ray 就无法正常工作。
不同系统中，config.json 的默认路径略有不同，新手可重点记这几个：
- Linux（如 Ubuntu）：默认路径为
/etc/v2ray/config.json，可通过sudo nano /etc/v2ray/config.json编辑，也可用cat /etc/v2ray/config.json查看配置内容[4]； - Windows：通常在 V2Ray 安装目录下，命名为
config.json，直接用记事本或专业编辑器（如 Notepad++）打开即可； - macOS：一般位于
~/Library/Application Support/v2ray/config.json。
如果觉得默认路径不方便，也可以在启动 V2Ray 时，通过 v2ray -config /path/to/config.json 命令，指定自定义路径的配置文件。
二、核心配置拆解：必懂的 4 大模块
config.json 的结构看似复杂，但核心只有 4 个模块，所有配置都围绕这 4 部分展开，新手先掌握这几个，就能应对大部分场景。注意：JSON 格式严格区分大小写，逗号不能漏，括号要配对，否则会导致配置失效（这是新手最常踩的坑）。
1. inbounds：入站配置（“接收请求的入口”）
inbounds 定义了 V2Ray 如何接收本地或外部的网络请求，相当于“大门”，所有需要代理的流量都从这里进入 V2Ray。核心参数如下：
port：监听端口（必填），比如 1080、8080，建议选择 1024 以上的端口，避免与系统默认端口冲突；protocol：入站协议（必填），常用的有http（HTTP 代理）、socks（SOCKS5 代理）、vmess（V2Ray 核心协议）；listen：监听地址（可选），默认是0.0.0.0（允许所有地址访问），如果只需要本机使用，可设为127.0.0.1，更安全；settings：协议相关设置（随协议变化），比如 socks 协议可设置用户名密码，vmess 协议需配置客户端信息。
示例（简单 HTTP 入站配置）：
{
"inbounds": [
{
"port": 1080,
"protocol": "http",
"settings": {}
}
]
}2. outbounds：出站配置（“转发请求的出口”）
outbounds 定义了 V2Ray 如何将接收的请求转发出去，相当于“后门”，决定了流量最终走向（是直连、代理还是阻断）。核心参数与 inbounds 对应，常用配置如下：
protocol：出站协议（必填），常用的有freedom（直连，不经过代理）、vmess（对接 V2Ray 服务器）、shadowsocks（对接 SS 服务器）；settings：协议相关设置（关键），比如 vmess 协议需填写服务器地址（address）、端口（port）、用户 ID（id）、额外 ID（alterId），且需与服务端配置完全一致；streamSettings：传输配置（可选，优化连接稳定性），常用network（传输方式，如 ws、tcp），比如 ws 协议需配置路径（path），与服务端 nginx 转发路径保持一致。
示例（vmess 出站配置，对接服务器）：
{
"outbounds": [
{
"protocol": "vmess",
"settings": {
"clients": [
{
"id": "b831381d-6324-4d53-ad4f-8cda48b30811",
"alterId": 64
}
],
"servers": [
{
"address": "mydomain.me",
"port": 443
}
]
},
"streamSettings": {
"network": "ws",
"wsSettings": {
"path": "/ray"
}
}
}
]
}3. routing：路由配置（“流量分流规则”）
routing 是 V2Ray 的“智能导航”，用于定义不同流量的转发规则——比如“国内网站直连，国外网站走代理”“游戏流量走特定出站”，避免所有流量都走代理，提升速度和稳定性。
核心逻辑：通过 rules 定义规则，每个规则包含 type（规则类型）、outboundTag（对应出站配置的标签）、domain（域名）或 ip（IP 地址）。新手可直接使用“默认路由”，后续再根据需求优化。
4. log：日志配置（“故障排查工具”）
log 用于配置 V2Ray 的日志输出，方便排查配置错误、连接失败等问题，新手建议开启，核心参数：
loglevel：日志级别，可选debug（详细，适合排查问题）、info（常规信息）、error（只显示错误）；access：访问日志路径，记录所有流量请求；error：错误日志路径，记录报错信息。
三、实用完整配置示例（新手直接用）
下面提供两个最常用的完整配置，新手可根据自己的场景修改参数（重点改标注的地方），复制到 config.json 中即可使用。
示例 1：客户端基础配置（对接 V2Ray 服务端）
{
"log": {
"loglevel": "info",
"access": "/var/log/v2ray/access.log",
"error": "/var/log/v2ray/error.log"
},
"inbounds": [
{
"port": 1080,
"listen": "127.0.0.1",
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
],
"outbounds": [
{
"tag": "proxy",
"protocol": "vmess",
"settings": {
"clients": [
{
"id": "替换为你的服务端ID",
"alterId": 64,
"security": "auto"
}
],
"servers": [
{
"address": "替换为服务端IP/域名",
"port": 替换为服务端端口
}
]
},
"streamSettings": {
"network": "ws",
"wsSettings": {
"path": "/ray" // 与服务端nginx转发路径一致
}
}
},
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
],
"routing": {
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:cn"],
"outboundTag": "direct"
}
]
}
}示例 2：服务端基础配置（搭配 Nginx 伪装）
服务端配置需与客户端对应，且建议搭配 Nginx 伪装成 HTTPS 流量，提升安全性（避免流量被探测），核心配置如下：
{
"log": {
"loglevel": "info"
},
"inbounds": [
{
"port": 10000,
"listen": "127.0.0.1", // 只监听本机，避免外部探测
"protocol": "vmess",
"settings": {
"clients": [
{
"id": "替换为客户端ID（与客户端一致）",
"alterId": 64
}
]
},
"streamSettings": {
"network": "ws",
"wsSettings": {
"path": "/ray" // 与Nginx配置中的路径一致
}
}
}
],
"outbounds": [
{
"protocol": "freedom",
"settings": {}
}
]
}四、新手必看：避坑技巧 & 实用操作
1. 常见配置错误（90% 新手踩过）
- JSON 格式错误：逗号漏写、括号不配对、大小写错误（比如 Protocol 写成 protocol 会失效），建议用 JSON 校验工具（如 JSON.cn）检查；
- 参数不匹配：服务端与客户端的 id、alterId、端口、ws 路径必须完全一致，否则无法连接；
- 端口冲突：inbounds 的 port 被其他程序占用，可更换端口（如 1081、8081），用
netstat -nr查看端口占用情况； - 权限不足：Linux 下编辑 config.json 需加 sudo，否则无法保存，保存后按
Ctrl+O确认、Ctrl+X退出编辑器。
2. 实用操作指令
- 生成配置文件：可通过 V2Ray 官方配置生成工具，命令：
wget https://raw.githubusercontent.com/v2fly/v2ray-core/master/release/configgen/config.json； - 重启 V2Ray（使配置生效）：Linux 下
sudo systemctl restart v2ray，Windows 下直接重启 V2Ray 客户端； - 查看配置是否生效：查看日志
cat /var/log/v2ray/error.log，无报错即生效，有报错可根据提示修改配置。
3. 安全建议
根据安全实践指南，配置 config.json 时需注意：使用最新版本的 V2Ray，修复已知漏洞；配置高强度的 ID 或 Token，避免被暴力破解；安装完成后，限制核心配置文件的访问权限，只允许本机访问，切勿泄露私钥或 ID 信息。
五、总结
其实 config.json 并不复杂，核心就是“入站（接收流量）→ 路由（分流流量）→ 出站（转发流量）”的逻辑，新手先掌握 inbounds 和 outbounds 两个核心模块，再逐步学习路由和日志配置，就能轻松搞定。
如果觉得手动编写麻烦，也可以用 V2Ray 配置生成工具（网上有很多在线工具），生成后根据自己的服务器信息修改关键参数即可。如果配置过程中遇到报错，优先查看日志，大部分问题都是格式错误或参数不匹配导致的～
最后提醒：使用 V2Ray 需遵守国家网络安全相关法律法规，仅用于合法的网络访问需求哦！
