1. 为什么需要自定义域名绑定很多开发者在使用cpolar时默认会获得一个类似xxx.cpolar.io的子域名。这个域名虽然能用但看起来不够专业也不利于品牌建设。想象一下你给客户演示项目时网址是project123.cpolar.io客户可能会觉得这是个临时测试地址。换成demo.yourcompany.com专业感立刻提升几个档次。我自己刚开始用cpolar时也图省事直接用系统分配的域名。直到有一次给投资人演示产品对方盯着那个xxx.cpolar.io的地址皱眉头我才意识到问题的严重性。第二天就赶紧研究怎么绑定自己的域名过程比想象中简单很多。绑定自定义域名还有个实际好处可以规避某些网络环境对公共域名的屏蔽。有些企业内网会屏蔽cpolar.io这类域名但很少会屏蔽你自己的业务域名。上周我帮一家医院部署内部系统时就遇到这种情况换成医院自己的his.xxx-hospital.com域名后所有终端访问立刻恢复正常。2. 域名保留与CNAME配置2.1 在cpolar后台保留域名登录cpolar控制台左侧菜单找到预留-保留自定义域名。这里有个关键点要注意选择地区时要考虑域名备案情况。国内业务选cn区需要已备案域名没备案的选hk或us区。我有次急着测试没注意选了cn区结果卡在备案验证这一步耽误了半天。输入要保留的完整域名比如dev.yourdomain.com。点击保留后系统会生成专属的CNAME地址长得像5983fcc1.cname.cpolar.io这样的字符串。建议立即复制保存我有次手快关掉了页面又得重新操作一遍。2.2 配置DNS解析现在去你的域名服务商后台添加CNAME记录。以阿里云为例进入云解析DNS控制台找到目标域名点击解析设置添加记录类型选CNAME主机记录填dev对应子域名前缀记录值粘贴刚才复制的cpolar地址这里有个常见坑点有些服务商要求记录值末尾加点号如5983fcc1.cname.cpolar.io.有些则不用。我在GoDaddy上配置时就因为这个点号问题解析死活不生效。建议先查下服务商的文档要求。# 验证解析是否生效 ping dev.yourdomain.com # 看到返回的IP包含cpolar的地址就说明成功了3. 解析生效与隧道创建3.1 等待解析生效DNS解析不是即时生效的通常要等5-10分钟。着急的话可以刷新本地DNS缓存# Windows ipconfig /flushdns # MacOS sudo dscacheutil -flushcache我习惯用dig命令检查解析状态比ping更准确dig dev.yourdomain.com trace3.2 创建带域名的隧道解析生效后用这个命令启动隧道cpolar http -hostnamedev.yourdomain.com 8080参数说明-hostname你的自定义域名8080本地服务端口测试时发现个细节如果8080端口被占用cpolar会自动尝试8081、8082等相邻端口。有次我本地开了多个服务没注意端口冲突结果域名一直连不上正确的服务排查了半天才发现这个问题。4. HTTPS证书配置实战4.1 获取SSL证书现在访问https://dev.yourdomain.com会看到证书警告因为用的是cpolar的默认证书。两种解决方案使用自有证书从云服务商申请免费证书阿里云/腾讯云都有1年期免费SSL证书自动生成证书某些DNS服务商如Cloudflare提供自动边缘证书我推荐Lets Encrypt免费证书用certbot工具自动续期sudo certbot certonly --manual --preferred-challengesdns -d dev.yourdomain.com4.2 带证书启动隧道拿到证书后通常得到cert.pem和privkey.pem这样启动隧道cpolar http -hostnamedev.yourdomain.com -crt/path/to/cert.pem -key/path/to/privkey.pem 8080证书路径建议用绝对路径。有次我用相对路径换了目录就报证书错误。还有个常见问题证书链不完整会导致某些浏览器报错。可以用这个命令检查openssl s_client -connect dev.yourdomain.com:443 -showcerts5. 高级配置与排错指南5.1 多子域名配置如果需要api.yourdomain.com、app.yourdomain.com等多个子域名在cpolar分别保留每个子域名DNS解析添加多条CNAME记录启动隧道时用-hostname指定对应域名# 同时运行多个隧道 cpolar http -hostnameapi.yourdomain.com 3000 cpolar http -hostnameapp.yourdomain.com 80805.2 常见问题排查解析不生效检查DNS配置是否正确特别是记录类型和值用在线DNS检测工具如dnschecker.org看全球解析状态确认域名没有设置其他冲突解析记录证书错误确保证书和私钥文件路径正确检查证书是否过期验证证书是否包含完整链包括中间证书连接超时确认cpolar客户端正常运行检查本地服务端口是否监听查看防火墙是否放行了cpolar的端口有次客户反馈域名访问时好时坏最后发现是他们本地网络策略会随机阻断.cpolar.io域名的连接。解决方案是在cpolar后台切换到企业版使用独立入口节点就彻底稳定了。
cpolar自定义域名绑定全攻略：从CNAME解析到HTTPS证书配置
发布时间：2026/7/26 9:45:23
1. 为什么需要自定义域名绑定很多开发者在使用cpolar时默认会获得一个类似xxx.cpolar.io的子域名。这个域名虽然能用但看起来不够专业也不利于品牌建设。想象一下你给客户演示项目时网址是project123.cpolar.io客户可能会觉得这是个临时测试地址。换成demo.yourcompany.com专业感立刻提升几个档次。我自己刚开始用cpolar时也图省事直接用系统分配的域名。直到有一次给投资人演示产品对方盯着那个xxx.cpolar.io的地址皱眉头我才意识到问题的严重性。第二天就赶紧研究怎么绑定自己的域名过程比想象中简单很多。绑定自定义域名还有个实际好处可以规避某些网络环境对公共域名的屏蔽。有些企业内网会屏蔽cpolar.io这类域名但很少会屏蔽你自己的业务域名。上周我帮一家医院部署内部系统时就遇到这种情况换成医院自己的his.xxx-hospital.com域名后所有终端访问立刻恢复正常。2. 域名保留与CNAME配置2.1 在cpolar后台保留域名登录cpolar控制台左侧菜单找到预留-保留自定义域名。这里有个关键点要注意选择地区时要考虑域名备案情况。国内业务选cn区需要已备案域名没备案的选hk或us区。我有次急着测试没注意选了cn区结果卡在备案验证这一步耽误了半天。输入要保留的完整域名比如dev.yourdomain.com。点击保留后系统会生成专属的CNAME地址长得像5983fcc1.cname.cpolar.io这样的字符串。建议立即复制保存我有次手快关掉了页面又得重新操作一遍。2.2 配置DNS解析现在去你的域名服务商后台添加CNAME记录。以阿里云为例进入云解析DNS控制台找到目标域名点击解析设置添加记录类型选CNAME主机记录填dev对应子域名前缀记录值粘贴刚才复制的cpolar地址这里有个常见坑点有些服务商要求记录值末尾加点号如5983fcc1.cname.cpolar.io.有些则不用。我在GoDaddy上配置时就因为这个点号问题解析死活不生效。建议先查下服务商的文档要求。# 验证解析是否生效 ping dev.yourdomain.com # 看到返回的IP包含cpolar的地址就说明成功了3. 解析生效与隧道创建3.1 等待解析生效DNS解析不是即时生效的通常要等5-10分钟。着急的话可以刷新本地DNS缓存# Windows ipconfig /flushdns # MacOS sudo dscacheutil -flushcache我习惯用dig命令检查解析状态比ping更准确dig dev.yourdomain.com trace3.2 创建带域名的隧道解析生效后用这个命令启动隧道cpolar http -hostnamedev.yourdomain.com 8080参数说明-hostname你的自定义域名8080本地服务端口测试时发现个细节如果8080端口被占用cpolar会自动尝试8081、8082等相邻端口。有次我本地开了多个服务没注意端口冲突结果域名一直连不上正确的服务排查了半天才发现这个问题。4. HTTPS证书配置实战4.1 获取SSL证书现在访问https://dev.yourdomain.com会看到证书警告因为用的是cpolar的默认证书。两种解决方案使用自有证书从云服务商申请免费证书阿里云/腾讯云都有1年期免费SSL证书自动生成证书某些DNS服务商如Cloudflare提供自动边缘证书我推荐Lets Encrypt免费证书用certbot工具自动续期sudo certbot certonly --manual --preferred-challengesdns -d dev.yourdomain.com4.2 带证书启动隧道拿到证书后通常得到cert.pem和privkey.pem这样启动隧道cpolar http -hostnamedev.yourdomain.com -crt/path/to/cert.pem -key/path/to/privkey.pem 8080证书路径建议用绝对路径。有次我用相对路径换了目录就报证书错误。还有个常见问题证书链不完整会导致某些浏览器报错。可以用这个命令检查openssl s_client -connect dev.yourdomain.com:443 -showcerts5. 高级配置与排错指南5.1 多子域名配置如果需要api.yourdomain.com、app.yourdomain.com等多个子域名在cpolar分别保留每个子域名DNS解析添加多条CNAME记录启动隧道时用-hostname指定对应域名# 同时运行多个隧道 cpolar http -hostnameapi.yourdomain.com 3000 cpolar http -hostnameapp.yourdomain.com 80805.2 常见问题排查解析不生效检查DNS配置是否正确特别是记录类型和值用在线DNS检测工具如dnschecker.org看全球解析状态确认域名没有设置其他冲突解析记录证书错误确保证书和私钥文件路径正确检查证书是否过期验证证书是否包含完整链包括中间证书连接超时确认cpolar客户端正常运行检查本地服务端口是否监听查看防火墙是否放行了cpolar的端口有次客户反馈域名访问时好时坏最后发现是他们本地网络策略会随机阻断.cpolar.io域名的连接。解决方案是在cpolar后台切换到企业版使用独立入口节点就彻底稳定了。
