LunovaFrp macOS 使用教程

本教程将指导您在 macOS 上使用 LunovaFrpc，支持多隧道与后台自启动。

1. 检查系统架构

打开「终端」(Terminal)，执行：

uname -m

根据结果选择对应架构的下载包。

2. 下载 LunovaFrpc

前往 LunovaFrpc 下载页面，下载适合您架构的客户端。

3. 解压并设置权限

tar -xvzf [你的文件名字].tar.gz
cd [你的文件夹]
chmod +x GalaxyFrpc

4. 配置与启动隧道

基本启动命令格式：

./GalaxyFrpc -u <token> -t <隧道1,隧道2,...>

示例（同时启用三条隧道）：

./GalaxyFrpc -u example_token -t 隧道1,隧道2,隧道3

5. 持续后台运行方式

方法 1：screen

如未安装，可用 Homebrew 安装：

brew install screen

启动并后台化：

screen -S lunovafrpc ./GalaxyFrpc -u example_token -t 隧道1,隧道2,隧道3

按 Ctrl+A，再按 D 退出到后台。

方法 2：nohup

nohup ./GalaxyFrpc -u example_token -t 隧道1,隧道2,隧道3 > /tmp/lunovafrpc.out 2>&1 &

方法 3：pm2

需要 Node.js 环境：

npm install -g pm2
pm2 start ./GalaxyFrpc -- -u example_token -t 隧道1,隧道2,隧道3
pm2 status

停止：

pm2 stop lunovafrpc

方法 4：launchd（推荐，自启动）

创建 ~/Library/LaunchAgents/com.lunovafrp.frpc.plist：

<?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>
  <key>Label</key><string>com.lunovafrp.frpc</string>
  <key>ProgramArguments</key>
  <array>
    <string>/absolute/path/to/GalaxyFrpc</string>
    <string>-u</string><string>your_token</string>
    <string>-t</string><string>tunnel1,tunnel2</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>/tmp/lunovafrpc.log</string>
  <key>StandardErrorPath</key><string>/tmp/lunovafrpc.err</string>
  <!-- 可选：为 Apple Silicon 禁用转译层 -->
  <key>EnvironmentVariables</key>
  <dict><key>ARCHPREFERENCE</key><string>arm64</string></dict>
</dict>
</plist>

注意：/absolute/path/to/lunovafrpc 必须是可执行文件的绝对路径。

加载与管理：

launchctl load ~/Library/LaunchAgents/com.lunovafrp.frpc.plist
launchctl start com.lunovafrp.frpc
# 停止
launchctl stop com.lunovafrp.frpc
# 卸载
launchctl unload ~/Library/LaunchAgents/com.lunovafrp.frpc.plist

6. 查看运行状态

ps aux | grep lunovafrpc

或（使用 pm2）：

pm2 status

7. 停止服务/进程

ps aux | grep lunovafrpc
kill -9 <PID>

pm2：

pm2 stop lunovafrpc

launchd：

launchctl stop com.lunovafrp.frpc
launchctl unload ~/Library/LaunchAgents/com.lunovafrp.frpc.plist

8. 常见问题