winodws下cpolar 公网穿透保姆级安装使用教程

适用场景把本机运行的服务如 FastAPI 天气接口暴露为公网 HTTPS供 Dify、Apifox、手机等访问。重要cpolar 是独立客户端不是npm 包不要使用npm install cpolar或npx cpolar。一、cpolar 是什么内网穿透工具把本机某个端口例如8081映射到公网上的一个HTTPS 地址。和 localtunnel 的区别cpolar 在国内网络下通常更稳定不需要localtunnel 那种bypass-tunnel-reminder请求头不稳定需要科学上网。二、下载与安装Windows浏览器打开https://www.cpolar.com以官网为准。注册 / 登录账号。进入下载页面选择Windows版本下载安装包。双击安装按向导完成记住安装目录后面若命令行找不到会用到。安装完成后本机会有cpolar.exe。若安装时勾选了「加入 PATH」则任意打开CMD / PowerShell都能直接输入cpolar。若提示「不是内部或外部命令」请看第八章。三、绑定账号authtoken—— 只做一次即可3.1 去哪里找 token登录 cpolar控制台 / 个人中心。找到Authtoken或「认证令牌」点击复制。不要把 token 发给他人、不要提交到 Git、不要截图发到公开群。3.2 去哪里执行绑定命令在Windows 终端里执行正确方式按Win R输入powershell或cmd回车或在 VS Code / Cursor下方终端里操作。3.3 命令格式若已加入 PATHcpolar authtoken粘贴你的token若未加入 PATH先进入安装目录示例路径请改成你的实际路径cdC:\Program Files\cpolar.\cpolar.exe authtoken 粘贴你的token或者直接找到你安装的目录在路径处点击输入cmd打开看到成功提示即表示本机已与账号绑定一般换电脑或重装才需要重新绑定。四、最常用命令把本机 8081 端口穿透出去4.1 前提本机服务已在监听例如你的 FastAPI 使用8081端口且监听0.0.0.0示例uvicorn.run(app,host0.0.0.0,port8081)先在本机浏览器或 Apifox 测试http://127.0.0.1:8081/你的路径本机200再开 cpolar否则公网也一定不通。4.2 启动穿透再打开第二个终端第一个继续跑你的 Python 服务执行cpolar http8081端口数字必须和本机服务完全一致。若命令找不到使用安装目录下的.\cpolar.exe http 80814.3 看公网地址终端或 cpolar 控制台会显示类似https://xxxxxxxx.cpolar.io具体域名以你控制台为准复制这个 HTTPS 地址后续在浏览器/Apifox/第三方平台配置回调地址或 base URL 时会用到。4.4 保持窗口不关关掉运行cpolar http 8081的终端≈ 隧道断开公网地址不可用。需要长期联调时一个窗口跑服务一个窗口跑 cpolar。五、在 Apifox 里自测方法、路径与 FastAPI 一致例如POSThttps://你的cpolar域名/weather。HeaderAuthorization: Bearer itcastContent-Type: application/json。Body{location:广州}示例。若 Apifox 报DNS / 代理类错误可尝试更换 Agent或使用系统终端 curl对比。六、免费版与地址变化免费隧道子域名可能每次重启 cpolar 后变化。每次域名变了都要在 Apifox 或你配置过的第三方平台里更新 base URL。需要固定子域名请查看官网付费套餐 / 保留域名说明。七、常见问题排查现象原因处理npm ERR! 404搜不到 cpolar误用 npmcpolar不是npm 包用官网exe安装cpolar不是内部或外部命令未加入 PATHcd到安装目录用\.\cpolar.exe或手动添加 PATH公网 502 / 超时本机服务未起或端口错确认127.0.0.1:端口本机先通第三方平台提示无法访问 localhost对方无法访问你电脑必须用cpolar 提供的 https 域名不能填127.0.0.1昨天能用今天不行隧道未开或域名变了重新执行cpolar http 端口更新 URL八、安全建议Authtoken、Bearer 密码不要写入公开仓库可用环境变量或本地配置。若 token 曾泄露在cpolar 控制台重置。个人学习用的简单 token如itcast勿用于生产环境。九、与 localtunnel 对照便于笔记项目localtunnelcpolar安装方式Node.js npx localtunnel官网Windows 客户端公网域名示例*.loca.lt*.cpolar.io等以控制台为准额外请求头常需bypass-tunnel-reminder不需要国内稳定性易 DNS / 超时一般更适合国内联调十、最简命令备忘复制区# 1. 绑定账号仅首次或重装后cpolar authtoken你的token# 2. 本机服务已在 8081 监听后新开终端执行cpolar http8081# 3. 用控制台给出的 https 地址 你的 API 路径做联调与第三方平台配置文档版本整理自用笔记命令以cpolar 官网最新说明为准若界面或命令有更新请以官网文档为准。