MacOS 上安装与配置v2rayA

本教程详细讲解了如何在 Macos 系统上安装并配置 v2rayA 这款科学上网、魔法上网软件。

如果您是 Windows 用户，需要安装 v2ray 客户端可以参考 Windows 上安装与配置 v2rayA - 鹏叔的技术博客。

如果您是 Linux 用户，需要安装 v2ray 客户端可以参考 Linux 上安装与配置v2rayA - 鹏叔的技术博客。

如果您是 Android 用户可以参考教程 Android 上安装与配置 v2rayNG - 鹏叔的技术博客

1. V2Ray 介绍

在正式开始安装之前我们先简要介绍一下 v2rayA 以及其核心 v2ray，以便有一些基本了解，方便理解后续安装和配置过程。如果您对 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 防火墙的全协议节点服务，但它们在速度、安全性和稳定性方面存在差异。

1.2. v2ray 与 VPN 的关系

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

VPN 是虚拟专用网络，它本来是一种组网技术，这种组网技术正好可以用于绕过防火墙的限制。可以将其划归于第二代翻墙技术。

而 Shadowsocks, ShadowsocksR 以及 v2ray 则是因防火墙而生的，其本质上是一种代理上网技术。相较于传统 VPN，它能更好消除数据包中的特征，从而绕过主动或被动 censorship，提供更强的隐私保护。在复杂的网络环境下（如大规模的封锁或干扰）表现更好，可以将其划归于第三代翻墙技术。

虽然同属于第三代翻墙技术， v2ray 这位后起之秀相较于 Shadowsocks 拥有更广泛的协议支持，更高的隐私安全。限于篇幅原因这里不具体展开。

1.3. V2Ray 与 v2rayA 的关系

v2rayA 是一个基于 V2Ray 内核的客户端软件，它支持 Windows、Mac、Linux 等平台。

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 内核

下载过程中如果遇到 github 不能访问的情况，
方法 1：可以通过 github 代理 https://ghfast.top/ 下载
方法 2: 可尝试使用文章-解决 GitHub 访问不了的方法中介绍的方法。

# （Macos only）下载v2ray-core，并保存到tmp目录
$ sudo curl -L https://ghfast.top/https://github.com/v2fly/v2ray-core/releases/download/v5.24.0/v2ray-macos-64.zip -o /tmp/v2ray-macos-64.zip

# 核对文件的指纹信息, 如果与以下输出一致则表示安装文件是安全的，否则请谨慎安装。
# 权威指纹信息可以在github release download 同级目录下找到。
$ openssl dgst -SHA2-256 /tmp/v2ray-macos-64.zip
SHA2-256(/tmp/v2ray-macos-64.zip)= d673e2c363639dc925157aa489a460eb54133045c7a9f7d629b40453d67aeac2


# 解压缩并将文件拷贝到/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/

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

2.2. 安装 v2rayA

# 下载v2raya
sudo curl -L https://ghfast.top/https://github.com/v2rayA/v2rayA/releases/download/v2.2.6.3/v2raya_darwin_x64_2.2.6.3 -o /usr/local/bin/v2raya

# 核对文件的指纹信息, 如果与以下输出一致则表示安装文件是安全的，否则请谨慎安装。
# 权威指纹信息可以在github release download 同级目录下找到。
$ openssl dgst -SHA2-256 /usr/local/bin/v2raya
SHA2-256(/tmp/v2raya_darwin.zip)= 0b3b32fdb0ac121f8a2e9a3e3d42fe27568dea58f3764f0531da24eda1e1d441

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

3. 配置 v2rayA

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

sudo vi /etc/default/v2raya

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

# 确保回环网卡开启了ipv6
sudo sysctl -w net.ipv6.conf.lo.disable_ipv6=0

# 修改/etc/sysctl.conf 回环网卡永久开启ipv6
sudo vi /etc/sysctl.conf 
net.ipv6.conf.lo.disable_ipv6 = 0

4. MacOS 上启动 V2rayA

手动启动 v2rayA 如下

v2raya --lite

选项说明

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

5. 如何使用 v2rayA？

使用 v2rayA 分为以下步骤：

• 首先通过 v2rayA web 管理界面创建一个用于管理 v2rayA 的账号;
• 然后从机场服务商那里获得订阅，并导入订阅;
• 最后连接并启动节点。

完成这些即可畅通无阻的访问外网了。

5.1. 登陆 v2rayA web 管理界面

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

说明：

如果 v2rayA 正常启动（启动有时需要等待几分钟）则会监听在 2017 端口，在所有操作系统上 v2rayA 管理方式都是一致的， 都是通过 WEB 界面进行管理。

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

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

5.2. 创建管理账号

在第一次进入页面时，你需要创建一个管理员账号，请妥善保管你的用户名密码。

如果遗忘，可以使用 sudo v2raya --reset-password 命令重置密码, 重置前先停止 v2raya，详细用法请查看 Troubleshooting - 问题 2。

5.3. 获取机场订阅 url

可以从如下机场服务商列表中获取订阅或节点。

从以上机场服务商列表， 选择一个机场服务商，然后注册账号，购买订阅，通常在“仪表盘 -> 一键订阅”可以获取到订阅 url。

5.4. 导入订阅 url 或 节点 url

根据前面指引获取到订阅 url 后，就可以导入订阅了，详细步骤参考以下截图。

点击导入按钮进入订阅或节点导入界面，推荐使用导入订阅的方式，比较简单方便。

一个订阅下有若干个节点，也可以选择逐个导入一个或多个节点。另外如果是自建服务器，一般不会有订阅 url, 此时可以选择以节点方式导入。

导入订阅如下图所示：

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

5.5. 连接节点

一个订阅多数情况下会包含多个分布在全球各地的不同节点，一旦订阅成功导入就会自动获取到相应的节点信息。

导入订阅 url 后，会看到，节点数量，另外会看到右侧多了一个节点列表标签页。通常在订阅 url 格式正确，订阅没有过期的情况下，我们可以看到节点数量，如果发现节点数量为 0 或很少，通常可能是订阅过期，网络不通，或机场无法访问等情况，建议重新获取并导入订阅并手动点击更新进行更新。如果是网络不通或机场无法访问，可在浏览器打开订阅地址看是否能获取到节点信息。

切换到节点列表标签页，点击相应节点后面的“连接”按钮，可同时连接一个或多个节点，这也是 v2ray 和 V2rayA 与其他代理上网方式相比强大的地方。

说明：

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

如果没有自动获取到节点信息，则可以手动点击订阅右侧的更新按钮，获取节点信息。另外在使用过程中如果节点出现 Timeout 和 not stable，某些情况下可能是节点配置已经过期，此时也可以使用更新按钮更新节点信息，以获得最新的节点配置， 也有可能是流量已经用尽， 选择重置订阅或续期。在设置界面有“自动更新订阅”，设置好合适的更新间隔，以保持节点设置始终处于最新状态。

5.6. 启动节点

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

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

技巧与提示：

步骤 1，勾选一个或多个节点，此时界面上会出现 Ping 和 HTTP 按钮，点击相应按钮测试服务器 ping 值，以及 http 延时，以便快速找到可用节点。

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

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

如果未呈现蓝色即未启动成功，请点击页面右上角点击日志查看问题详情。

另外查看评论区网友遇到过的问题，或许对一些疑难杂症会有所帮助。

节点呈现蓝色是能成功连接外网的基本要求，也即如果不是蓝色肯定连接不了外网，节点呈现蓝色后，还要检查其他要求包括：Ping 值是否正常 和 HTTP 延迟是否正常，具体设置看一参考检查设置章节。

5.7. 检查设置

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

• 如果仍然有不能成功访问外网，可以查看一下日志信息，看是否有错误信息。
  详细的错误日志可以点击网页上的日志按钮查看, 也可以在/var/log/v2raya/下面可以找到日志。

• 有时会因为缓存原因，设置修改后不会立即生效，这时可以重启一下网卡，或者重启一下 v2rayA 服务。

6. 验证设置是否成功？

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

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

7. 进阶用法

7.1. 开启远程管理（可选）

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

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

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

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

# 检查防火墙是否开启
firewall-cmd --state

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

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

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

7.2. V2rayA 如何为其他终端提供代理服务 (配置代理)

如果在局域网内，不仅本机可以访问外网，而且 V2rayA 经过配置后，可以作为代理服务器让局域网内其他设备科学上网。此时 V2rayA 化身为一台代理服务器为其他电脑客户端提供代理（其他电脑无需安装 任何客户端， 使用系统自带的 http，https 或者 socks 代理功能即可）。

默认情况下 v2rayA 会通过 v2ray 内核开放 20170(socks5), 20171(http), 20172(带分流规则的 http) 端口作为代理端口（可以在 v2rayA 设置=>地址与端口 页面查看或修改端口）。

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

完成以上工作，一台代理服务器配置已经完成。

7.2.1. v2rayA 为 linux 或 Macos 终端提供代理

在被代理机器上添加如下两个环境变量即可。

在 linux 或 Macos 操作系统上, 找到环境配置文件，添加如下两行配置.

以 bash 为例，修改~/.bashrc, 添加如下两行配置, 其他 shell 可以自行科普 shell 环境变量配置。

# 修改bash的配置文件
# vi ~/.bashrc
# 将如下两行添加到配置文件.bashrc中
export http_proxy="http://server_ip:20171"
export https_proxy="http://server_ip:20171"

# 配置好以后，在命令行终端运行如下命令，更新配置。
# source ~/.bashrc
# 最后使用查看配置是否生效, 查看 http_proxy和https_proxy 两个变量的值是否正确
# echo $http_proxy
# echo $https_proxy

7.2.2. v2rayA 为 Windows 终端提供代理

在 windows 操作系统上, 打开 Windows 环境变量配置界面，添加如两个环境变量。

http_proxy="http://server_ip:20171"
https_proxy="http://server_ip:20171"

7.2.3. v2rayA 为 Android 终端提供代理

安卓上设置代理上网，讲起了比较复杂，好在有些文章可以参考 例如：安卓如何设置代理 IP？

需要注意的是，在以上教程中，主机名字段替换为 server_ip，端口填入 20172 即可。

7.2.4. v2rayA 为 iOS 终端提供代理

iphone 也可以通过 v2rayA 代理科学上网， 这样可以省去获取美区 ID, 安装小火箭的麻烦。

7.3. 透明代理

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

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

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

7.3.1. 系统代理

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

8. Troubleshooting

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

1. 问题描述

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

2. 问题分析:

   “geosite.dat”：提供一个预定义好的 「全球域名」 列表;
   “geoip.dat” ：提供一个预定义好的 「全球 ip-地区」 列表.

   第一种可能性是可能是根本没有安装任何 v2ray-core, 由于 v2rayA 的 linux 版本和 macos 版本都是不带 v2ray 内核的，如果没有安装内核可能会出现以上错误。

   第二种情况，geosite.dat, geoip.dat 文件没有放到正确的位置。

   由于 v2rayA 不同的版本之间，运行在不同的系统上面，读取配置文件的位置有所不同，也会出现找不到这两个文件的情况。

   解决办法是查看错误日志。手动拷贝这两个文件到相应位置。

3. 解决方案

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

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

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

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

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

重置密码

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

9. 特别说明

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