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

yixinis

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

macOS Monterey 帶來強大功能，從此輕鬆辦妥更多事- Apple (香港)
v2rayA 与 v2ray 尚未支持 macOS / FreeBSD 之上的 Packet Filter 防火墙，因此透明代理无法启用。安全起见，本 wiki 将以非 root 权限来运行 v2rayA。

v2rayA 使用 networksetup 命令来设置 macOS 上的系统代理，请确保你运行 v2rayA 的账户是 admin 组的成员。关于如何管理 macOS 下的用户组，你可以 参阅 Apple 的官方文档。

  w) w# E+ j3 D9 q* n建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
9 Z1 o& Z  Z, {
使用 Homebrew 安装
请确保安装了 Homebrew 并工作正常。

安装
1 T- e, j  s3 B% `8 ?2 X& i3 ^添加 v2rayA 的 Tap：

+ W" w% i! p" ~8 |+ f9 ~brew tap v2raya/v2raya
安装 v2rayA:
# u$ S4 ~3 e0 a* l: O
brew install v2raya/v2raya/v2raya
7 f* F9 }3 W- s/ j6 Lv2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。

运行
7 b+ v5 I3 t6 m' M1 |  i4 {安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：
1 x& m* I+ ~% U; Q: L$ ?* p( `
4 ~- {7 ?* N2 Wbrew services start v2raya
+ W0 e# a' O3 `, |手动安装
$ M& |5 u# x8 g1 Y创建目录
这些目录可能已经存在，创建之前请注意检查。
' w$ S/ J: y) ~: r: a4 ~, P# a3 t( _+ s
二进制所在目录：

sudo mkdir /usr/local/bin/
数据文件所在目录：
" A$ d9 F% b% K/ U
sudo mkdir -p /usr/local/share/v2ray/
服务文件所在目录：
9 _9 F) `( O* k) N1 k9 q. p
mkdir ~/Library/LaunchAgents/
; \, \0 @: k4 B1 r: B# A下载 v2rayA
从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。
; Y$ I% \  y6 S2 p; M  X
示例：
" @& z0 O- F5 K% l4 P  K
6 A/ j+ ^* C! s) d3 W$ s& @3 Dx86_64:
5 E: }3 v! t6 I3 u3 }5 `
sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:
5 Z2 _) g6 y( m. r& F' z5 S2 ]
sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
# }+ i1 L8 t9 W# o+ B) D下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

/ @2 k. z8 \4 A- M8 A解压压缩包后将其中的文件移动到对应目录：
0 @' h2 Z- P' k- Q0 e& g
sudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/
给予权限
给予 v2rayA 与 v2ray 可执行权限：
7 ^0 [9 }, b( V1 ~' o" ^7 Q
sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
  L8 s' Z5 `& m$ Z0 i9 O' [, jsudo chmod 755 /usr/local/bin/v2ctl
如果遇到 macOS 的安全限制，那么需要运行以下命令：

sudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
7 k* ?( {8 K3 f; D. `/ t9 L3 G1 \新建服务文件并保存到 ~/Library/LaunchAgents/
) D# p- i: B' V3 d
示例：

0 f- J' v+ a5 N+ Qnano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
内容如下：

9 q6 @7 E0 n- @8 l" N* {! I! |# q" w<?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">
<dict>
% v4 l  @& D) F6 i      <key>EnvironmentVariables</key>
      <dict>
2 W( g, o( l) ^) G. e' v            <key>V2RAYA_LOG_FILE</key>
3 f9 T1 `7 p: B& ?            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
8 X* y! N5 [2 i4 k! a) m            <string>/usr/local/bin/v2ray</string>
      </dict>
/ T4 v# X0 u+ C$ ?$ a      <key>KeepAlive</key>
: X( j% D9 P+ p# h1 ]1 d      <true/>
- f7 u9 }7 U+ g) ]* i: M      <key>Label</key>
9 ~" G7 ~% V3 N( r8 {+ q      <string>org.v2raya.v2raya</string>
' N& S, _6 j/ t, w9 L  \      <key>ProgramArguments</key>
      <array>
            <string>/usr/local/bin/v2raya</string>
5 \  t: x$ n8 s, o4 \$ x            <string>--lite</string>
3 j. R$ q$ W7 m" {- J      </array>
3 U' M/ P) R$ V3 n7 F$ y      <key>RunAtLoad</key>
      <true/>
</dict>
% S2 V5 a( J1 M7 L) l  A7 B</plist>
运行
, J! n" c; j, F; j' v4 A# }# [8 S. dlaunchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
) k: w$ J" A: Z8 P9 ]8 P如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。

! x/ Q" s8 f" R4 h/ G