v2ray-core：Project V 网络工具核心部署与使用指南

v2ray-core 是 Project V 的核心实现。Project V 是一套帮助你搭建自有计算机网络的网络工具集，核心目标是加密网络连接、保护隐私。它以单个可执行文件分发，通过 JSON 配置灵活组合入站/出站协议，支持 VMess、VLESS、WebSocket、mKCP、QUIC 等多种传输方式，是自托管网络通信场景中被广泛使用的开源底座。

一、项目官方信息

二、官方图片

Project V 官方 Logo：

三、环境要求

• 操作系统：Linux（x86_64 / ARM64 等）、macOS、Windows；服务端推荐 64 位 Linux。
• 运行方式：从 Releases 下载对应平台的预编译压缩包，解压即得 v2ray 可执行文件，无需额外运行时（Go 静态编译）。
• 配置：一个 JSON 格式的配置文件（官方文档提供完整 schema 与示例）。
• 网络：按你选择的入站协议放行对应端口；服务端需有公网可达地址。

四、完整部署步骤

1. 下载发行版

到 Releases 页 https://github.com/v2fly/v2ray-core/releases 选择最新版本，下载与你服务器平台对应的压缩包（如 v2ray-linux-64.zip）。解压后得到：

• v2ray：主程序；
• geoip.dat / geosite.dat：地理位置路由数据文件（随包提供）；
• 示例配置 config.json。

2. 放置文件（示例布局）

把主程序与数据文件放到约定目录，例如：

mkdir -p /usr/local/bin /usr/local/share/v2ray /etc/v2ray
# 解压后
cp v2ray /usr/local/bin/
cp geoip.dat geosite.dat /usr/local/share/v2ray/
cp config.json /etc/v2ray/

3. 编写配置文件

配置是一个 JSON 对象，核心由 inbounds（入站）与 outbounds（出站）组成。一个最小骨架（结构以官方文档为准）：

{
  "log": { "loglevel": "warning" },
  "inbounds": [
    {
      "listen": "0.0.0.0",
      "port": 10086,
      "protocol": "vmess",
      "settings": {
        "clients": [
          { "id": "换成你自己的 UUID" }
        ]
      }
    }
  ],
  "outbounds": [
    { "protocol": "freedom" },
    { "protocol": "blackhole" }
  ]
}

UUID 可用 v2ray uuid 或任意 UUID 生成器得到；具体字段、传输层（WebSocket / TCP / QUIC 等）与 TLS 配置请严格对照官方文档 https://www.v2fly.org 的配置说明。

4. 启动

在配置文件所在目录前台运行：

v2ray run -c /etc/v2ray/config.json

也可直接指定数据目录：

v2ray run -c /etc/v2ray/config.json \
  -location /usr/local/share/v2ray

前台能看到启动日志；确认无报错、端口正常监听即部署成功。生产环境建议用 systemd 或容器方式常驻。

5. 验证

# 查看版本
v2ray version
# 查看帮助
v2ray help

在服务器上确认入站端口处于监听状态：

ss -tlnp | grep 10086

五、使用方法

• 服务端：按上面配置好一个入站协议（如 VMess），把地址、端口、UUID、加密方式分发给客户端。
• 客户端：在自己的设备上运行同一份 v2ray，配置一个指向服务端的出站（对应协议），并配合本地 HTTP/SOCKS 入站供浏览器或系统代理使用。
• 路由：通过 routing 规则可按域名、IP 地理位置分流，配合 geoip.dat / geosite.dat 实现按规则选择出站。
• 配置参考：官方文档站 https://www.v2fly.org 与新人指南 https://www.v2fly.org/guide/start.html 提供了从安装到首个配置的完整示例。

六、常见问题 FAQ

Q1：启动报配置解析错误？ 多为 JSON 语法或字段名不匹配。请用官方文档的配置示例逐段核对，注意 inbounds/outbounds 是数组，UUID 格式要合法。

Q2：v2ray: command not found？ 说明主程序不在 PATH。把解压出的 v2ray 放到 /usr/local/bin/ 并确认有执行权限（chmod +x v2ray）。

Q3：客户端连不上？ 依次检查：服务端入站端口是否放行、UUID 是否与服务端一致、TLS / 传输层参数两端是否完全匹配、防火墙与安全组是否放行。

Q4：geoip/geosite 数据如何更新？ 随 Releases 发布对应数据文件，可定期从新版 Releases 下载 geoip.dat、geosite.dat 替换到数据目录。

Q5：v2ray-core 支持哪些协议？ 核心内置 VMess、VLESS、Socks、HTTP、Freedom、Blackhole 等，并支持 WebSocket、TCP、mKCP、QUIC 等传输层；完整清单见官方文档。

Q6：项目协议是什么？商用有限制吗？ 采用 MIT 许可证，允许自由使用、修改与再分发（详见仓库 LICENSE）。

七、跳转链接

• GitHub 仓库：https://github.com/v2fly/v2ray-core
• 官方文档：https://www.v2fly.org
• 新人入门：https://www.v2fly.org/guide/start.html
• 发布版本：https://github.com/v2fly/v2ray-core/releases