使用方法

• 安装 V2Ray 内核 / Xray 内核
  • 使用 systemd 的 Linux 发行版
  • Alpine Linux
  • Arch Linux 以及它的衍生版
• 安装 v2rayA
  • Debian 系列安装
  • RedHat(CentOS) / openSUSE 系列安装
  • Alpine Linux
  • Arch Linux 以及它的衍生版
  • OpenWRT
  • Docker 方式
• 安装完毕后如何使用
• 使用其他类 V2Ray 核心
  • systemd 方案
  • Alpine Linux ── OpenRC 方案
• 环境变量

安装 V2Ray 内核 / Xray 内核

使用 systemd 的 Linux 发行版

V2Ray 安装参考：https://github.com/v2fly/fhs-install-v2ray

也可以使用我们提供的支持 jsdelivr 镜像的脚本以加速安装：

# download script
curl -O https://cdn.jsdelivr.net/gh/v2rayA/v2rayA@master/install/go.sh
# install v2ray-core from jsdelivr
sudo bash go.sh

Xray 安装参考：https://github.com/XTLS/Xray-install

---

安装后可以关掉服务，因为v2rayA不依赖于该systemd服务。

sudo systemctl disable v2ray --now ### Xray 需要替换服务为 xray

Alpine Linux

V2Ray 安装参考：https://github.com/v2fly/alpinelinux-install-v2ray

Xray 安装参考：https://github.com/XTLS/alpinelinux-install-xray

Arch Linux 以及它的衍生版

从官方源安装 v2ray，或者从 AUR 安装 xray 或 xray-bin。

安装 v2rayA

Debian 系列安装

方法一：通过软件源安装

添加公钥

wget -qO - https://apt.v2raya.mzz.pub/key/public-key.asc | sudo apt-key add -

添加 V2RayA 软件源

echo "deb https://apt.v2raya.mzz.pub/ v2raya main" | sudo tee /etc/apt/sources.list.d/v2raya.list
sudo apt update

安装 V2RayA

sudo apt install v2raya

方法二：手动安装 deb 包

下载 deb 包后可以使用 Gdebi、QApt 等图形化工具来安装，也可以使用命令行：

sudo apt install /path/download/installer_debian_xxx_vxxx.deb ### 自行替换 deb 包所在的实际路径

RedHat(CentOS) / openSUSE 系列安装

下载 rpm 包后运行：

sudo rpm -i /path/download/installer_redhat_xxx_vxxx.rpm ### 自行替换 rpm 包所在的实际路径

Alpine Linux

1. 根据你的平台，从 Release 获取具有 v2raya_linux_xxx 字样的无后缀名文件，并将其重命名为 v2raya，再把 v2raya 移动到 /usr/local/bin 并给予可执行权限。

   示例：

   wget https://github.com/v2rayA/v2rayA/releases/download/v1.4.1/v2raya_linux_amd64_v1.4.1 -O v2raya && sudo mv ./v2raya /usr/local/bin/ && sudo chmod +x /usr/local/bin/v2raya
   

2. 下载 v2rayA 的 Web 页面，然后保存到/usr/local/etc/v2raya/web。

   示例：

   wget https://github.com/v2rayA/v2raya-web/archive/refs/heads/master.zip && unzip master.zip && sudo mkdir -p /usr/local/etc/v2raya/web && sudo mv -r ./v2raya-web-master/* /usr/local/etc/v2raya/web

3. 在 /etc/init.d/ 目录下面新建一个名为 v2raya 的文本文件，然后编辑，添加内容如下：

   #!/sbin/openrc-run
   
   name="v2rayA"
   description="A Linux web GUI client of Project V which supports V2Ray, Xray, SS, SSR, Trojan and Pingtunnel"
   command="/usr/local/bin/v2raya"
   command_args=""
   pidfile="/run/${RC_SVCNAME}.pid"
   command_background="yes"
   
   depend() {
   	need net
   }

4. 保存文件，然后给予此文件可执行权限。

5. 安装 iptables 与 ip6tables 这两个包。

6. 运行 v2rayA 服务：rc-service v2raya start。

7. 添加开机运行服务：rc-update add v2raya。

Arch Linux 以及它的衍生版

从 AUR 安装 v2raya 或 v2raya-bin 即可。

OpenWRT

openwrt

Docker 方式

使用 docker 命令部署。

# run v2raya
docker run -d \
	--restart=always \
	--privileged \
	--network=host \
	--name v2raya \
	-e V2RAYA_ADDRESS=0.0.0.0:2017 \
        -v /lib/modules:/lib/modules \
	-v /etc/resolv.conf:/etc/resolv.conf \
	-v /etc/v2raya:/etc/v2raya \
	mzz2017/v2raya

---

如果你使用 MacOSX 或其他不支持 host 模式的环境，在该情况下无法使用全局透明代理，或者你不希望使用全局透明代理，docker 命令会略有不同：

# run v2raya
docker run -d \
	-p 2017:2017 \
	-p 20170-20172:20170-20172 \
	--restart=always \
	--name v2raya \
	-v /etc/v2raya:/etc/v2raya \
	mzz2017/v2raya

安装完毕后如何使用

如果 v2rayA 正常运行（启动或许需要一定时间）则开放 2017 作为管理端口，通过浏览器访问即可进行管理。如访问 http://localhost:2017/

• 导入并连接正常工作的节点后，设置全局透明代理即可使用。

• 如果不使用全局透明代理，可使用浏览器插件如 SwitchyOmega 通过下述端口进行代理：

  默认情况下开放三个代理端口：20170(socks5)、20171(http)、20172(带分流规则的 http)

• 或使用桌面环境提供的系统代理进行达到类似全局代理的效果。

• 注意，如果通过 archlinuxcn 源安装，需要运行systemctl enable --now v2raya。

使用其他类 V2Ray 核心

一般而言 v2rayA 会优先选择 v2ray，其次是 xray。如需切换到 xray，卸载 v2ray 即可。

如果使用其他暂不主动支持的类 v2ray 核心，参考以下方法。

systemd 方案

1. 新建文件夹 /etc/systemd/system/v2raya.service.d，然后新建一个 xray.conf 的文件，添加以下内容：

   [Service]
   Environment="V2RAYA_V2RAY_BIN=/usr/local/bin/xray"
   

   注意检查 Xray 的路径是否正确。

2. 重载服务：

   sudo systemctl daemon-reload && sudo systemctl restart v2raya
   

Alpine Linux ── OpenRC 方案

修改 /etc/init.d/v2raya，然后在 command_args="" 的内容里面加上 --v2ray-bin=/usr/local/bin/xray（注意--v2ray-bin之前可能需要空格），再重启服务即可。

环境变量

V2RAYA_ADDRESS: 监听地址 (默认 "0.0.0.0:2017")

V2RAYA_CONFIG: v2rayA 配置文件目录 (默认 "/etc/v2raya")

V2RAYA_V2RAY_BIN: v2ray 可执行文件路径. 留空将自动检测. 可修改为 v2ray 分支如 xray 等文件路径

V2RAYA_V2RAY_CONFDIR: 附加的 v2ray 配置文件目录, 该目录中的 v2ray 配置文件会与 v2rayA 生成的配置文件进行组合

V2RAYA_WEBDIR: v2rayA 前端 GUI 文件目录 (默认 "/etc/v2raya/web")

V2RAYA_PLUGINLISTENPORT: v2rayA 内部插件端口 (默认 32346)

V2RAYA_PASSCHECKROOT: 跳过 root 权限检测, 确认你有 root 权限而 v2rayA 判断出错时使用

V2RAYA_VERBOSE: 详细日志模式，混合打印 v2ray-core 和 v2rayA 的运行日志

V2RAYA_RESET_PASSWORD: 重设密码