配置开发环境

优质

小牛编辑

142浏览

2023-12-01

V2Ray 使用 Golang 作为主要编程语言。团队发布流程上使用 Bazel作为构建工具。推荐使用 Mac OS 或 Linux 进行开发，少量的脚本可能无法在 Windows 上正常运行。

前序工作

安装 Golang: golang.org/doc/install
安装 Bazel: docs.bazel.build/install （手工/脚本编译方式无需）

拉取 V2Ray 源代码

go get -insecure -u v2ray.com/core/...

注意在无法正常访问google的网络环境，这个命令无法完成，需要先配置好一个本地的HTTP代理服务器，并配置本地环境变量，比如

export http_proxy=http://localhost:1080
export https_proxy=http://localhost:1080

go将会使用本地的1080端口的HTTP代理进行源码拉取。

手工构建

cd $(go env GOPATH)/src/v2ray.com/core/main
env CGO_ENABLED=0 go build -o $HOME/v2ray -ldflags "-s -w"

cd $(go env GOPATH)/src/v2ray.com/core/infra/control/main
env CGO_ENABLED=0 go build -o $HOME/v2ctl -tags confonly -ldflags "-s -w"

以上命令在当前用户的$HOME目录下生成刚新构建的v2ray 、v2ctl执行文件，即可正常使用。

构建其他CPU架构、其他系统（windows/macos）的过程属于golang的交叉编译流程，主要是控制GOOS/GOARCH两个变量，这里不再重复，查阅golang相关文档。

脚本构建

以上手工构建的只是v2ray可执行程序本身，发行包zip内还包含了地址库等其他文件。使用打包脚本可方便地制作出的发布包。

wget https://raw.githubusercontent.com/v2ray/v2ray-core/master/release/user-package.sh
chmod 755 user-package.sh

以上脚本直接执行即可在当前目录生成类似v2ray-custom-linux-amd64-20190710-000000.zip的文件，即为发布包。

这个脚本可用一些参数编译出自行定制的发布包：

windows 构建windows版本的发布包
darwin 构建darwin（MacOS）版本的发布包
tgz 最后打包成tar.gz而不是zip格式
386 构建成32位程序
arm 构建适合arm架构CPU的程序，arm arm64
mips 同上，参照golang的交叉编译文档
nodat 不要包含地址库geoip.dat geosite.dat，可以减小发布包的大小
noconf 不要包括范例json, systemd/systemv等配置文件
nosource 不要执行go get ...，避免已经拉取到本地的v2ray源码被覆盖

以上参数没有次序要求，只需要按需传给脚本，比如构建一个适合windows 32位，不带地址库，不带样例配置的发布包：

./user-package.sh windows 386 nodat noconf

脚本编译的v2ray，其启动信息会变成用户编译的时间，以做区分：

V2Ray 4.20.0 (user) 20190710-010000
A unified platform for anti-censorship.

用户还可修改脚本内的信息，定制属于自己的版本。

CODENAME="user"
BUILDNAME=$NOW

自动构建

bazel构建工具主要是发布团队使用。

如果只需要构建某个特定平台的安装包，如 Linux / AMD64:

cd $GOPATH/src/v2ray.com/core
bazel build --action_env=GOPATH=$GOPATH --action_env=PATH=$PATH //release:v2ray_linux_amd64_package
#Output: bazel-bin/release/v2ray-linux-64.zip

构建所有安装包:

cd $GOPATH/src/v2ray.com/core
bazel build --action_env=GOPATH=$GOPATH --action_env=PATH=$PATH //release:all

安装构建完成的安装包

$GOPATH/src/v2ray.com/core/release/install-release.sh --local <path/to/zip/file>

自动化从源代码构建

某些场景可能需要从源代码构建，而不能直接下载安装包，比如制作一个安装源的时候。以下提供一个简单的自动构建方法:

安装 Golang 和 Bazel，并设置 GOPATH。
~~下载完整的源代码: curl -L -O https://github.com/v2ray/v2ray-core/releases/latest/src_all.zip。这个压缩包从 3.46.4 开始提供，包含了编译 V2Ray 所需的所有代码。~~ 从4.19开始src_all.zip不再提供，因ext仓库已经合并。
解压: unzip -d $GOPATH/src/ src_all.zip
构建:

cd $GOPATH/src/v2ray.com/core
bazel build --action_env=GOPATH=$GOPATH --action_env=PATH=$PATH //release:v2ray_linux_amd64_package

然后可以解压安装包并重新打包: unzip bazel-bin/release/v2ray-linux-64.zip