为何Docusaurus+Travis CI部署GitHub Pages时自定义域名总会被清除?
自定义域名反复被清空的核心原因
这个自定义域名配置反复清空的问题,核心原因是Travis CI的部署动作全量覆盖了gh-pages分支文件,把GitHub用来记录自定义域名的CNAME文件直接删掉了:
GitHub会把你在仓库设置页填写的自定义域名,存储为gh-pages分支根目录下一个无后缀的CNAME文件,文件内容就是域名本身。当Travis CI把本地构建生成的静态文件全量推送到分支时,默认会清空分支原有内容再写入新文件,自然会把这个CNAME文件冲掉,GitHub检测不到对应文件就会自动重置你的自定义域名配置。
仓库命名相关的现象说明
你之前切换仓库名时观察到的发布路径差异,完全是GitHub Pages的固定规则,和域名丢失问题没有因果关系:
- 仓库名匹配
[你的用户名].github.io格式时,属于用户专属站点,构建产物会直接发布到站点根路径,不存在子路径层级 - 其他命名的普通仓库属于项目站点,构建产物会自动发布到
/[仓库名]/的子路径下
一次性解决的实操步骤
- 不需要每次构建完成后手动去设置页填域名,直接在Docusaurus项目的
static/静态资源目录下,新建一个无后缀的CNAME文件 - 往这个文件里写入你的自定义域名内容,也就是
myproject.com - Docusaurus构建时会自动把
static/目录下的所有文件原样复制到最终静态产物的根目录,Travis CI推送部署时会自动把这个CNAME文件带上,不会出现被覆盖删除的情况 - 完成一次正常部署后,在域名DNS服务商处配置对应的CNAME解析指向你的GitHub Pages默认地址即可,后续所有自动构建都不会再清空域名配置
额外注意:如果当前仓库是普通项目站点(非[用户名].github.io命名),需要在Docusaurus的配置文件里把url字段改成你的自定义域名,把baseUrl字段改成/,不然自定义域名绑定后会出现静态资源404的问题。
内容的提问来源于stack exchange,提问作者neubert
相关产品推荐
相关产品推荐

