苹果 macOS 电脑安装 v2rayA 客户端教程

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。

) g% C" T3 |  _. z! P& c2 wmacOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
' v  }8 p6 {* O) y8 E$ Z; y' Nv2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

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

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

, O" V& l% N" m- @& _4 S. G使用 Homebrew 安装
. x' f: X  r1 ^4 t请确保安装了 Homebrew 并工作正常。
" A; C' o# j* }# i, f) B
安装
$ V! A) Z- ]7 R, |3 x3 j添加 v2rayA 的 Tap：
9 i/ w) P4 m3 I- M
3 ]/ E* d! G6 M5 ^4 G" n1 f- Abrew tap v2raya/v2raya
+ j9 V: a( s0 l1 J安装 v2rayA:
1 f: h( h2 O6 |' V
. Z4 i4 i& i/ {brew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。

; {5 W  ~; F5 y1 T; a运行
安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

brew services start v2raya
手动安装
创建目录
这些目录可能已经存在，创建之前请注意检查。
; p2 X. x6 D- A- _1 C
二进制所在目录：
' E" A  y% e* X7 ^% _
sudo mkdir /usr/local/bin/
数据文件所在目录：

% Z- r6 ~1 ^8 ?) Y% qsudo mkdir -p /usr/local/share/v2ray/
- ~! F: B% _% z服务文件所在目录：

* v( G1 M& z" bmkdir ~/Library/LaunchAgents/
下载 v2rayA
8 x0 E, \4 O' R8 t" ]* v从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。
# u! N) R# |! r
示例：

/ C& u) \7 T: w1 a5 Bx86_64:

- E8 T5 C' y* [3 u* J% d8 D4 Esudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
3 z9 }  I# O: V( z. G9 Barm64:
2 p9 r2 d6 f" s% R* X
sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html
$ [4 ]3 u) W7 R! c+ x4 W
9 }; X, o% M1 L解压压缩包后将其中的文件移动到对应目录：

sudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/
( d* l2 V$ ^2 _0 J; m: k6 k1 h7 ]给予权限
给予 v2rayA 与 v2ray 可执行权限：
, }' |' d7 i. c" H; M
sudo chmod 755 /usr/local/bin/v2raya
0 V2 ?# Q  t: w+ E6 ~1 \9 J' bsudo chmod 755 /usr/local/bin/v2ray
) s6 `/ A5 X, i% z; a. rsudo chmod 755 /usr/local/bin/v2ctl
如果遇到 macOS 的安全限制，那么需要运行以下命令：

& O1 B5 F/ P# T3 V9 Q" h7 m& p4 Qsudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/
& A- c: S  L$ a5 k
示例：
; E3 L( u! v5 V- I  [
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
# b6 U' v* W9 B8 S内容如下：

<?xml version="1.0" encoding="UTF-8"?>
4 _9 e8 T. D# o  |- Q% z/ U<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
8 t" ^& i. p# m  I2 b. A/ X<plist version="1.0">
4 r' `8 \/ Z* x2 \$ s* K<dict>
      <key>EnvironmentVariables</key>
1 s; v7 S  u- I& [. p- e; a+ z) |      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
! v: r% H" {  E0 w0 u            <key>V2RAYA_V2RAY_BIN</key>
( [: {" G9 n9 k. p8 q# s4 ^            <string>/usr/local/bin/v2ray</string>
. O( y. B+ s. X: T      </dict>
      <key>KeepAlive</key>
- l3 D# h; W1 V& D! C7 O      <true/>
      <key>Label</key>
      <string>org.v2raya.v2raya</string>
! B6 ?% h8 s9 P- W      <key>ProgramArguments</key>
      <array>
- q, s) f, N4 I, G3 Y            <string>/usr/local/bin/v2raya</string>
1 Q9 `1 }6 p5 l& w6 P- b            <string>--lite</string>
      </array>
      <key>RunAtLoad</key>
      <true/>
, O' q9 x' t4 Z+ g$ y</dict>
</plist>
运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
1 G, J! K/ x8 B( A. C' u& s: ?) w; @如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
" c# ~7 t- q. d. n# A
  |. t+ @- l% t+ N( ^$ s