macOS 上使用 Homebrew 安装和配置 frp 客户端 (frpc) 指南

frp (Fast Reverse Proxy) 是一款高性能的反向代理应用，常用于内网穿透。本文将介绍在 macOS 上使用 Homebrew 安装 frpc，并进行配置和管理。

---

一、安装 frpc

使用 Homebrew 安装（推荐）

1. 确保已安装 Homebrew

2. 给终端中执行：

   brew install frpc
   

安装完成后，frpc 可执行文件通常位于：

• M1/M2 系列芯片：/opt/homebrew/bin/frpc
• Intel 版 mac：/usr/local/bin/frpc

---

二、配置 frpc

创建配置文件

1. 创建配置文件目录：

   sudo mkdir -p /opt/homebrew/etc/frp
   

2. 创建并编辑 frpc.toml：

   sudo nano /opt/homebrew/etc/frp/frpc.toml
   

3. 配置示例：

    # 公共配置
    serverAddr = "阿里云服务器公网IP"
    serverPort = 7000
    auth.method = "token"
    auth.token = "你的token"
    
    # Gitea 服务转发
    [[proxies]]
    name = "Gitea"
    type = "tcp"
    localIP = "127.0.0.1"
    localPort = 3000            # Gitea 在群晖上的端口
    remotePort = 3000           # 阿里云上的访问端口
    
    # GitLab 服务转发
    [[proxies]]
    name = "GitLab"
    type = "tcp"
    localIP = "127.0.0.1"
    localPort = 8888            # GitLab 在群晖上的端口
    remotePort = 8888           # 阿里云上的访问端口
   

注意：不要在 serverAddr 前加 http:// 或 https://

---

三、启动和关闭 frpc

启动 frpc

/opt/homebrew/bin/frpc -c /opt/homebrew/etc/frp/frpc.toml

如果配置正确，将看到例如下面的输出：

[I] [service.go:288] login to server success, get run id [xxxxxxx]

关闭 frpc

pkill frpc

---

四、设置开机自启动

使用 Homebrew Services

1. 先确保已安装 services 接口:

   brew tap homebrew/services
   

2. 启动 frpc 服务:

   brew services start frpc
   

   默认会使用 /opt/homebrew/etc/frp/frpc.toml

3. 停止 frpc 服务:

   brew services stop frpc
   

---

五、查看日志

tail -f /opt/homebrew/var/log/frpc.log

---

附录：常见配置错误

错误示例：

parse "http://[http://47.97.xx.xx]:7000": missing ']' in host

原因： serverAddr 中包含了 http:// 前缀

解决： 不要加 http://，直接写 IP 或域名

---

附录：推荐的 GUI 端

• frp-gui for mac
• EasyFrp