部署到 GitHub Pages

2026-06-17

概述

GitHub Pages 是 GitHub 提供的免费静态网站托管服务。 本文将一步一步教你如何将 Furida 博客部署到 GitHub Pages, 并在中国大陆地区实现快速访问。

部署步骤

步骤 1: 准备仓库

  1. 确保你已经创建了 furida 仓库
  2. 将所有项目文件 push 到仓库的 main 分支
  3. 验证所有文件都已上传

步骤 2: 启用 GitHub Pages

  1. 访问仓库设置:Settings
  2. 在左侧菜单找到 Pages
  3. Source 下选择 Deploy from a branch
  4. 选择分支为 main
  5. 选择文件夹为 / (root)
  6. 点击 Save

步骤 3: 等待部署完成

GitHub 会自动构建和部署你的网站,通常需要 1-5 分钟。 你可以在 Actions 标签中查看部署进度。

步骤 4: 访问你的博客

部署完成后,你可以访问:

https://yixuanliu483-creator.github.io/furida/

yixuanliu483-creator 替换为你的 GitHub 用户名。

国内加速方案

方案 A: 使用 jsDelivr CDN (推荐)

jsDelivr 是一个全球 CDN,在中国有节点。

优点: 自动加速,无需配置

访问地址:

https://cdn.jsdelivr.net/gh/yixuanliu483-creator/furida@main/

方案 B: 使用 Cloudflare CDN

Cloudflare 也在中国有节点,提供免费加速。

  1. 注册 Cloudflare 账户
  2. 添加你的自定义域名
  3. 按照指导更改 DNS
  4. 启用 Cloudflare 的加速功能

方案 C: 国内 CDN (需付费)

如果你需要最快的速度,可以考虑国内 CDN:

  • 阿里云 CDN
  • 腾讯云 CDN
  • 又拍云

自定义域名 (可选)

如果你想使用自己的域名:

  1. 在项目根目录创建 CNAME 文件
  2. 添加你的域名,例如:myblog.com
  3. Push 到 GitHub
  4. 更新域名的 DNS 记录指向 GitHub Pages
  5. 在仓库设置中验证自定义域名

故障排查

问题 1: Pages 无法加载

解决方案:

  • 检查仓库是否为公开
  • 检查 Settings > Pages 是否已正确配置
  • 检查文件是否正确上传到 main 分支
  • 清除浏览器缓存并重新加载

问题 2: 404 Not Found

解决方案:

  • 检查文件路径是否正确
  • 确认 index.html 存在于根目录
  • 检查内部链接的相对路径

问题 3: 中国访问缓慢

解决方案:

  • 使用 jsDelivr 或 Cloudflare CDN
  • 优化图片大小
  • 启用 gzip 压缩
  • 考虑使用国内 CDN

性能优化

1. 优化图片

使用在线工具或本地工具压缩图片大小,减少加载时间。

2. 缩小 CSS 和 JS

使用 minifier 工具减小文件大小。

3. 启用缓存

配置 HTTP 缓存头,让浏览器缓存静态文件。

4. 使用 CDN

通过 CDN 分发内容,加快全球访问速度。

监控和维护

检查部署状态

  1. 访问仓库的 Actions 标签
  2. 查看最新部署的状态
  3. 检查是否有错误或警告

更新内容

每次你 push 新的更改到 main 分支时,GitHub Pages 会自动重新部署。 通常需要 1-5 分钟生效。

总结

现在你已经成功将博客部署到网络上! 你可以:

  • 分享博客链接给朋友和家人
  • 继续添加新文章
  • 集成更强大的 AI 功能
  • 自定义域名和样式

相关资源

← 上一篇 返回首页 →