☰
cpolar 内网穿透映射域名完整教程
2026/10/1 7:15:52 网站建设 项目流程

cpolar 内网穿透映射域名完整教程

说明:cpolar 域名分两种方案

  1. cpolar 二级子域名(xxx.cpolar.io):cpolar 官方子域名,无需自己买域名,适合长期测试;需要付费套餐,免费版只能随机临时域名,24 小时会变。
  2. 自定义域名(自己购买的域名,如web.mydomain.com):使用你在阿里云 / 腾讯云等服务商购买的域名,需要做 CNAME 解析,同样需要付费套餐。

前置准备

  1. 注册 cpolar 账号:https://dashboard.cpolar.com/
  2. 下载并安装 cpolar 客户端(Windows / Linux / Mac)
  3. 本地准备好服务:例如本地 8080 端口 web 服务,确保本机访问127.0.0.1:8080正常
  4. 【自定义域名方案额外准备】在域名服务商购买域名,并且能进入 DNS 解析后台

重要:免费版 cpolar不支持固定域名,只能临时随机域名,24 小时地址会变动,只能临时测试。固定域名(二级子域名 / 自有域名)需要升级套餐。

一、安装 cpolar 并绑定 Token

Windows

  1. 官网下载安装包,双击安装,安装完成后浏览器打开http://localhost:9200进入本地 WebUI

  2. 登录 cpolar 官网后台,实名认证后到【验证】页面复制authtoken

  3. 打开 CMD 执行命令绑定 token:

cpolar authtoken 你的authtoken

Linux(Ubuntu/Debian)

sudocurlhttps://get.cpolar.sh|shcpolar authtoken 你的authtokensudosystemctl start cpolarsudosystemctlenablecpolar

访问:http://本机IP:9200

方案 A:保留 cpolar 官方二级子域名(xxx.cpolar.io,最简单)

步骤 1:官网后台预留子域名(需升级套餐)

  1. 登录 cpolar 官网后台:https://dashboard.cpolar.com/
  2. 左侧菜单【预留】→【保留二级子域名】
  3. 配置:
    • 地区:China Top(和隧道地区保持一致)
    • 二级子域名:自定义名称(例如myweb,不能重复)
    • 描述:备注,随便填
  4. 点击【保留】,保存成功,得到myweb.cpolar.io

步骤 2:本地 WebUI 创建 / 编辑隧道

  1. 打开http://localhost:9200,登录本地 cpolar 面板
  2. 隧道管理 → 创建隧道
    • 隧道名称:自定义(myweb-tunnel)
    • 协议:http(web 服务)
    • 本地地址:8080(你的本地服务端口)
    • 域名类型:二级子域名
    • Sub Domain:填入刚才预留的myweb
    • 地区:China Top(必须和预留地区一致)
  3. 点击【创建】

步骤 3:测试访问

左侧【状态】→【在线隧道列表】,公网地址就是https://myweb.cpolar.io,浏览器打开即可访问本地 8080 服务。

方案 B:映射你自己购买的域名(推荐,如web.mydomain.com)

步骤 1:cpolar 官网后台保留自定义域名

  1. cpolar 官网后台 →【预留】→【保留自定义域名】
  2. 填写:
    • 地区:China Top
    • 域名:填写完整域名,例:web.mydomain.com
    • 描述:备注
  3. 点击保留,复制生成的 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 面板创建隧道,绑定自定义域名

  1. 访问http://localhost:9200
  2. 隧道管理 → 创建隧道
    • 隧道名称:自定义
    • 协议:http
    • 本地地址:8080
    • 域名类型:自定义域名
    • 域名名称:web.mydomain.com
    • 地区:China Top
  3. 创建隧道,启动隧道。

步骤 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 服务即可自动加载隧道。

常见问题排查

  1. 域名打不开
    • 检查 DNS 解析是否生效;
    • 检查 cpolar 隧道地区 和 预留域名地区必须完全一致;
    • 本地服务127.0.0.1:端口确认能正常打开。
  2. 404/502:本地服务未启动,或者端口填错。
  3. 免费版无法固定域名:免费套餐不支持预留二级子域名 / 自定义域名,只能临时随机隧道。
  4. 修改域名后不生效:在隧道列表编辑隧道,更新后重启隧道;DNS 解析等待 TTL 刷新。

安全提醒

  1. 不要把内网管理后台(数据库、NAS、服务器后台)直接暴露公网,做好鉴权、密码强口令;
  2. 公网暴露服务存在安全风险,仅限开发调试使用,不建议用于生产环境;
  3. 国内对外提供网站服务,需要完成 ICP 备案。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询