本文主要讲述如何在 MacOS 上安装 v2rayA。

v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

v2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以参阅 Apple 的官方文档。

建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。

1. 使用 Homebrew 安装

请确保安装了 Homebrew 并工作正常。

1.1. 安装

添加 v2rayA 的 Tap：

1
brew tap v2raya/v2raya

安装 v2rayA:

1
brew install v2raya/v2raya/v2raya

v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。

1.2. 运行

安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

1
brew services start v2raya

2. 手动安装

2.1. 创建目录

这些目录可能已经存在，创建之前请注意检查。

二进制所在目录：

1
sudo mkdir /usr/local/bin/

数据文件所在目录：

1
sudo mkdir -p /usr/local/share/v2ray/

服务文件所在目录：

1
mkdir ~/Library/LaunchAgents/

2.2. 下载 v2rayA

从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

示例：

x86_64:

1
sudo curl -L https://github.com/v2rayA/v2rayA/releases/download/v1.5.7/v2raya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya

arm64:

1
sudo curl -L https://github.com/v2rayA/v2rayA/releases/download/v1.5.7/v2raya_darwin_arm64_1.5.7 -o /usr/local/bin/v2raya

2.3. 下载 V2Ray 核心 / Xray 核心

安装 V2Ray：https://www.v2fly.org/guide/install.html
安装 Xray：https://xtls.github.io/document/install.html

解压压缩包后将其中的文件移动到对应目录：

1
2
sudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/

2.4. 给予权限

给予 v2rayA 与 v2ray 可执行权限：

1
2
3
sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
sudo chmod 755 /usr/local/bin/v2ctl

如果遇到 macOS 的安全限制，那么需要运行以下命令：

1
sudo xattr -d -r com.apple.quarantine  /usr/local/bin/*

2.5. 建立服务文件

新建服务文件并保存到 ~/Library/LaunchAgents/

示例：

1
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
      <key>EnvironmentVariables</key>
      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
            <string>/usr/local/bin/v2ray</string>
      </dict>
      <key>KeepAlive</key>
      <true/>
      <key>Label</key>
      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
      <array>
            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
      </array>
      <key>RunAtLoad</key>
      <true/>
</dict>
</plist>

2.6. 运行

1
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist

如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。

3. v2rayA 使用方法

安装并成功启动v2rayA服务后，可以使用浏览器直接访问 http://127.0.0.1:2017 v2rayA管理页面, 具体使用方法可以访问 v2rayA 基本使用方法