GitHub Pages 域名配置
默认域名
推送 main 分支后,CI/CD 自动部署到 GitHub Pages。
默认访问地址:
https://<username>.github.io/ljdou-docs自定义域名
1. 域名解析
在 DNS 服务商添加 CNAME 记录:
| 类型 | 主机记录 | 记录值 |
|---|---|---|
| CNAME | docs(或 @) | <username>.github.io |
2. 创建 CNAME 文件
在 public/ 目录下创建 CNAME 文件:
bash
echo "docs.yourdomain.com" > public/CNAME3. 启用 HTTPS
GitHub Settings → Pages → Custom domain → 填入域名 → 勾选 Enforce HTTPS。
4. 验证
部署完成后访问 https://docs.yourdomain.com 确认生效。
注意:
public/CNAME文件必须提交到仓库,每次部署时 VitePress 会将其复制到构建输出目录。