You need to enable JavaScript to run this app. 为何Docusaurus+Travis CI部署GitHub Pages时自定义域名总会被清除?
优惠活动
大模型
产品
解决方案
定价
更多

为何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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 00:36:04