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

yixinis

v2rayA 的功能依赖于 V2Ray 核心，因此需要安装内核。
7 Q) o. m- c) F1 s7 L4 G
macOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。
( p9 Z# K2 C6 ]5 e
& Q4 Q  Y2 e% Q) f, Z+ dv2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。

% c( g; h* g" E2 f建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。

使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。
! C- F) a) ^* U
* x9 y& L1 S+ ?  I$ l安装
添加 v2rayA 的 Tap：
. Y% ]; ?! e, p: Z
% q7 i& |3 q2 d: V4 n7 b3 pbrew tap v2raya/v2raya
) c3 |$ R+ x: e安装 v2rayA:
* a, v. j& j2 D
brew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
/ \9 N- A7 m1 M, C2 D
运行
# T4 r: C1 P5 _安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：
) [$ Z1 d* v# [; h
brew services start v2raya
. }( d1 E/ H5 x2 S4 p手动安装
2 M1 V$ s% Y& |' E7 m; ^% ^: V' F创建目录
6 k$ J, B7 s3 y. o* M  V3 N这些目录可能已经存在，创建之前请注意检查。

) L" K! n  D  b5 {二进制所在目录：

2 [) W, c) E2 y+ w9 ^! F$ J( psudo mkdir /usr/local/bin/
6 s. _) Q2 i% K- `8 c, E数据文件所在目录：

sudo mkdir -p /usr/local/share/v2ray/
- v# s8 X/ x9 G7 z8 d服务文件所在目录：

mkdir ~/Library/LaunchAgents/
下载 v2rayA
从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

% ]/ O) d5 k/ {/ W4 i  w示例：
6 {; I" h- F% U/ b" }" F5 J9 C
x86_64:

sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:

# p% k! M4 K. K  `* Hsudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
4 h" E! u7 p1 Y下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html
+ z# d2 \. D8 o8 n1 \
* \0 e0 I! R5 G' t解压压缩包后将其中的文件移动到对应目录：
' K" h) N) b9 U& ^) r( J; T& J
sudo mv v2ray /usr/local/bin/
% n3 p- L% o- G2 Ysudo mv *dat /usr/local/share/v2ray/
; P% E0 }( |( E& G给予权限
给予 v2rayA 与 v2ray 可执行权限：

1 F, w- _0 e; |sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
sudo chmod 755 /usr/local/bin/v2ctl
/ }1 q: [9 ?9 `% W7 A! h如果遇到 macOS 的安全限制，那么需要运行以下命令：

: [, i3 U/ n( P" Msudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
' A5 |7 I5 q+ \, Y8 t/ n建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/

示例：

& n3 ?0 V' G/ I8 Bnano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
7 V) q0 z6 G* ~# |0 |内容如下：

# h# g1 r+ {; j1 b8 R0 O" ?: U<?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">
' t$ H5 @) J& o<plist version="1.0">
7 w* Y: C( H; \4 l2 O, N9 d- Z( \- |  S<dict>
' e  i3 g& c' q/ b: u      <key>EnvironmentVariables</key>
      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
2 J- M6 V* h3 k/ d7 K+ g' I            <key>V2RAYA_V2RAY_BIN</key>
            <string>/usr/local/bin/v2ray</string>
      </dict>
1 |: n& B3 B' B6 P" q8 n7 E      <key>KeepAlive</key>
      <true/>
: g& n; X! |4 c' I% `      <key>Label</key>
      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
      <array>
0 N% H: J, `8 }( ?            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
  _- _8 C* o; J9 D3 }9 q0 }      </array>
# d6 U; n8 W  X      <key>RunAtLoad</key>
- \$ k8 Q1 F, `/ W& d! T      <true/>
</dict>
, K) q/ T. ~. T2 V* c. L! I/ w% `</plist>
* @' }7 u* s; V  j$ z运行
: I) Y7 u! z2 y/ e" E0 @# x3 Q: mlaunchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
5 \' o9 {0 s# A; r; c如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。
- K1 ^1 {3 V8 }$ m( f/ |