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

yixinis

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

macOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
* O/ `  }+ G- p' B; ]& g" @v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

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

建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
7 O: J0 K" ^2 f5 j1 d7 M) T+ k
使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。
% Y* R3 m! n0 I: A8 J
安装
' L8 H& b- {! F" R$ ]9 t! P添加 v2rayA 的 Tap：
8 g8 M: j( o- s
brew tap v2raya/v2raya
4 x8 [) t5 t/ ^安装 v2rayA:

3 S' R, `9 |2 T4 R! a8 u6 jbrew install v2raya/v2raya/v2raya
: G; _: T. h3 B- G1 Tv2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
) `" }- Q! j" V4 A4 q
- p2 e2 [# e, z. ^1 M7 J运行
8 K3 a, E% r- m) F( Z' v/ F3 J3 _安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

6 ?; z1 ?" }' x& I1 fbrew services start v2raya
4 S4 a' o- m6 i手动安装
9 x: U6 i6 a$ i' N5 |- V$ n  g; E创建目录
% [) V) h! ^% I0 [) p这些目录可能已经存在，创建之前请注意检查。

8 D) N2 }3 P' F+ V7 w二进制所在目录：
) a+ z( K/ n3 Y8 U1 n- b. W; ?2 k
" ?  g" i8 v4 T; a6 o) h/ Hsudo mkdir /usr/local/bin/
) n7 _" _# f, ]' P数据文件所在目录：
) u$ w! J. B5 F2 Q# j
sudo mkdir -p /usr/local/share/v2ray/
  I( T# F0 `; F) e% T/ B2 |% Y服务文件所在目录：

' [! ]6 h1 z9 Z& _) `mkdir ~/Library/LaunchAgents/
8 _5 U0 y' ?" l3 b% ], u. R下载 v2rayA
! d1 Z0 e) P% f! t1 I. ?" I从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

1 y" P9 u, v# Y/ f7 h- D示例：

9 N. A% J; t  f) s7 V6 `x86_64:
, U" Y! c& O9 e, j6 ?
sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:
+ K/ T  w9 e: m9 j1 Z. M5 Q' c8 x
sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
下载 V2Ray 核心 / Xray 核心
% m5 ]1 s. B9 Z安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

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

# M% l) e8 Z1 ?- I& s2 psudo mv v2ray /usr/local/bin/
5 C) L) @7 D5 C: C" ?9 `sudo mv *dat /usr/local/share/v2ray/
/ D- m6 E5 X# u$ W& g给予权限
# p: e# i' l1 U8 Z: U给予 v2rayA 与 v2ray 可执行权限：

" C4 b3 L% F. F) J" Z7 |sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
& z- x. [6 g* G% X/ J' @- U" `sudo chmod 755 /usr/local/bin/v2ctl
如果遇到 macOS 的安全限制，那么需要运行以下命令：
# C. i4 A/ F3 E8 }( k  y
sudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
0 p9 O& V, ]& Q# S; E新建服务文件并保存到 ~/Library/LaunchAgents/
9 K% o9 I! L: P* q: O5 J+ ^
示例：
8 m* a2 N% m7 S; u( O
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
内容如下：
. z0 J. J+ s/ h4 T* W
, V  S/ l7 G& ]) `9 h<?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">
! O; v( T+ N& z) u1 Z$ e3 s<plist version="1.0">
<dict>
6 X9 W7 t9 e- [8 t/ h% d& N5 F% d      <key>EnvironmentVariables</key>
      <dict>
  h8 J" ]7 d3 z/ @- [7 t            <key>V2RAYA_LOG_FILE</key>
8 I' `- r0 h8 N  G- y            <string>/tmp/v2raya.log</string>
0 M/ B4 J, L6 R/ `! B  e3 _            <key>V2RAYA_V2RAY_BIN</key>
, m: }0 m) ^1 ?4 @            <string>/usr/local/bin/v2ray</string>
  c" C/ p. V& h7 r- E6 f      </dict>
      <key>KeepAlive</key>
/ z2 a7 l4 H/ h( @      <true/>
4 U# R8 V- q+ R0 d3 {      <key>Label</key>
      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
      <array>
            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
      </array>
' X, t. }3 d7 i      <key>RunAtLoad</key>
      <true/>
</dict>
- s1 T% \6 Z8 ^  S0 V</plist>
/ z6 e/ w9 q2 q2 Q' c* f/ y运行
; h8 g/ ~0 x2 i4 ~( slaunchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
8 M4 s5 H4 c% O4 n6 X2 V  \如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。