cpolar 内网穿透映射域名完整教程
说明:cpolar 域名分两种方案
- cpolar 二级子域名(xxx.cpolar.io):cpolar 官方子域名,无需自己买域名,适合长期测试;需要付费套餐,免费版只能随机临时域名,24 小时会变。
- 自定义域名(自己购买的域名,如
web.mydomain.com):使用你在阿里云 / 腾讯云等服务商购买的域名,需要做 CNAME 解析,同样需要付费套餐。
前置准备
- 注册 cpolar 账号:https://dashboard.cpolar.com/
- 下载并安装 cpolar 客户端(Windows / Linux / Mac)
- 本地准备好服务:例如本地 8080 端口 web 服务,确保本机访问
127.0.0.1:8080正常 - 【自定义域名方案额外准备】在域名服务商购买域名,并且能进入 DNS 解析后台
重要:免费版 cpolar不支持固定域名,只能临时随机域名,24 小时地址会变动,只能临时测试。固定域名(二级子域名 / 自有域名)需要升级套餐。
一、安装 cpolar 并绑定 Token
Windows
官网下载安装包,双击安装,安装完成后浏览器打开
http://localhost:9200进入本地 WebUI登录 cpolar 官网后台,实名认证后到【验证】页面复制
authtoken打开 CMD 执行命令绑定 token:
cpolar authtoken 你的authtokenLinux(Ubuntu/Debian)
sudocurlhttps://get.cpolar.sh|shcpolar authtoken 你的authtokensudosystemctl start cpolarsudosystemctlenablecpolar访问:http://本机IP:9200
方案 A:保留 cpolar 官方二级子域名(xxx.cpolar.io,最简单)
步骤 1:官网后台预留子域名(需升级套餐)
- 登录 cpolar 官网后台:https://dashboard.cpolar.com/
- 左侧菜单【预留】→【保留二级子域名】
- 配置:
- 地区:China Top(和隧道地区保持一致)
- 二级子域名:自定义名称(例如
myweb,不能重复) - 描述:备注,随便填
- 点击【保留】,保存成功,得到
myweb.cpolar.io
步骤 2:本地 WebUI 创建 / 编辑隧道
- 打开
http://localhost:9200,登录本地 cpolar 面板 - 隧道管理 → 创建隧道
- 隧道名称:自定义(myweb-tunnel)
- 协议:http(web 服务)
- 本地地址:
8080(你的本地服务端口) - 域名类型:二级子域名
- Sub Domain:填入刚才预留的
myweb - 地区:China Top(必须和预留地区一致)
- 点击【创建】
步骤 3:测试访问
左侧【状态】→【在线隧道列表】,公网地址就是https://myweb.cpolar.io,浏览器打开即可访问本地 8080 服务。
方案 B:映射你自己购买的域名(推荐,如web.mydomain.com)
步骤 1:cpolar 官网后台保留自定义域名
- cpolar 官网后台 →【预留】→【保留自定义域名】
- 填写:
- 地区:China Top
- 域名:填写完整域名,例:
web.mydomain.com - 描述:备注
- 点击保留,复制生成的 CNAME 记录值(类似
xxxxxx.cname.cpolar.io)
步骤 2:域名服务商添加 CNAME 解析记录
登录域名服务商(阿里云 / 腾讯云 / Cloudflare)DNS 解析控制台,添加一条记录:
- 记录类型:
CNAME - 主机记录:
web(对应域名前缀web.mydomain.com,若用根域名 @则填 @) - 记录值:粘贴 cpolar 预留得到的 CNAME 地址
- TTL:默认 10 分钟
DNS 解析生效需要几分钟到几十分钟,可以用
nslookup web.mydomain.com验证解析是否生效。
步骤 3:本地 cpolar 面板创建隧道,绑定自定义域名
- 访问
http://localhost:9200 - 隧道管理 → 创建隧道
- 隧道名称:自定义
- 协议:http
- 本地地址:
8080 - 域名类型:自定义域名
- 域名名称:
web.mydomain.com - 地区:China Top
- 创建隧道,启动隧道。
步骤 4:HTTPS 证书(可选)
cpolar 会自动提供 HTTPS,直接用https://web.mydomain.com访问。
命令行方式创建隧道(不使用 WebUI)
二级子域名命令
cpolar http--subdomain=myweb8080自有自定义域名命令
cpolar http--hostname=web.mydomain.com8080持久化配置(yml 配置文件,开机自动启动隧道)
cpolar 配置文件路径:
- Windows:
C:\Users\你的用户名\.cpolar\cpolar.yml - Linux:
/usr/local/etc/cpolar/cpolar.yml
示例配置(自定义域名隧道)
authtoken:"你的authtoken"tunnels:myweb:addr:8080proto:httphostname:web.mydomain.comregion:cn修改后重启 cpolar 服务即可自动加载隧道。
常见问题排查
- 域名打不开
- 检查 DNS 解析是否生效;
- 检查 cpolar 隧道地区 和 预留域名地区必须完全一致;
- 本地服务
127.0.0.1:端口确认能正常打开。
- 404/502:本地服务未启动,或者端口填错。
- 免费版无法固定域名:免费套餐不支持预留二级子域名 / 自定义域名,只能临时随机隧道。
- 修改域名后不生效:在隧道列表编辑隧道,更新后重启隧道;DNS 解析等待 TTL 刷新。
安全提醒
- 不要把内网管理后台(数据库、NAS、服务器后台)直接暴露公网,做好鉴权、密码强口令;
- 公网暴露服务存在安全风险,仅限开发调试使用,不建议用于生产环境;
- 国内对外提供网站服务,需要完成 ICP 备案。