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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
+ T# \" i0 i2 _
0 z8 P, U3 K; I/ emacOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
, k$ J$ B. F( F# I8 U$ E$ lv2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

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

4 l: W1 {8 C" J! {* {建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。

使用 Homebrew 安装
& U  Z: b0 \$ y$ J; j$ U4 F请确保安装了 Homebrew 并工作正常。
" n+ }5 t- V6 Y( j! J
安装
% s* k# q1 \  o添加 v2rayA 的 Tap：

' i% N2 g" A. Hbrew tap v2raya/v2raya
- S' c' ~: G7 L$ A% Z安装 v2rayA:

, o; J3 F/ \. l% K9 z* O" T2 Kbrew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
6 m, z& a# E! ~) w' b* c- S' B
* `: \4 w' n% [/ k. Z运行
6 i' F. M  W( r1 B8 a* m& Z* w安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

brew services start v2raya
' z: L- z& S$ ~7 w2 Y手动安装
* z8 E, O; b2 g/ `7 e创建目录
( u) P% L; d5 d4 H& H: n这些目录可能已经存在，创建之前请注意检查。

$ X; w& V0 a3 z4 T9 j二进制所在目录：
# E7 t5 ?, k% d# _. K( t
sudo mkdir /usr/local/bin/
$ ^+ S9 e* e+ N; N! w6 Z) U# a数据文件所在目录：
5 f( f- {2 p% O$ m
sudo mkdir -p /usr/local/share/v2ray/
6 w5 r$ ?. l5 Z% G# [服务文件所在目录：
) Q) Q% s; Z1 s' K
mkdir ~/Library/LaunchAgents/
下载 v2rayA
# {9 f5 E+ K6 w% q% o" P; b: r1 @从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

示例：
/ n# a, P8 m9 O5 P. }" i8 Q
+ \+ M" q2 P: e, F- w5 }x86_64:
. ?9 M$ d/ |( m' J
sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:

$ E8 p7 |! d: N* Rsudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
0 b& @% j6 ^4 k2 s2 }, f下载 V2Ray 核心 / Xray 核心
7 P% X- P# \1 |2 p6 @安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

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

sudo mv v2ray /usr/local/bin/
$ z. Z/ K+ j  Lsudo mv *dat /usr/local/share/v2ray/
) g8 |5 g: `; ]! z  ]& r% I' t给予权限
给予 v2rayA 与 v2ray 可执行权限：
$ E; ?# Q4 S( A
sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
sudo chmod 755 /usr/local/bin/v2ctl
3 a; S2 s8 ^* D6 F! x  `/ ?! @如果遇到 macOS 的安全限制，那么需要运行以下命令：
3 [/ t# b' k1 [' m
1 w* X, j) W; S2 o7 G1 X  Asudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
- b4 v* ~4 `$ W2 U建立服务文件
6 Y& \9 B- `6 y6 n6 |/ x新建服务文件并保存到 ~/Library/LaunchAgents/
9 D, {" O$ e0 N
# Y6 [+ h' Y) \* `$ \' ?9 I示例：
2 n1 i7 k3 n2 P" M) X
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
内容如下：

<?xml version="1.0" encoding="UTF-8"?>
5 Y, K6 B0 Z$ N; w$ s<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
* x9 F/ ?1 ?) N1 K" R3 ^! b<plist version="1.0">
# V8 G" h8 F+ \3 z% E9 _, T, s+ j, t<dict>
) X/ N" g6 V& Y4 d, l  C0 e, q. Z9 F      <key>EnvironmentVariables</key>
      <dict>
& }% C& g; O3 |/ p5 L            <key>V2RAYA_LOG_FILE</key>
/ P9 ?9 h0 x3 t" u7 U$ p            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
" k0 o, X8 V8 S. W0 R            <string>/usr/local/bin/v2ray</string>
- X: c8 z3 L, l4 }& B2 |      </dict>
      <key>KeepAlive</key>
6 M* W9 A, d% }      <true/>
2 u. J% t2 \  x; I5 t      <key>Label</key>
9 ?8 P' c5 k0 m, \% x, q; I      <string>org.v2raya.v2raya</string>
1 |6 ]$ o- F# r3 u% B5 r* I) H      <key>ProgramArguments</key>
/ x% K6 ~; v' [# ^. I      <array>
" |$ t. o# n+ R& E7 ~4 I# k# z            <string>/usr/local/bin/v2raya</string>
- ]6 D" k+ z+ v: U8 b. q' Q            <string>--lite</string>
      </array>
. J8 V0 A5 N' w0 t+ S0 g, A( Z      <key>RunAtLoad</key>
. |8 v7 Y- l; v5 W* Q9 [      <true/>
/ d) D; Y/ W3 {( ^1 f</dict>
</plist>
运行
3 h0 z" _; J  o* u$ A' Rlaunchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
+ N* |6 U8 ~8 z如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
% R3 ~! V$ ^% p6 J- E" X" A0 J
: J: Q. M. H; h8 ^+ A9 z4 W  l* y