注意需要升级至专业套餐或以上才支持配置自定义域名
1. 保留自定义域名
登录cpolar官网后台,点击左侧的预留 –> 保留自定义域名 选项卡下:
- 地区:请根据实际情况选择
- 域名:输入您的域名,本例为
dev.bestexpresser.com - 描述:可自定义备注
点击保留按钮。

1. 关于服务器地区的选择:
大陆地区有China、China vip、China Top、China VIP Top、China NAS地区;
海外地区有United States、Hong Kong、Taiwan、Europe地区.
2. 关于自定义域名备案问题:
如服务器选择大陆地区,所有自定义域名都需要提前已备案,才能部署;
如服务器选择海外地区,则不需要备案。
自定义域名保留成功后,系统会生成相应的CNAME目标地址,将其复制下来

2. 自定义域名解析
在您自己的域名提供商,DNS解析中,加入一条CNAME记录。在此示例中:
假设本示例中的域名bestexpresser.com是在阿里云注册的,则我们需要登录阿里云,在阿里云的云解析DNS里,bestexpresser.com域名下,添加一条CNAME记录。

- 设置记录类型为
CNAME - 名称:
dev - 记录值:
5983fcc1.cname.cpolar.io
点击确认

添加后的效果,解析生效需要等待10分钟

大约5-10分钟后,ping您的自定义域名(dev.bestexpresser.com),看是否已经解析到了cpolar提供cname地址
ping dev.bestexpresser.com

如果ping返回的地址中,包含cpolar的cname地址,说明已经解析成功。
3. 编辑cpolar配置文件
配置文件路径
/usr/local/etc/cpolar/cpolar.yml
需要在指定隧道下添加hostname参数:
authtoken: xxxxxxxxxx
tunnels:
website:
proto: http
addr: 8080
hostname: dev.bestexpresser.com
region: us
保存配置文件退出
重新启动cpolar服务
sudo systemctl restart cpolar
然后查看官网—状态,域名在线即可访问

注意:此时通过HTTPS访问自定义域隧道仍然有效,但证书不匹配。接下来,我们来添加证书。
4. 配置SSL证书
当使用自己的自定义域名时,您可能无法访问公开的https服务,因为HTTPS证书不同。 cpolar客户端可以轻松为您完成此操作,使您可以端到端加密通迅,而不必担心本地服务是否具有HTTPS支持。 您只需要在命令行中指定-crt和-key两个参数,以指定TLS证书和密钥的文件系统路径,cpolar客户端将负责为您握手TLS连接。
自定义域名的HTTPS证书,您可以从DNS运营商那里免费获得或购买。
如果您已经有了TLS证书/密钥对,您可以尝试使用按如下命令创建自定义域名隧道。
cpolar http -hostname=dev.bestexpresser.com -key=/path/to/tls.key -crt=/path/to/tls.crt 8080
参数说明:
hostname: 您的自定义域名
crt: HTTPS证书文件路径(全路径)
key: HTTPS证书密钥文件路径(全路径)
8080:本地web服务器侦听端口
配置成功,您即可以使用配置了SSL证书的自定义域名访问本地站点了。
ctrl+C 关闭隧道,如需长期运行,请将其配置为后台服务。
5. 编辑cpolar配置文件
需要在指定隧道下添加crt以及key参数:
authtoken: xxxxxxxxxx
tunnels:
website:
proto: http
addr: 8080
hostname: dev.bestexpresser.com
region: us
crt: /path/to/tls.crt
key: /path/to/tls.key
保存配置文件退出
重新启动cpolar服务
sudo systemctl restart cpolar



