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

yixinis

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

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

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

+ f3 f/ e' u' l! k; c建议从 brew 安装 v2ray 核心，如此 v2rayA 将自动使用你电脑上现有的 v2ray。如果不从 brew 安装核心，你将需要手动指定核心所在路径。
5 u3 {( M0 `0 X, s% t
使用 Homebrew 安装
2 m% n* l+ s8 S# y3 M请确保安装了 Homebrew 并工作正常。
$ i# G+ W7 l& N  s, N
安装
添加 v2rayA 的 Tap：
/ l& g; S2 D6 M
; m2 V% o: }/ ?" B# Abrew tap v2raya/v2raya
安装 v2rayA:
* _  j" B+ v' `3 M* \' U9 X
brew install v2raya/v2raya/v2raya
v2ray 设置为了 v2rayA 的依赖包，如此，v2rayA 将正确运行。
4 I0 m. c& R2 ], Q! Q0 B3 A! p
0 k- a7 {7 P$ W* C8 `3 ~+ X运行
安装完成之后可以在终端通过 v2raya --lite 命令运行，也可以启动服务：

; ^2 B# d9 `) B# Dbrew services start v2raya
1 C- z; ]. `! v% l手动安装
/ W+ J: p8 w5 Z: q4 \* f9 ~( r创建目录
- E( I2 H  B) ]0 p7 F7 s这些目录可能已经存在，创建之前请注意检查。

- H" ^3 Z9 |, a1 @: E$ w二进制所在目录：

: \/ w/ E  L* A6 c* k8 j: isudo mkdir /usr/local/bin/
数据文件所在目录：
7 I. T2 s& J. N! T' \4 m
$ r, c+ b+ N1 @sudo mkdir -p /usr/local/share/v2ray/
2 c) s& J: N5 F8 l: O' L. b服务文件所在目录：
" b' O" B5 d/ v3 R6 K
$ [5 p$ m' X: @+ z8 E" Imkdir ~/Library/LaunchAgents/
下载 v2rayA
从 GitHub Releases 或 GitHub Action 下载适用于 macOS 的二进制文件，然后重命名为 v2raya，并将其保存到 /usr/local/bin/。

示例：

x86_64:

sudo curl -L https://github.com/v2rayA/v2rayA ... ya_darwin_x64_1.5.7 -o /usr/local/bin/v2raya
arm64:
! P' \8 }: F' i+ k
sudo curl -L https://github.com/v2rayA/v2rayA ... _darwin_arm64_1.5.7 -o /usr/local/bin/v2raya
下载 V2Ray 核心 / Xray 核心
安装 V2Ray：https://www.v2fly.org/guide/install.html 安装 Xray：https://xtls.github.io/document/install.html

解压压缩包后将其中的文件移动到对应目录：
, T% F( Y( t$ O- O6 ^: j
" V/ `' A5 G) esudo mv v2ray /usr/local/bin/
sudo mv *dat /usr/local/share/v2ray/
9 d; E, |% C5 A. g给予权限
给予 v2rayA 与 v2ray 可执行权限：

sudo chmod 755 /usr/local/bin/v2raya
sudo chmod 755 /usr/local/bin/v2ray
/ W. d5 A# U% L4 \5 Q& L7 z- hsudo chmod 755 /usr/local/bin/v2ctl
$ {, o# R4 f" R如果遇到 macOS 的安全限制，那么需要运行以下命令：

1 t' q0 s3 n8 h: ]- H: U) psudo xattr -d -r com.apple.quarantine  /usr/local/bin/*
建立服务文件
新建服务文件并保存到 ~/Library/LaunchAgents/
/ a  j+ J5 B2 V, Z3 a/ R3 r$ k
示例：

0 U6 |! U/ \7 y0 f4 I1 M, \/ B4 lnano ~/Library/LaunchAgents/org.v2raya.v2raya.plist
, r- [8 q9 T& V3 O6 }/ N& R/ t内容如下：
6 Q3 v" M9 b9 b3 A0 n1 C
1 G3 B7 Z* O) t. a( V4 {<?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">
+ R. q; I) F+ ?0 v1 }. M<dict>
      <key>EnvironmentVariables</key>
      <dict>
            <key>V2RAYA_LOG_FILE</key>
            <string>/tmp/v2raya.log</string>
            <key>V2RAYA_V2RAY_BIN</key>
            <string>/usr/local/bin/v2ray</string>
      </dict>
      <key>KeepAlive</key>
; }/ G* X+ }; K* w* M. @4 m      <true/>
      <key>Label</key>
$ [- N; n* ~9 E3 u      <string>org.v2raya.v2raya</string>
      <key>ProgramArguments</key>
# \' c! M" g/ ~# p      <array>
+ T* A" {8 t+ `0 d0 \: T8 e            <string>/usr/local/bin/v2raya</string>
            <string>--lite</string>
      </array>
( N5 N3 W( o) s' D, `      <key>RunAtLoad</key>
! y  s2 [1 I5 a; D) a( _9 D      <true/>
( A- ?- i" k2 D- F</dict>
4 ]. d( w5 \( r* v: _( x</plist>
/ g! \; U9 g/ z. z; D运行
1 ^& T' U% }/ V+ v: Xlaunchctl load ~/Library/LaunchAgents/org.v2raya.v2raya.plist
, ^. `7 i7 e* C7 P4 Q1 m! D如果要关掉 v2rayA 服务，将上述命令从 load 替换为 unload 即可。可以通过 Web 前端查看日志。

, O# v+ {' G- g, z% R+ f9 l