嘿，我来帮你解决这个GitHub Pages自定义域名的问题～你现在遇到的404问题，核心原因是只配置了DNS的CNAME记录，但没在GitHub仓库里把自定义域名和你的Pages站点绑定起来，GitHub不知道该把你的域名指向哪个仓库的内容。下面分两种场景给你说具体的解决方法：

场景一：想让www.mydomain.site直接显示仓库Pages的内容（根域名访问） #

这是最理想的情况，用户输入你的自定义域名就能直接看到原myusername.github.io/my-repo的内容，地址栏全程显示你的域名：

• 打开你的GitHub仓库，进入「Settings」→「Pages」页面
• 在「Custom domain」输入框里，填写你的自定义域名 www.mydomain.site，然后点击「Save」
• 这时候GitHub会自动在你的仓库根目录生成一个名为CNAME的文件，内容就是你填的域名。如果你的项目是静态站点（比如用Jekyll），要确保这个文件被提交到仓库，别被.gitignore忽略了
• 等待DNS生效（一般几分钟到几小时，快的话5分钟就行），之后访问www.mydomain.site就能直接看到原仓库Pages的内容了

场景二：接受访问www.mydomain.site/my-repo来显示内容 #

如果只是想让自定义域名的子路径对应仓库内容，也可以这么操作：

• 同样先在仓库「Settings」→「Pages」里设置「Custom domain」为www.mydomain.site，保存后生成CNAME文件
• 检查你的站点资源路径：所有CSS、JS、图片等链接都要用相对路径（比如用./style.css而不是/my-repo/style.css），这样在子路径下访问时资源能正常加载
• 如果你用了静态站点生成器（比如Jekyll），需要在配置文件里设置baseurl: "/my-repo"，这样生成的所有链接都会自动带上这个前缀，适配自定义域名的子路径
• 等配置和DNS生效后，访问www.mydomain.site/my-repo就能正常显示内容，地址栏保持你的自定义域名

额外注意事项 #

• 确认DNS的CNAME记录配置正确：类型选CNAME，主机记录填www，指向地址是myusername.github.io，TTL建议设为300（5分钟）加快生效速度
• 不要同时给www.mydomain.site设置A记录和CNAME记录，会导致冲突
• 如果测试时还是404，可以清空浏览器缓存，或者用无痕模式访问，避免缓存影响
• 可以在仓库的「Settings」→「Pages」页面查看配置状态，GitHub会提示是否有域名配置错误

备注：内容来源于stack exchange，提问作者Vlad Mashkautsan