V2Ray 的核心组件是一个命令行程序,它可以运行在多个平台上,并使用同样格式的参数和配置文件。预编译的核心程序可以在 Release 中下载到,解压即可运行。
如果你需要图形化界面的软件,请使用第三方客户端。
V2Ray 的部分功能依赖于系统时间,请确保使用 V2Ray 的系统 UTC 时间误差在两分钟之内,时区无关。
验证安装包
V2Ray 提供两种验证方式:
- 安装包 zip 文件的 SHA1 摘要,在下载页面的 metadata.txt 文件中可以找到。
- 可运行程序(v2ray 或 v2ray.exe)的 gpg 签名,文件位于安装包中的 v2ray.sig 或 v2ray.exe.sig。签名公钥可以在代码库中找到。
命令行参数
V2Ray 的程序文件的命令行参数如下:
v2ray [-version] [-test] [-config=config.json] [-format=json]
其中:
-version
: 只输出当前版本然后退出,不运行 V2Ray 主程序。-test
: 测试配置文件有效性,如果有问题则输出错误信息,不运行 V2Ray 主程序。-config
:- 默认格式为配置文件的路径,默认值是 config.json;
- 当值为
stdin:
时,将从标准输入读取配置文件内容,调用者必须在输入完毕后关闭标准输入流。
-format
: 配置文件格式,可选的值有:json
: JSON 格式;pb
或protobuf
: Protobuf 格式;
Linux 安装脚本
V2Ray 提供了一个在 Linux 中的自动化安装脚本。这个脚本会自动检测有没有安装过 V2Ray,如果没有,则进行完整的安装和配置;如果之前安装过 V2Ray,则只更新 V2Ray 二进制程序而不更新配置。
以下指令假设已在 su 环境下,如果不是,请先运行 sudo su。
运行下面的指令下载并安装 V2Ray。当 yum 或 apt-get 可用的情况下,此脚本会自动安装 unzip 和 daemon。这两个组件是安装 V2Ray 的必要组件。如果你使用的系统不支持 yum 或 apt-get,请自行安装 unzip 和 daemon
bash <(curl -L -s https://install.direct/go.sh)
此脚本会自动安装以下文件:
/usr/bin/v2ray/v2ray
:V2Ray 程序;/etc/v2ray/config.json
:配置文件;
此脚本会配置自动运行脚本。自动运行脚本会在系统重启之后,自动运行 V2Ray。目前自动运行脚本只支持带有 Systemd 的系统,以及 Debian / Ubuntu 全系列。
运行脚本位于系统的以下位置:
/lib/systemd/system/v2ray.service
: Systemd/etc/init.d/v2ray
: SysV
脚本运行完成后,你需要:
- 编辑 /etc/v2ray/config.json 文件来配置你需要的代理方式;
- 运行 service v2ray start 来启动 V2Ray 进程;
- 之后可以使用 service v2ray start|stop|status|reload|restart|force-reload 控制 V2Ray 的运行。
go.sh 参数
go.sh 支持如下参数,可在手动安装时根据实际情况调整:
-p
或--proxy
: 使用代理服务器来下载 V2Ray 的文件,格式与 curl 接受的参数一致,比如"socks5://127.0.0.1:1080"
或"http://127.0.0.1:3128"
。-f
或--force
: 强制安装。在默认情况下,如果当前系统中已有最新版本的 V2Ray,go.sh 会在检测之后就退出。如果需要强制重装一遍,则需要指定该参数。--version
: 指定需要安装的版本,比如"v1.13"
。默认值为最新版本。--local
: 使用一个本地文件进行安装。如果你已经下载了某个版本的 V2Ray,则可通过这个参数指定一个文件路径来进行安装。
用例
- 使用地址为 127.0.0.1:1080 的 SOCKS 代理下载并安装最新版本:
./go.sh -p socks5://127.0.0.1:1080
- 安装本地的 v1.13 版本:
./go.sh --version v1.13 --local /path/to/v2ray.zip
Docker
V2Ray 提供了两个预编译的 Docker image:
- v2ray/official : 包含最新发布的版本,每周跟随新版本更新;
- v2ray/dev : 包含由最新的代码编译而成的程序文件,随代码库更新;
两个 image 的文件结构相同:
- /etc/v2ray/config.json: 配置文件
- /usr/bin/v2ray/v2ray: V2Ray 主程序