2024最新 v2rayA 安装与配置教程

本教程详细讲解了如何在Windows, debian 系列和 redhat 系列 Linux 操作系统, 以及 Macos 系统上安装并配置 v2rayA 这款科学上网软件。

由于本文涵盖的范围较广,虽然已经做了精简,篇幅仍然偏长。针对具体的操作系统,有些与您的系统不相关的操作步骤可以快速略过。

1. V2Ray 介绍

V2Ray 是一个支持多种协议的代理上网软件,它可以使用多种协议进行数据传输,包括 VMess、Trojan、Shadowsocks 等,是 Victoria Raymond 以及其社区团队开发的 Project V 下的代理上网软件。Project V 是一个工具集合,号称可以帮助其使用者打造专属的基础通信网络。Project V 的核心工具称为 V2Ray,其主要负责网络协议和功能的实现,与其它 Project V 通信。V2Ray 可以单独运行,也可以和其它工具配合,以提供简便的操作流程。开发过程主要使用 Go 语言,Core 采用 MIT 许可证并开放源代码。

VMess 是 V2Ray 的核心协议, 也是 V2Ray 的默认协议,是 V2Ray 的主要开发方向。VMess 具有较高的性能、安全性和抗封锁能力。

1.1. 什么是梯子?

梯子又叫做机场是一种网络服务商,专门提供翻墙服务或者说魔法上网服务,如 Shadowsocks、V2ray、Trojan、Hysteria 等翻墙协议的节点服务器。它们之所以称为机场,是因为这些服务最初使用的 Shadowsocks (简称SS) 和 ShadowsocksR (简称SSR) 协议,其客户端图标是一架纸飞机。用户通过将这些节点服务器订阅文件输入到飞机(即Shadowsocks客户端)中,从而实现绕过网络封锁达到魔法上网的目的。

目前,大多数机场能够提供针对GWF防火墙的全协议节点服务,但它们在速度、安全性和稳定性方面存在差异。总的来说,机场提供了一种特殊的、加密的上网方式,相对比VPN更适合中国大陆科学上网和翻墙使用,梯子工具长期提供外网加速器科学上网梯子推荐。

1.2. v2rayA 与 VPN 的关系

v2rayA 和 VPN 都是可以用于保护您的在线隐私和安全的工具。但是,它们的工作方式不同,并且具有不同的优势和劣势。

VPN 是虚拟专用网络属于第二代翻墙技术,Shadowsocks 属于第三代翻墙技术,v2ray 是一种代理服务,是比 Shadowsocks 更现代的翻墙技术、拥有更灵活的协议,它提供更广泛的功能和选项。限于篇幅原因这里不具体展开。

1.3. V2Ray 与 v2rayA 的关系

v2raya 是一个基于 V2Ray 内核的客户端软件,它支持 Windows、Mac、Linux、Android 等平台。v2raya 的功能非常强大,可以根据用户的需求进行自定义配置。

1.4. V2Ray 与 Xray 的关系

2020 年 11 月,因为开源许可证等原因 XTLS 被 V2Ray 社区从 V2ray core 移除,VLESS 及 XTLS 的作者和支持者基于 V2Ray 另行组建了 Project x 组织,开发了基于 V2Ray 的衍生版本 Xray。该软件完全兼容 V2Ray 的配置文件和传输协议。

1.5. V2Fly 与 V2Ray 的关系

由开源社区 v2ray/v2ray-core 原作者失踪后,其他维护者没有完整权限,为了方便维护,社区创建了新的 organization:github.com/v2fly。

2. 安装 v2rayA

安装过程分为以下几个步骤:

  • 首先安装 v2ray 内核
  • 然后安装 v2rayA(客户端),
  • 配置 v2rayA
  • 以及节点配置和连接。

2.1. 安装 v2ray-core 内核(windows 系统可跳过此步骤)

因为 Windows v2rayA Installer 自带了 v2ray 内核,对于 Windows 系统可以跳过内核安装这一步骤。

对于 Linux 和 macOS 操作系统则仍然需要先安装 v2ray-core 内核

2.1.1. 下载 v2ray-core

从 github 下载 v2ray core

安装过程中如果遇到 github 不能访问的情况,

方法1:可以通过github代理 https://ghproxy.net/ 下载

例如:

https://ghproxy.net/https://github.com/v2fly/v2ray-core/releases/download/v5.13.0/v2ray-linux-64.zip

方法2: 可尝试使用文章-解决 GitHub 访问不了的方法中介绍的方法。

2.1.2. Linux 上安装 v2ray 内核

1
2
3
4
5
6
7
8
9
10
11
12
13

## 下载v2ray-core,并保存到tmp目录
wget -O /tmp/v2ray-linux-64.zip https://ghproxy.net/https://github.com/v2fly/v2ray-core/releases/download/v5.13.0/v2ray-linux-64.zip
## 或者
# 如果操作系统上安装了curl, 可以使用curl下载
curl --output /tmp/v2ray-linux-64.zip https://ghproxy.net/https://github.com/v2fly/v2ray-core/releases/download/v5.13.0/v2ray-linux-64.zip
# 将其解压到/usr/local/v2ray-core, 需要root权限
sudo unzip /tmp/v2ray-linux-64.zip -d /usr/local/v2ray-core

# 有用户反馈在kali系统系统中,实际使用的geoip.dat和geosite.dat位于/usr/local/share/v2ray/
# 所以如果有必要可以拷贝一份dat文件到/usr/local/share/v2ray/
sudo mkdir -p /usr/local/share/v2ray/
sudo mv /usr/local/v2ray-core/*dat /usr/local/share/v2ray/

2.1.3. Macos 上安装 v2ray 内核

1
2
3
4
5
6
7
8
9
10
11
12
13

# (Macos only)下载v2ray-core,并保存到tmp目录
sudo curl -L https://ghproxy.net/https://github.com/v2fly/v2ray-core/releases/download/v5.13.0/v2ray-macos-64.zip -o /tmp/v2ray-macos-64.zip

# 解压缩并将文件拷贝到/usr/local下的相应目录

unzip /tmp/v2ray-macos-64.zip -d /tmp/v2ray-core
sudo mv /tmp/v2ray-core/v2ray /usr/local/bin/
sudo mv /tmp/v2ray-core/*dat /usr/local/share/v2ray/

# 授予可执行权限
sudo chmod 755 /usr/local/bin/v2ray

2.2. 安装 v2rayA

2.2.1. Linux Debian 系列安装 v2rayA

对于 debian 系列发行版(Ubuntu, Mint, MX, Kubuntu, Zorin 等等)

使用命令行安装:

1
2
3
4
5
6
7
# 下载debian安装包, 针对不同的硬件架构以下下载命令稍做调整即可.
# 所有安装包可以在这里找到https://github.com/v2rayA/v2rayA/releases/
wget -O /tmp/installer_debian_x64_2.2.4.6.deb https://ghproxy.net/https://github.com/v2rayA/v2rayA/releases/download/v2.2.4.6/installer_debian_x64_2.2.4.6.deb

# 安装v2rayA
sudo apt install /tmp/installer_debian_x64_2.2.4.6.deb

2.2.2. Linux Redhat 系列安装 v2rayA

对于 Redhat 系列发行版(Centos, Fedora, AlmaLinux, Rocky Linux 等)

1
2
3
4
5
6
7
8
9

# 使用wget下载rpm包
wget -O /tmp/installer_redhat_x64_2.2.4.6.rpm https://ghproxy.net/https://github.com/v2rayA/v2rayA/releases/download/v2.2.4.6/installer_redhat_x64_2.2.4.6.rpm

# 或者使用curl下载
curl https://ghproxy.net/https://github.com/v2rayA/v2rayA/releases/download/v2.2.4.6/installer_redhat_x64_2.2.4.6.rpm -output /tmp/installer_redhat_x64_2.2.4.6.rpm

# 安装
sudo rpm -i /tmp/installer_redhat_x64_2.2.4.6.rpm

2.2.3. MacOS 上安装 v2rayA

对于 MacOS 操作系统

1
2
3
4
5
6

# 下载v2raya
sudo curl -L https://ghproxy.net/https://github.com/v2rayA/v2rayA/releases/download/v2.2.4.6/v2raya_darwin_x64_2.2.4.6 -o /usr/local/bin/v2raya
# 授予可执行权限
sudo chmod 755 /usr/local/bin/v2raya

2.2.4. Windows 上安装 v2rayA

对于 Windows 操作系统

1
2
3
4
5
6
7
# 打开powershell, 普通用户权限即可, 执行以下命令下载V2raya安装文件,安装文件将会被保存在用户的下载目录下
# 执行下载命令会弹出警告框,因为下载的是.exe文件,点击允许即可开始下载。
powershell -c "invoke-webrequest -uri https://ghproxy.net/https://github.com/v2rayA/v2rayA/releases/download/v2.2.4.6/installer_windows_inno_x64_2.2.4.6.exe -outfile Downloads\installer_windows_inno_x64_2.2.4.6.exe"

# 下载完成后,开始安装
Start-Process -FilePath "Downloads\installer_windows_inno_x64_2.2.4.6.exe" -ArgumentList "/silent"

2.2.5. Android 手机上安装与配置 v2rayNG

Android 上安装 v2ray 客户端,可参考这篇文章Android 手机上安装与配置 v2rayNG

3. 配置 v2rayA (windows 可跳过此步骤)

因为在 Windows 上,安装程序默认设置了 v2rayA 与内核的关联,所以可以跳过以下配置过程

3.1. 配置 v2rayA

修改/etc/default/v2raya配置文件让 v2raya 使用 v2ray-core

1
2
3
4
5
6
7
8

# vi /etc/default/v2raya

# 将V2rayA和v2ray-core关联起来
# 添加配置两行配置
V2RAYA_V2RAY_BIN=/usr/local/v2ray-core/v2ray
V2RAYA_V2RAY_CONFDIR=/usr/local/v2ray-core

3.2. 设置开机启动

3.2.1. Windows 操作系统上设置 V2rayA 开机自启

windows 可跳过此步骤, Window v2rayA Installer 安装过程中已经自动完成了这些设置

3.2.2. Linux 操作系统上设置 V2rayA 开机自启

1
2
3
4
5
6
7

# --now 参数表示设置为开机启动并立即启动v2raya
sudo systemctl enable --now v2raya
# 查看服务状态
systemctl status v2raya


3.2.3. MacOS 上启动 V2rayA

手动启动 v2raya 如下

1
v2raya --lite

选项说明

–lite: 非 root 用户只能在 lite 模式下启动 v2raya, 如果是 root 用户可以不带该选项

4. 如何使用 v2rayA?

使用 v2rayA 一些步骤:

  • 首先需要通过 v2rayA web 管理界面创建一个用于管理 v2rayA的账号,
  • 然后需要导入从“机场”服务商列表获得订阅,
  • 最后连接并启动节点。

完成这些即可畅通无阻的访问外网了。以下为详细步骤

4.1. 登陆 v2rayA web 管理界面

在浏览器中打开 v2rayA web 管理界面 http://localhost:2017/

说明:
如果 v2rayA 正常启动(启动有时需要等待几分钟)则会监听在 2017 端口,所有操作系统的管理方式都是一致的, 都是通过 WEB 界面进行管理。如访问 http://localhost:2017/

许多服务器是没有安装 Linux 桌面的,无法在主机上使用浏览器进行访问,此时需要远程管理 v2raya,开启远程管理参考本文 进阶用法 -> 开启远程管理章节。

Macos 上不要用 safari 浏览器打开可换其它浏览器,例如使用 chrome 打开,v2rayA GUI 对 safari 支持不太好,可能会出现白屏的情况。

4.2. 创建管理账号

v2raya create an account

在第一次进入页面时,你需要创建一个管理员账号,请妥善保管你的用户名密码,如果遗忘,可以使用 sudo v2raya --reset-password 命令重置密码。

4.3. 获取机场订阅 url

初次使用可以在如下机场服务商列表中获取订阅或节点,等熟悉整个机制之后可以采用海外vps自建v2ray节点,

以上列表提供的都是精选的,稳定的,高质量的机场。

说明:

  1. 如果要使用ChatGPT, 需要注意以下两点

a) 选择机场服务提供商时选择支持ChatGPT的服务提供商例如星辰VPN,宝贝云,这种资源目前非常稀缺,实测以上机场服务商列表中“星辰VPN”的新加坡节点(截至2024-03-06)支持得很好,宝贝云的美国节点(截至2024-04-20)。
b) 需要将设置->透明代理/系统代理实现方式 修改为tproxy。 参考章节 4.7. 检查设置。

  1. 节点(科学上网代理服务器)也叫机场,为什么会被称为机场?Shadowsocks(SS)是最早的科学上网协议,它的 logo 是架纸飞机,使用 SS 协议搭建起来的代理服务器就被称为“机场”, 虽然现在已经有了更多上网协议可以用于搭建节点,机场仍然是节点的代名词。

4.4. 导入订阅 url 或 节点 url

根据以上指引获取到订阅 url 或节点 url 后,就可以导入订阅了,详细步骤参考以下截图。

点击导入按钮进入订阅或节点导入界面

import servers

可以选择导入订阅,导入订阅地址如下图所示:

import subscription

订阅 URL 类似这样子: https://xxx.xxxx.com/api_version2/xxxxxxxx?sub=3&extend=1

节点 URL 类似这样子:

1
2
3
4
5

vmess://ew0KICAxxxxxxxxxxbGN85bm/5pawMDJ8MS4xxxxxxxBsYy1zZy5nZXR4bHgu
trojan://224253xxxxxx210fca@xxxxp:10060#xxxxxx
ss://xxxxxxxx=@service.xxxxx.com:50003#xxxxxxx%82%2B%E7%A7%BB%E5%8A%A8

4.5. 连接节点

连接节点

subscrible server

更新成功后,节点将显示在相应订阅的节点列表标签页。如上图所示成功导入了一个订阅后的界面。

connect server

切换到节点列表标签页,点击相应节点后面的“连接”按钮,可同时连接一个或多个节点,这也是 v2ray 和 V2rayA 强大的地方。

说明:

虽然可以同时连接多个节点,但是这里不建议选择过多的节点,6 个以内为佳。

4.6. 启动节点

导航到 SERVER 或订阅服务器 TAB 页,选择一个或多个节点后,启动该服务器。

connect server

连接成功后节点变为蓝色,如下图所示:

connect to server successfully

小技巧提示:

步骤 1(可选), 在连接服务器时,先使用 Ping 和 HTTP 命令测试一下服务器的状态,以及延时情况,以便快速找到可用节点。

步骤 2, 选择节点,在每个节点右侧有一个选择按钮,点击选择按钮选中节点,此时节点呈现柚红色,因为还未启动它们。

步骤 3,在页面左上角有个“就绪”按钮启动节点,启动成功节点呈现蓝色。

如果启动出现问题,可以点页面右上角点击日志查看问题详情。

4.7. 检查设置

有时候节点已经正常启动已经呈现蓝色,但是仍然不能正常访问某些网站,这可能与具体设置有关系。
此时可以参照下图推荐的设置进行调整,基本能成功访问。

connect server

防止 DNS 污染可以选择: 关闭

5. 验证设置是否成功

如果是 Linux 桌面, 可以打开浏览器访问https://www.google.com, 如果能成功访问则表示连接成功.

如果是在命令行下, 可以运行如下命令访问 google. 如果能看到从 google 传输过来的内容, 则表示成功.

1
2
3
4
5

# 使用命令访问google

curl https://www.google.com

至此在单台主机上已经可以科学上网了,下面是一些进阶用法,如有需要可以参考。

6. 进阶用法

6.1. 开启远程管理(可选)

如果要远程管理 v2raya 服务,需要放行 2017 端口,如果不需要远程管理 v2ray 可以忽略本节以下设置

远程端口以及 ip 依然在 vi /etc/default/v2raya 中配置

1
2
# 修改varaya 监听地址和端口
V2RAYA_ADDRESS=0.0.0.0:2017

执行以下命令检查防火墙设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 检查防火墙是否开启
firewall-cmd --state

# 查看当前开放的端口
firewall-cmd --list-ports

# 放行v2raya端口
firewall-cmd --permanent --add-port=2017/tcp
# 刷新防火墙配置
firewall-cmd --reload

# 查看v2raya服务是否监听在端口上
netstat -tunlp | grep 2017
# 或者使用lsof命令
lsof -i -nP | grep v2raya

6.2. 配置代理

如果在局域网内,不仅本机可以访问外网,而且可以作为代理服务器让局域网内其他设备访问外网。

由于默认情况下 v2rayA 会通过核心开放 20170(socks5), 20171(http), 20172(带分流规则的 http) 端口。可以在设置=>地址与端口 页面修改端口.

如果是需要为局域网中的其他机器提供代理,请在设置中打开“局域网共享”,并检查防火墙开放情况。开启防火墙参考前面章节 - 开启远程管理

这里记录三种方式使用代理。

6.2.1. 透明代理

connect server

这种方法是 v2rayA 推荐的方法。它相比于其他方法具有诸多优势,v2rayA 可以一键开启透明代理,为几乎所有程序提供代理服务。

在设置中选择透明代理的分流方式,以及实现方式,然后保存即可。

注意,如需选择 GFWList,需要下载对应的规则库,请点击右上角的更新以完成下载。

6.2.2. 系统代理

系统代理可为主动支持代理的程序提供代理服务。在不同的桌面环境中设置的位置不尽相同,请通过搜索引擎自行搜索。

6.2.3. SwitchyOmega

SwitchyOmega 等浏览器插件可为浏览器提供代理服务。具体方法请通过搜索引擎自行搜索。

7. 关联阅读

windows 下 v2rayN 安装与配置

Android 手机上安装与配置 v2rayNG

frp 内网穿透

使用 WireGuard 内网穿透

8. Troubleshooting

8.1. 问题 1: 检测到 geosite.dat, geoip.dat 文件或 v2ray-core 可能未正确安装,请检查

  1. 问题描述

访问 http://your_server_ip:2017/时, 系统弹出提示”检测到 geosite.dat, geoip.dat 文件或 v2ray-core 可能未正确安装,请检查”

  1. 问题排查:

参考https://github.com/v2rayA/v2rayA/issues/510

https://github.com/v2rayA/v2rayA/issues/870

使用命令查询安装了哪些包? 发现 v2raya 根本就没有带 v2ray-core 核心的任何文件, 因此会报错缺少 geosite.dat, geoip.dat.
其根本原因是缺了整个 v2ray 核心.

1
dpkg-query -L v2raya

output

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/etc
/etc/default
/etc/default/v2raya
/usr
/usr/bin
/usr/bin/v2raya
/usr/share
/usr/share/icons
/usr/share/icons/hicolor
/usr/share/icons/hicolor/512x512
/usr/share/icons/hicolor/512x512/apps
/usr/share/icons/hicolor/512x512/apps/v2raya.png
/usr/share/applications
/usr/share/applications/v2raya.desktop
/usr/share/doc
/usr/share/doc/v2raya
/usr/share/doc/v2raya/changelog.gz
/usr/lib
/usr/lib/systemd
/usr/lib/systemd/system
/usr/lib/systemd/system/v2raya.service
/usr/lib/systemd/user
/usr/lib/systemd/user/v2raya-lite.service
  1. 解决方案

    参照安装 v2ray-core 章节将 v2ray-core 安装配置好

    再次访问 v2ray web ui, 错误消失.

    如果仍然有问题,可以将安装 v2ray core 时自带了一份 geosite.dat, geoip.dat 文件,只是不是最新数据,但是仍然可用,将其拷贝到相应位置即可。

    最新数据位于https://github.com/v2rayA/dist-v2ray-rules-dat
    可以直接下载也可以通过github代理 https://ghproxy.net/ 下载

8.2. 问题 2: 忘记了 v2rayA 的用户名和密码怎么办?

重置密码

1
2
3
4
5
6
7
8

# 关闭v2raya服务
systemctl stop v2raya
# 重置密码
v2raya --reset-password
# 启动服务
systemctl stop v2raya

9. 特别说明

工具本无善恶, 正与邪取决与使用工具的人, 主体是人. 请将工具用于正道, 切莫用于邪道给自己带来灾殃. 最后如果你能成功访问某tube, 一篇关于安全方面的知识的值得首先了解一下.

转载会给您带来不必要的麻烦, 所以本文禁止转载.