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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
, P$ i- a% m  [. T7 j7 q
, T- Q5 v% L1 ?( W% VmacOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

5 C+ A, u% _7 Bv2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。
3 W$ k& C9 q9 e; x! K8 Z
  k0 \( G* |  g, o建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
/ g. C3 F* ^  k- N0 }6 Z
使用 Homebrew 安装
) r! Y* U7 x& L7 g6 `9 T' q& E请确保安装了 Homebrew 并工作正常。

0 ]- r: w! \2 d$ Z# M  k安装
* A: F. A. O5 H4 X7 y添加 v2rayA 的 Tap：
; X) O4 a. ]) [$ j* H
$ j9 Y& {& Q$ l8 Q' h( E& Nbrew tap v2raya/v2raya
安装 v2rayA:
$ V8 c, v4 `6 k2 Y# g8 Z
brew install v2raya/v2raya/v2raya
4 g. ~6 m3 S+ N! _v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。

( s. F/ g0 u: P1 c) _运行
安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

brew services start v2raya
手动安装
创建目录
6 \; p+ a8 Q8 L这些目录可能已经存在，创建之前请注意检查。

二进制所在目录：

6 H0 Z& l( a6 |% A/ Wsudo mkdir /usr/local/bin/
! J9 p$ v# W" s: O/ W2 ^数据文件所在目录：

* u" C& f+ n" M' |% v! C$ U! vsudo mkdir -p /usr/local/share/v2ray/
服务文件所在目录：

mkdir ~/Library/LaunchAgents/
. J1 L) @/ u5 l, N6 q下载 v2rayA
* @2 B  r) Z# B) c* c从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。
- E) `% \  ]- L8 w
4 d5 Q7 }  Y) Y% Q9 `+ ^# a示例：

. _; a+ t3 ^5 c2 h& Ix86_64:

sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
$ `- T; ?4 g; S( e8 m& Y, [arm64:
% h8 j, S' q" [# A- X
sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
下载 V2Ray 核心 / Xray 核心
$ Z9 P. `; [4 I  [' L安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

解压压缩包后将其中的文件移动到对应目录：
# N# Z/ \0 w& s" ]
( `& ^5 x0 ]+ g9 U6 U! vsudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/
2 J% c) i9 O/ b  P给予权限
给予 v2rayA 与 v2ray 可执行权限：

sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
sudo chmod 755 /usr/local/bin/v2ctl
* N7 F. ~6 x3 ^5 B: N如果遇到 macOS 的安全限制，那么需要运行以下命令：

, s' R# b6 P( M. Zsudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
: E! y$ M  k, m9 i3 m建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/

示例：

2 t8 K; D/ ?) Z- h# ^) }& wnano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
+ p, m/ y! ^: B/ c内容如下：
0 p9 Y: o5 N# r2 q+ R# m3 L/ Z
) ?) i5 s( Z4 F' ]9 Y<?xml version="1.0" encoding="UTF-8"?>
6 x; o5 \7 z8 k* G7 l# O<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
) n: b8 h6 u, y<plist version="1.0">
0 ]/ [) K6 f/ c! Z<dict>
. p3 ^; f1 }2 U5 k      <key>EnvironmentVariables</key>
. |2 H. ^& D/ E1 L& |5 R: l& N      <dict>
9 w* A3 k& t) d: u$ a( J/ l& J3 O2 u            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
' I1 G& I1 z7 Q6 J            <string>/usr/local/bin/v2ray</string>
      </dict>
4 h" s% C; F. W, v/ I8 W      <key>KeepAlive</key>
  Q# w3 Z5 o9 O  Q) |3 o8 |' O      <true/>
- O3 E( }3 i! v" J! y( v8 u      <key>Label</key>
7 h& v& b4 f7 \, Q      <string>org.v2raya.v2raya</string>
6 R1 H) F7 ?$ s3 C- Q( }% B      <key>ProgramArguments</key>
      <array>
) H/ X& x% N& `            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
1 v2 C! X' S8 j+ R& Q% O      </array>
2 z+ ~* E0 c! F/ L+ V3 I! T8 q      <key>RunAtLoad</key>
      <true/>
# b8 O; r$ K0 p</dict>
) u: H3 D8 o  U1 t; h# z! f3 q</plist>
运行
launchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。