MkDocs 复盘 - 自定义域名⚓︎
这是有关于 MkDocs-Material 自定义域名的部分使用记录。
自定义域名⚓︎
步骤⚓︎
- 购买一个域名,可以在阿里云,腾讯云,华为云,以及国外的 namecheap 等等。
- 进行 DNS 解析,添加解析记录。
- 在本地仓库中添加 CNAME 文件(无后缀名,全大写文件名),里面可以是 www.yourdomain.com 也可以是 yourdomain.com。这个内容取决于添加的解析记录。
- 然后在仓库的 Pages 页面设置自定义域名,点击 Save。
DNS 提示
- 购买域名和 DNS 解析,不是同一个东西,你购买域名后,要使用 DNS 解析,才能生效。对于 github pages 来说,最好选可以免费 4 条以上的负载均衡的 DNS 解析。虽然只使用 www | CNAME | username.github.io 也可以运行,但是为了稳定(安全),开启 HTTPS 会更好,需要针对 github 的四个 ip 添加记录,所以建议使用负载均衡可以 4 条及以上的 DNS 解析,参考表格-正常的 DNS 解析记录。
- 如果你不幸选择了腾讯云(DNS 免费只有 2 条负载均衡,不知道为什么,不知道它有什么优势,第一次使用),那么参考表格-腾讯云 DNS 解析记录,可以使用此方式曲线救国,但是根据 AI 的建议,可能会不稳定(不懂,没深究,反正能跑,且 github pages 显示成功)。
正常的 DNS 解析记录⚓︎
主机记录 | 记录类型 | 记录值 |
---|---|---|
www |
CNAME | username.github.io |
@ |
A 记录 | 185.199.108.153 |
@ |
A 记录 | 185.199.109.153 |
@ |
A 记录 | 185.199.110.153 |
@ |
A 记录 | 185.199.111.153 |
腾讯云 DNS 解析记录⚓︎
主机记录 | 记录类型 | 记录值 |
---|---|---|
www |
CNAME | username.github.io |
a1 |
A 记录 | 185.199.108.153 |
a1 |
A 记录 | 185.199.109.153 |
a2 |
A 记录 | 185.199.110.153 |
a2 |
A 记录 | 185.199.111.153 |
@ |
CNAME | a1.yourdomain.com |
@ |
CNAME | a2.yourdomain.com |