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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
! E4 ]0 D' e/ f- W$ B/ b, E
  g* Z! z2 f* a% n" z# [macOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
9 q" n, V/ |  i2 E1 rv2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。
& W! L2 ~) ?! w$ D( d) V" s
" V+ g  C& D) u$ U5 cv2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。
7 {4 T$ E. g% J7 N+ e- Q
建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。

5 {. V8 n+ I2 K  Q& @" D, K使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。

" q1 |- [+ V5 w3 R安装
/ l& V; g  F# \: C) s0 d1 I添加 v2rayA 的 Tap：
$ _8 [7 X2 S1 d; ^4 r4 U( K
brew tap v2raya/v2raya
9 o: g1 O  l$ }# [安装 v2rayA:
0 i+ x2 w4 F6 v; s+ X( V
; v  l6 ?# m$ Fbrew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
4 a. ]7 ^/ \. z) j7 z
+ ^; }# b3 D) {$ e; I/ [; O运行
6 v* e% Q0 `. N5 M安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：
  c7 r9 q; P5 l' d# I8 j
& B- K6 P1 u  E6 obrew services start v2raya
: ]7 ]6 {; C, e2 k. k手动安装
创建目录
, w9 U) d3 z: R! G这些目录可能已经存在，创建之前请注意检查。
. R' _' g7 o9 f4 V2 o& B
二进制所在目录：
, g8 {2 [& d3 t- N0 G' i& p% v0 a
( c6 E3 ~# t" w) Ysudo mkdir /usr/local/bin/
数据文件所在目录：

( M6 m. l2 n. R$ y+ i5 G9 Z  Ssudo mkdir -p /usr/local/share/v2ray/
5 s! `7 l* X) u  L服务文件所在目录：
. a' Z! Q' G" u) a; c
. s/ U) |' e5 Wmkdir ~/Library/LaunchAgents/
下载 v2rayA
从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

示例：
0 F' b, ^# _$ \) G+ F& d
  f, C0 n9 k4 [  zx86_64:

sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
! m3 B2 S8 `$ W1 @4 H' O- W: tarm64:

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

0 @3 L% o) x4 F; p解压压缩包后将其中的文件移动到对应目录：

* Y5 `7 ~' Z7 Z4 @. j- Y  C3 ssudo mv v2ray /usr/local/bin/
$ U0 U% L' I. c8 y& r) c- esudo mv *dat /usr/local/share/v2ray/
给予权限
给予 v2rayA 与 v2ray 可执行权限：

sudo chmod 755 /usr/local/bin/v2raya
* E$ G' G' [( U. x2 S+ R6 P. xsudo chmod 755 /usr/local/bin/v2ray
1 ^  q9 T  F2 O2 g( E$ {sudo chmod 755 /usr/local/bin/v2ctl
如果遇到 macOS 的安全限制，那么需要运行以下命令：
3 _' h. p) ^4 h8 G
, Y/ T* J" K  w' Lsudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
" }2 _5 ?% l7 X. }9 L3 |建立服务文件
5 s3 f0 ^6 {: K) [* u0 e新建服务文件并保存到 ~/Library/LaunchAgents/

示例：

4 r/ k1 v/ o3 e- unano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
内容如下：

<?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">
& ~" [7 [* j" P4 V: J5 u<plist version="1.0">
<dict>
! [6 @9 m: s# m' G; l* N( b      <key>EnvironmentVariables</key>
      <dict>
: Y9 i* `! d$ Q& u8 Y, T            <key>V2RAYA_LOG_FILE</key>
- D1 L1 p* D' K1 I5 s            <string>/tmp/v2raya.log</string>
: @; a9 e/ r6 P            <key>V2RAYA_V2RAY_BIN</key>
) g7 E2 Y9 x; f9 d* J( q' W+ l! u            <string>/usr/local/bin/v2ray</string>
. c/ X1 G+ X. p& N      </dict>
$ M: V% ]6 x9 `; D      <key>KeepAlive</key>
      <true/>
      <key>Label</key>
      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
      <array>
0 K8 m$ ]( Q' c            <string>/usr/local/bin/v2raya</string>
% R- C4 {& Z7 A2 Y/ {            <string>--lite</string>
      </array>
      <key>RunAtLoad</key>
9 y/ s# b2 R, J/ G      <true/>
</dict>
</plist>
运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。

* Z, s# K; j6 H7 W( G8 }( X