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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
5 l( M0 l, p! f
( {# e7 w0 W# ?0 u' S6 \$ TmacOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

v2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。
% `7 F* i) e9 |2 o
建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。

1 J; D, U9 }; r+ \3 O1 s& u& p使用 Homebrew 安装
8 {4 x  x5 o9 S4 C; V请确保安装了 Homebrew 并工作正常。
0 F7 _/ B) @* a. M1 B
安装
添加 v2rayA 的 Tap：
8 ^8 o' y; H  W& D; ^
brew tap v2raya/v2raya
安装 v2rayA:
) }$ i. s/ h: l9 D: b
+ c- d/ L" v- n3 X; Cbrew install v2raya/v2raya/v2raya
( O+ N$ r! N# [8 h, Y7 x% l( I' {% H3 ]v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
/ x5 x+ d) O* }3 t  n4 [
运行
8 i: L) |6 o3 l0 }. G4 z+ g$ j& }安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

( d9 O7 S- x! r$ a# xbrew services start v2raya
手动安装
0 Y9 {' t; x" P4 T+ H2 \创建目录
这些目录可能已经存在，创建之前请注意检查。

二进制所在目录：
; Z5 k: y4 P2 X6 c3 z
- P% v$ t- F9 jsudo mkdir /usr/local/bin/
  N* |% C' q' Q' s% j$ Q$ i( x+ P数据文件所在目录：
' Q  Q9 s+ A+ D/ _
2 ~8 j: F/ _) Ssudo mkdir -p /usr/local/share/v2ray/
服务文件所在目录：

mkdir ~/Library/LaunchAgents/
- T1 f- c6 P! G# ?4 R1 S下载 v2rayA
5 @' P' D) w) x) @4 t从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

7 ~3 X6 c" N" k$ k+ K  Z示例：

6 H7 x; t5 I# [6 I0 Sx86_64:

+ [5 k; l& t% _" Z& Wsudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
/ p  @: Y3 C% Z, L) `8 Jarm64:

- k  N5 `3 j( x7 E& h7 ^8 qsudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
/ _: l  T2 G& w8 K# X9 `( |下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

( ]* N, f% H7 D- A! T解压压缩包后将其中的文件移动到对应目录：

sudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/
5 W/ d# D( H: _0 y! \给予权限
/ Q' }5 w; p: J( y2 o- j; J给予 v2rayA 与 v2ray 可执行权限：
3 v7 ^! n" u$ e+ E
sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
- E- S: @! d  }+ w1 f8 ~7 {) X3 g; Hsudo chmod 755 /usr/local/bin/v2ctl
& M. H  W* s8 Y* l: x5 Z如果遇到 macOS 的安全限制，那么需要运行以下命令：
. u1 L5 V. T2 H* T  q5 X
1 m/ Q( o+ a( |; osudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/
5 H: ]  [  K& L
- z& G5 }; ?; O) S$ o5 y) M示例：
  B" @" T! X' E: ~: |( U4 f4 y
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
9 M3 e: B! D, ^  x1 [内容如下：
, o  F' n6 {% q% V% D4 |
<?xml version="1.0" encoding="UTF-8"?>
5 v! J* }! a/ A8 {+ s- J8 p& M<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
9 o5 w( M: J, A0 d1 O8 k& d<plist version="1.0">
<dict>
      <key>EnvironmentVariables</key>
. O: c- N/ X+ u$ B      <dict>
" b1 j" c( t. A. \1 Y            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
4 u& z( i: l5 A            <string>/usr/local/bin/v2ray</string>
, r/ S& B# m$ X0 ~, L* a) l8 t      </dict>
      <key>KeepAlive</key>
8 c: j0 B( \0 R2 _- M      <true/>
  V6 o: K/ H' i6 ~0 q# y      <key>Label</key>
& G" j: B' @6 {4 X      <string>org.v2raya.v2raya</string>
% R3 W" q0 S/ N3 T9 C      <key>ProgramArguments</key>
      <array>
) p2 a  t( P4 J! u5 g9 [            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
      </array>
) Z  V+ \5 y; _      <key>RunAtLoad</key>
      <true/>
</dict>
7 }' ~# H2 O: ^  s0 h. T</plist>
4 P2 u. g: W9 S' N运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
# C# o: o' w$ O$ K6 p
- t6 }4 X/ }9 d; B. l# ?