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

yixinis

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

2 _  E" N8 s, F! F+ zmacOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
( O; Z' F" J9 X! Y% w4 mv2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

. p' s* m- S& F; X. B. L7 lv2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。
$ D0 t/ L" ~$ ]: {6 B
建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
! ~; k0 J( {3 c( M( e! q
6 }+ j- P. }5 m+ E* Y  l+ m+ J! c使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。

- x; s1 p5 a! H6 j安装
添加 v2rayA 的 Tap：
$ W% f5 A! t8 w! w: }- f& c
$ ?: u1 [9 F" L5 h) Y0 j9 ubrew tap v2raya/v2raya
0 V! V" t0 J2 ]3 w0 z安装 v2rayA:

5 J5 i  G! H/ G' u: T# y+ Q; qbrew install v2raya/v2raya/v2raya
% K: b$ x1 M1 P4 K% Y' Cv2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
4 p' u# }% z- ~: K4 f9 r. ~+ ^
& R* I" }& ~3 V8 y0 m2 ~, d运行
安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

- B" L( k6 ^/ S) T# B' Y" a" c6 Pbrew services start v2raya
手动安装
' Z+ l7 c! }5 ?0 s# l创建目录
" {7 b  x3 ^3 r+ l  G这些目录可能已经存在，创建之前请注意检查。

二进制所在目录：
/ s0 ], j- c: m' g
sudo mkdir /usr/local/bin/
$ S( u  s# q" g0 ^( z数据文件所在目录：
5 i: e- ?% F3 N
* A3 E# M. D$ o* P0 ksudo mkdir -p /usr/local/share/v2ray/
5 p& y! z" m, S/ T+ f/ K! s  P服务文件所在目录：

7 W' a/ R2 Q& Umkdir ~/Library/LaunchAgents/
$ A/ s7 y* C: x0 Z' C) A下载 v2rayA
, H% Z# L( k; D! m$ O从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

示例：

: E2 n: t$ _5 R. i- ix86_64:

+ j: C2 m0 H( _" hsudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
" d$ y  `/ A* F8 q2 K$ Sarm64:

sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
  Z# F3 ?1 g1 I) F8 A+ }下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

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

sudo mv v2ray /usr/local/bin/
( A( ^/ u0 f7 E# U" gsudo mv *dat /usr/local/share/v2ray/
' V$ B8 i& {( b9 s* L  H! \4 p给予权限
给予 v2rayA 与 v2ray 可执行权限：

; s0 b% G2 |9 L# ksudo chmod 755 /usr/local/bin/v2raya
' z1 l( l! k& Hsudo chmod 755 /usr/local/bin/v2ray
+ Y$ F: z; i$ u; D, w4 fsudo chmod 755 /usr/local/bin/v2ctl
如果遇到 macOS 的安全限制，那么需要运行以下命令：

) G1 s0 Z5 @$ U# d0 K7 fsudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/
' Y3 K- S1 T. t2 a* {
示例：
+ h  ^9 A. u% z, T1 C5 y4 b
nano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
, t' Q# r; \' K内容如下：
$ P1 Y/ j5 u8 t% I
% I8 l, @7 j4 q* u8 d  L<?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">
1 {* m- _6 R9 y<dict>
7 q  Q& j* H& e& v0 L      <key>EnvironmentVariables</key>
8 K2 [% N" O3 Z# z" e      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
            <string>/usr/local/bin/v2ray</string>
8 y4 p1 E) S$ _      </dict>
      <key>KeepAlive</key>
      <true/>
      <key>Label</key>
      <string>org.v2raya.v2raya</string>
+ u! I/ w/ |) V/ ?+ N      <key>ProgramArguments</key>
      <array>
            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
      </array>
+ b7 b: C3 B1 p- U  {5 o      <key>RunAtLoad</key>
      <true/>
& q" J# }: r  q3 n; M, `</dict>
/ [9 u) u9 |2 a  a: Y! Q' b; k</plist>
$ p) b3 K' f" \# d- n6 m运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
5 j0 \: k/ @( i% t9 K