StellarFrpc macOS 使用教程

本教程将指导您在 macOS 系统上使用 StellarFrpc，并支持多条隧道配置及后台运行。

---

1. 检查系统架构

在下载前，我们需要确认您的系统架构。

打开终端（Terminal），执行以下命令查看系统架构：

uname -m

常见的返回值和对应架构如下：

• x86_64：Intel 芯片的 Mac
• arm64：Apple Silicon 芯片的 Mac（M1/M2/M3系列）

根据输出选择正确的下载文件。

---

2. 下载 StellarFrpc

根据您的系统架构，前往以下地址下载对应的 StellarFrpc 客户端：

StellarFrpc 下载页面

下载完成后，将文件保存到您的工作目录中。

---

3. 解压并设置权限

假设下载的文件名为 stellarfrpc.tar.gz，打开终端并进入下载目录，使用以下命令解压并设置权限：

tar -xvzf stellarfrpc.tar.gz
cd stellarfrpc
chmod +x stellarfrpc

---

4. 配置隧道

StellarFrpc 的启动命令格式为：

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

示例：启动多条隧道

假设您的 token 是 example_token，需要启动 隧道1、隧道2 和 隧道3，执行以下命令：

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

此命令会同时启动多个隧道。

---

5. 持续运行

为了让 StellarFrpc 持续运行，您可以选择以下方法之一：

方法 1：使用 screen

macOS 默认没有安装 screen，您可以使用 Homebrew 安装：

brew install screen

创建一个新的 screen 会话并运行 StellarFrpc：

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

按下 Command + A，然后按 D 退出 screen，进程将继续在后台运行。

方法 2：使用 nohup

使用 nohup 命令运行：

nohup ./stellarfrpc -u example_token -t 隧道1,隧道2,隧道3 > output.log 2>&1 &

此方式会将输出记录到 output.log 文件中。

方法 3：使用 pm2

安装 pm2（需要先安装 Node.js）：

npm install -g pm2

使用 pm2 启动 StellarFrpc：

pm2 start ./stellarfrpc -- -u example_token -t 隧道1,隧道2,隧道3

查看运行状态：

pm2 status

停止服务：

pm2 stop stellarfrpc

方法 4：使用 launchd（macOS 原生方案）

创建一个 plist 文件来配置自启动服务。在 ~/Library/LaunchAgents 目录下创建 com.stellarfrp.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.stellarfrp.frpc</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/stellarfrpc</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/stellarfrpc.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/stellarfrpc.err</string>
</dict>
</plist>

加载服务：

launchctl load ~/Library/LaunchAgents/com.stellarfrp.frpc.plist

---

6. 查看运行状态

您可以使用以下命令检查 StellarFrpc 是否正在运行：

ps aux | grep stellarfrpc

如果使用 pm2，可以直接执行：

pm2 status

---

7. 停止 StellarFrpc

找到运行的进程 ID (PID) 并终止：

ps aux | grep stellarfrpc
kill -9 <PID>

如果使用 pm2，执行以下命令停止服务：

pm2 stop stellarfrpc

如果使用 launchd，执行以下命令停止服务：

launchctl unload ~/Library/LaunchAgents/com.stellarfrp.frpc.plist

---

8. 常见问题

1. 无法启动
   检查是否有执行权限：

   chmod +x stellarfrpc

2. 提示"无法打开"或"来源不明"
   这是 macOS 的安全机制。解决方法：

   • 在"系统偏好设置" > "安全性与隐私"中允许运行
   • 或使用以下命令移除隔离属性：

   xattr -d com.apple.quarantine stellarfrpc

3. 无法连接
   确保您的网络环境可以访问 StellarFrp 服务器，检查系统防火墙设置。

4. 后台服务意外中断
   建议使用 launchd 或 pm2 来确保服务的稳定运行。

---

9. 官方交流

如有其他问题或需要技术支持，欢迎加入 StellarFrp 官方群：

点击链接加入群聊【StellarFrp 官方群①】

---