MacOS下内网穿透工具cpolar使用教程（Mac 版）

核心特点

支持 HTTPS，国内线路稳定，提供命令行与可视化界面，无需路由器端口映射，手机移动流量可直接访问 Mac 本地项目（Vue/React/ 小程序等均适配）。

一、前置准备

1. 环境要求

macOS 系统，终端可正常执行命令。

2. 功能说明

免费版可满足日常开发测试需求：支持 HTTPS、自动生成公网地址，公网地址每 24 小时会随机变化。

二、完整安装流程（Mac 推荐 Homebrew）

方式一：Homebrew 安装（推荐）

步骤 1：安装 Homebrew（已安装可跳过）

打开终端执行：

复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证：

复制代码

brew -v

步骤 2：安装工具

复制代码

brew tap probezy/core && brew install cpolar

验证：

复制代码

cpolar version

步骤 3：绑定 Authtoken

复制代码

cpolar authtoken 你的Authtoken

出现 Authtoken saved 即为成功。

步骤 4：安装并启动后台服务

复制代码

sudo cpolar service install
sudo cpolar service start

步骤 5：Web 管理面板验证

浏览器访问：

复制代码

127.0.0.1:9200

登录后可查看隧道状态。

方式二：官网下载安装

未使用 Homebrew 的用户可从官网下载安装包手动安装。

三、常用命令速查

1. 服务管理

复制代码

sudo cpolar service install    # 安装系统服务
sudo cpolar service start      # 启动服务
sudo cpolar service stop       # 停止服务
sudo cpolar service restart    # 重启服务
sudo cpolar service uninstall  # 卸载系统服务
launchctl list | grep cpolar   # 查看服务状态

2. 隧道操作（开发常用）

复制代码

cpolar http 8080         # 临时映射 8080 端口
cpolar https 3000        # HTTPS 映射（iOS 推荐）
cpolar tcp 22            # TCP 端口映射
cpolar start 隧道名      # 启动配置好的隧道
cpolar stop 隧道名       # 停止指定隧道
cpolar list              # 查看隧道列表
cpolar delete 隧道名     # 删除隧道

3. 版本与配置

复制代码

cpolar version                # 查看版本
brew upgrade cpolar           # 更新（Homebrew 版）
cpolar config show            # 查看配置
cpolar config reset           # 重置配置

4. 彻底卸载

复制代码

sudo cpolar service stop
sudo cpolar service uninstall
brew uninstall cpolar
sudo rm -rf /usr/local/bin/cpolar

四、典型使用示例

手机访问 Mac 本地 Vue 项目（端口 8080）：

确保项目启动在 localhost:8080
终端执行：
复制代码
```
cpolar https 8080
```
扫描生成的 HTTPS 公网地址即可访问。

五、常见问题与注意事项

关闭终端隧道断开：需配置系统服务后台运行
iOS 无法访问：必须使用 https 协议
地址频繁变化：免费版公网地址会自动更新
命令报错：检查权限、网络、Homebrew 环境

六、总结

该工具可快速实现公网访问本地服务，适合移动端真机调试、跨设备访问开发环境。安装三步：安装程序 → 绑定 Token → 启动隧道，即可完成绝大多数开发场景需求。

官方文档：https://www.cpolar.com/docs