配置自定义域名

注意需要升级至专业套餐或以上才支持配置自定义域名

1. 保留自定义域名

登录cpolar官网后台，点击左侧的预留 –> 保留自定义域名 选项卡下：

  • 地区：请根据实际情况选择
  • 域名：输入您的域名，本例为dev.bestexpresser.com
  • 描述：可自定义备注

点击保留按钮。

1.0-QQ20210707-063917@2x

1. 关于服务器地区的选择：

   大陆地区有China、China vip、China Top、China VIP Top、China NAS地区;
   海外地区有United States、Hong Kong、Taiwan、Europe地区.

2. 关于自定义域名备案：

   如服务器选择大陆地区，所有自定义域名都需要提前已备案，才能部署;
   如服务器选择海外地区，则不需要备案，也无需过白名单步骤。

3. 关于域名过白名单：

   如您的域名已备案，可以部署在大陆地区：
     – 如选择cn、cn_top、cn_vip_top地区，域名自动过白名单；
     – 如选择cn_vip、cn_nas地区，域名需要人工过白名单，请联系官网在线客服人员或者官网QQ，让他帮您提交过白申请。
   如您的域名未备案，请使用海外地区：us、hk、tw、eu地区，则不需要域名过白名单步骤。

自定义域名保留成功后，系统会生成相应的CNAME目标地址，将其复制下来

2.0-QQ20210707-065455@2x

2. 自定义域名解析

在您自己的域名提供商，DNS解析中，加入一条CNAME记录。在此示例中：

假设本示例中的域名bestexpresser.com是在阿里云注册的，则我们需要登录阿里云，在阿里云的云解析DNS里，bestexpresser.com域名下，添加一条CNAME记录。

3-QQ20210707-065800@2x

  • 设置记录类型为CNAME
  • 名称: dev
  • 记录值: 5983fcc1.cname.cpolar.io

点击确认

4-QQ20210707-065949@2x

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

5-QQ20210707-070041@2x

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

ping dev.bestexpresser.com

6-QQ20210707-071908@2x

如果ping返回的地址中，包含cpolar的cname地址，说明已经解析成功。

3. 创建自定义域名隧道

注意请使用-hostname参数，值为您的域名

cpolar http -hostname=dev.bestexpresser.com 8080

配置成功，您现在就可以用dev.bestexpresser.com自定义域名访问本地站点了。

ctrl+C 关闭隧道，如需长期运行，请将其配置为后台服务。

4. 编辑cpolar配置文件

需要在指定隧道下添加hostname参数:

authtoken: xxxxxxxxxx
tunnels:
  website:
    proto: http
    addr: 8080
    hostname: dev.bestexpresser.com
    region: us

保存配置文件退出

5. 测试配置文件

cpolar start website

如图，说明配置成功

20221227154213

重新启动cpolar服务

sudo systemctl restart cpolar

注意：此时通过HTTPS访问自定义域隧道仍然有效，但证书不匹配。接下来，我们来添加证书。

6. 配置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 关闭隧道，如需长期运行，请将其配置为后台服务。

7. 编辑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 start website

如正常显示即为配置成功

重新启动cpolar服务

sudo systemctl restart cpolar

发表回复