GitHub Pages 托管
· 2 min read
参考
托管静态资源到GithubPage
- 通过github action， 从action产物部署
- 推送到 gh-pages, 从分支部署
两种部署模式对比
- 分支推送模式：生成 gh-pages 分支，GitHub 自动从该分支拉取内容
- 直接部署模式：通过 upload-pages-artifact + deploy-pages 直接托管，无需维护分支
常见问题排查
错误信息：Branch "main" is not allowed to deploy due to environment protection rules
- 进入仓库设置：Settings → Environments → github-pages
- 修改 Deployment branches：允许 main 分支
- 关闭 Required reviewers 或添加审批者（如有必要）
部署后显示 404
- 检查构建路径是否正确（如 Docusaurus 默认输出到 build 文件夹）
- 验证仓库设置的 Pages 来源：Settings → Pages → Build and deployment → Branch