Skip to content

GitHub Pages 域名配置

默认域名

推送 main 分支后,CI/CD 自动部署到 GitHub Pages。

默认访问地址:

https://<username>.github.io/ljdou-docs

自定义域名

1. 域名解析

在 DNS 服务商添加 CNAME 记录:

类型主机记录记录值
CNAMEdocs(或 @<username>.github.io

2. 创建 CNAME 文件

public/ 目录下创建 CNAME 文件:

bash
echo "docs.yourdomain.com" > public/CNAME

3. 启用 HTTPS

GitHub Settings → Pages → Custom domain → 填入域名 → 勾选 Enforce HTTPS。

4. 验证

部署完成后访问 https://docs.yourdomain.com 确认生效。

注意public/CNAME 文件必须提交到仓库,每次部署时 VitePress 会将其复制到构建输出目录。

基于 VitePress 构建