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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
" |$ M! |7 l  f) ~) P
. p' i' }- h4 J! i- }1 P0 _macOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。
8 G# U. M7 I, D2 |; d1 b
2 z6 F( _* p8 Y6 `( I* Z! Tv2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。
! X1 G* ~, i0 q8 Q3 o
3 Z1 m2 |0 H3 a建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
% n$ b0 K2 v% p$ R! v) M$ x
. e" O* C' Z4 i, L使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。
9 r9 g4 Y2 j% s1 p) W
8 R- J, e3 O" _" t. i5 p安装
添加 v2rayA 的 Tap：

" F0 Z# Z! u& Q, [brew tap v2raya/v2raya
8 {1 T/ j! O! O9 G2 Z) d+ a+ [1 f安装 v2rayA:
& z. s' c2 K5 {$ W: R* O
brew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。

& I4 z  T! Z8 L, r1 `1 j运行
& G5 Q0 w5 g5 t; T安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

brew services start v2raya
$ O& g. d0 e" R; d8 [7 @- Y手动安装
+ I- G3 ?4 O6 O# g7 L4 N创建目录
' |& M7 l8 ]" J这些目录可能已经存在，创建之前请注意检查。
! r1 ]" {2 k4 U7 R. z4 s, K
二进制所在目录：
+ T3 Z2 [" _$ K+ N* A
' @4 M6 g2 q5 @$ f% ^" A5 i) I1 zsudo mkdir /usr/local/bin/
数据文件所在目录：

sudo mkdir -p /usr/local/share/v2ray/
, x$ ^, W$ f2 j8 C: c5 Y4 i服务文件所在目录：
4 c( v/ H, O. x6 u* S- u0 h
* T# b1 d! }* K" pmkdir ~/Library/LaunchAgents/
下载 v2rayA
从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。
. E* b+ ~4 _1 |8 }7 ]. N0 ^$ H
示例：
' N0 k: f' I3 |1 d. ^
8 T# M6 P( J' _( z) [1 c/ D' zx86_64:
) _' w! s. C( b1 Y1 z; h
sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:
# c0 @/ u, \1 S' @  @* `
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
2 d- i3 \+ ~2 U: M" [) N1 _: p
* D0 R/ [( e" ?' g' `解压压缩包后将其中的文件移动到对应目录：

sudo mv v2ray /usr/local/bin/
/ J: h/ N) I6 c: Y& T4 L0 Jsudo mv *dat /usr/local/share/v2ray/
( k! f, Z% N$ D给予权限
1 ^9 Z/ X# d# a$ \2 o; O给予 v2rayA 与 v2ray 可执行权限：

1 n% W, b6 |3 U3 csudo chmod 755 /usr/local/bin/v2raya
" a: x. L& F5 S* g% ssudo chmod 755 /usr/local/bin/v2ray
3 `, {5 X+ \( V; H9 m+ Ssudo chmod 755 /usr/local/bin/v2ctl
1 t4 k* ^) Z$ v( d7 y+ V1 b如果遇到 macOS 的安全限制，那么需要运行以下命令：

sudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
. ^/ V  \  p2 k: J+ `新建服务文件并保存到 ~/Library/LaunchAgents/

3 T; q1 b3 K8 E% ^+ b示例：

  ^' V( |# }4 d* ^nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
内容如下：
4 m" T1 s% Q2 ?& @
2 l2 H# ?. g  y( }# X3 U<?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">
) U5 o$ y- [6 ^9 }* x3 t8 N- ^<dict>
0 F7 r/ u& u+ a* h      <key>EnvironmentVariables</key>
      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
5 s% B9 ~! G9 F7 }            <string>/usr/local/bin/v2ray</string>
      </dict>
      <key>KeepAlive</key>
      <true/>
      <key>Label</key>
      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
      <array>
9 n8 ?! n+ b! x% P3 [" r' o            <string>/usr/local/bin/v2raya</string>
* m' D' N! q4 l6 ]  f) ?" q            <string>--lite</string>
/ l# N" ~7 Y$ _! E3 v8 b      </array>
; B; h% f: s, d& @* e, n3 L  Q; U- U      <key>RunAtLoad</key>
; r) z& D) k* r% B; y$ T& K      <true/>
</dict>
</plist>
$ ~! X0 z3 P, N" [运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
& ~* y, S/ {# k2 C6 j8 ?
" c4 d0 o+ k8 N- E4 t