Linux客户端

v2rayA—适用于Linux的代理程序客户端。

v2rayA 致力于提供最简单的操作,满足绝大部分需求。

v2rayA

v2rayA是在Linux官方内核的基础上,为大家提供了Web GUI,可以更直观的进行V2ray各项操作,可用于电脑、路由器、NAS等Linux平台设备。

安装

  • 从软件源安装
    • debian/ubuntu
    • archlinux/manjaro
  • Docker方式
    • docker命令
  • 二进制文件、安装包
  • 自行编译运行
  • 在NAS或路由器使用
    • daemon
    • docker
    • 通用方法
  • 安装完毕后如何使用
  • 环境变量

从软件源安装

debian/ubuntu

请确保已正确安装 v2ray-core

我们提供了 Linux 下的一键安装脚本:

运行下面的指令下载并安装 V2Ray。当 yum 或 apt-get 可用的情况下,此脚本会自动安装 unzip 和 daemon。这两个组件是安装 V2Ray 的必要组件。如果你使用的系统不支持 yum 或 apt-get,请自行安装 unzip 和 daemon

# download script
curl -O https://cdn.jsdelivr.net/gh/v2rayA/[email protected]/install/go.sh

# install v2ray-core from jsdelivr
sudo bash go.sh

准备完毕后:

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

# add V2RayA's repository
echo "deb https://apt.v2raya.mzz.pub/ v2raya main" | sudo tee /etc/apt/sources.list.d/v2raya.list
sudo apt update

# install V2RayA
sudo apt install v2raya

部署完毕后,访问该机器的2017端口即可使用,如http://127.0.0.1:2017/

archlinux/manjaro

v2raya已发布于AUR中:

# install v2ray
sudo pacman -Sy v2ray

# install v2raya
git clone https://aur.archlinux.org/v2raya.git /tmp/v2raya
cd /tmp/v2raya
makepkg -si

如果makepkg失败,运行sudo pacman -S base-devel后再试。

如果通过archlinuxcn源安装,需要运行systemctl enable --now v2raya

部署完毕后,访问该机器的2017端口即可使用,如http://127.0.0.1:2017/

Docker方式

docker命令

仅使用 docker 命令部署。

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

部署完毕后,访问该机器的2017端口即可使用,如http://127.0.0.1:2017/


如果你使用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

部署完毕后,访问该机器的2017端口即可使用,如http://127.0.0.1:2017/

二进制文件、安装包

请确保已正确安装 v2ray-core

我们提供了 Linux 下的一键安装脚本:

运行下面的指令下载并安装 V2Ray。当 yum 或 apt-get 可用的情况下,此脚本会自动安装 unzip 和 daemon。这两个组件是安装 V2Ray 的必要组件。如果你使用的系统不支持 yum 或 apt-get,请自行安装 unzip 和 daemon

# download script
curl -O https://cdn.jsdelivr.net/gh/v2rayA/[email protected]/install/go.sh
# install v2ray-core from jsdelivr
sudo bash go.sh

准备完毕后,可下载Releases中的二进制文件启动V2RayA服务端,或下载安装包进行安装。

部署完毕后,访问该机器的2017端口即可使用,如http://127.0.0.1:2017/

自行编译运行

当然,你也可以选择拉取源码,编译为二进制文件运行:

该方法同样需要正确安装v2ray-core,详情见上

git clone https://github.com/v2rayA/V2RayA.git
cd V2RayA/service
# set goproxy.io as the proxy of go modules
export GOPROXY=https://goproxy.io
# compile
go build -o v2raya
# run
sudo ./v2raya

注意,尽管 golang 具有交叉编译的特性,但由于项目使用了大量 linux commands,导致该方法仍然不支持 windows。若想在 windows 体验,可尝试借助 Docker 或 WSL。

在NAS或路由器使用

分为以下几种情况:

daemon

v2ray能够以daemon存在即在正确安装v2ray后,使用下述命令之一能够得到正确的反馈:

# if systemctl is available
systemctl status v2ray
# else if service is available
service v2ray status

那么可从软件源安装,或下载releases中的对应安装包进行安装。

docker

若v2ray能够运行于docker,则可参照Docker方式使用

通用方法

  1. 请自行安装v2ray,并确保v2ray、v2ctl均被包含在PATH中,否则请将上述文件放于echo $PATH中的任一目录下。

  2. 下载releases中最新版本的对应CPU架构的二进制文件,或自行使用golang交叉编译。

  3. 使用参数--config=V2RAYA_CONFIG_PATH --mode=universal启动V2RayA服务端,参数含义可执行--help查看。

    请将上述V2RAYA_CONFIG_PATH替换为一个可读写的,并且你喜欢的路径。

安装完毕后如何使用

如果v2rayA正常运行(启动或许需要一定时间)则开放2017作为管理端口,通过浏览器访问即可进行管理。

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

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

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

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

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

环境变量

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: 重设密码

常见问题

  1. 使用软件源安装后,如何手动控制v2raya服务端的启动?

    # 开机自启/取消自启/启动服务/停止服务/重启服务/查看状态
    systemctl enable/disable/start/stop/restart/status v2raya
    # 查看日志
    journalctl -u v2raya

    如果不存在systemctl命令,使用service命令,如service v2raya restart

  2. 忘记密码或是想修改密码怎么办?

    sudo v2raya --reset-password
  3. 怎样才能使docker流量也走代理?

    开启增强模式即可(打开DNS防污染后即可出现该选项,v0.7.1.1+)

    增强模式下会代理全部TCP流量,包括docker的流量,但不会代理UDP流量,防止dns污染将通过拦截受污染域名并远程解析实现。

  4. v2rayA部署在远端服务器,开启全局透明代理后ssh连接不上了?

    开启增强模式即可(打开DNS防污染后即可出现该选项,v0.7.1.1+)

  5. 开启全局透明代理后ping google.com显示依然不通?

    v2ray不代理icmp流量,请使用curl -v google.com检查连通性