为什么选择GitHub Pages + Hexo组合

限时 腾讯云新春特惠 — 轻量2核2G4M 576元99元/年 立即领取 →

如何用GitHub Pages和Hexo快速部署静态站点?

想搭建一个属于自己的网站,但又不想花钱买服务器?利用开源工具和免费托管服务,完全可以在不花一分钱的情况下完成个人网站的部署。这种方法尤其适合写博客、做作品集或搭建技术文档站。

爆款 腾讯云服务器 · 热销配置
限时优惠 | 个人专享
1.7折
轻量 2核2G4M
50GB SSD | 300GB流量
576元/年
99元/年
2.2折
轻量 2核4G6M
70GB SSD | 600GB流量
900元/年
199元/年
2.5折
轻量 4核8G10M
120GB SSD | 1500GB流量
2520元/年
630元/年
海外
海外 2核2G30M
东京/新加坡 | 1TB流量
576元/年
99元/年
查看全部优惠配置 →

对于没有后端经验的新手来说,静态站点生成器是入门的最佳选择。它们不需要数据库、不涉及复杂运维,还能享受CDN加速带来的访问速度提升。

  • 零成本运行:GitHub Pages为公开仓库提供免费托管,无需支付任何服务器费用
  • 高可用性:依托GitHub全球CDN网络,你的网站加载速度远超普通虚拟主机
  • 版本控制集成:所有内容自动纳入Git管理,修改历史清晰可追溯
  • 自动化部署:配合Actions可实现提交即上线,省去手动上传文件的麻烦

环境准备与工具安装

在开始之前,你需要在本地电脑上安装几个基础开发工具。这些工具不仅用于本次建站,也是现代前端开发的标准配置。

  1. 注册GitHub账号:访问github.com完成注册,这是整个流程的基础平台
  2. 安装Git:从git-scm.com下载对应系统的安装包,安装时保持默认选项即可
  3. 安装Node.js:前往nodejs.org下载LTS版本,这是运行Hexo的前提环境
  4. 验证安装结果:打开终端执行 node -v && npm -v,若显示版本号则说明安装成功

创建专属的GitHub Pages仓库

GitHub Pages要求特定命名格式的仓库才能启用自动托管功能,这一步必须准确无误。

买1年送3个月 腾讯云服务器 · 超值年付
限时活动 | 数量有限
轻量 2核2G4M
个人专享 | 免费续3个月
576元/年
99元/年
轻量 2核4G5M
个人专享 | 免费续3个月
780元/年
188元/年
轻量 4核8G12M
个人专享 | 免费续3个月
2760元/年
880元/年
CVM 2核2G S5
个企同享 | 免费续3个月
846元/年
245元/年
CVM 2核4G S5
个企同享 | 免费续3个月
2196元/年
637元/年
CVM 4核8G S5
个企同享 | 免费续3个月
4776元/年
1256元/年
立即领取买1年送3个月优惠 →

  • 登录GitHub后点击“New repository”创建新项目
  • 仓库名称必须设置为 用户名.github.io(将“用户名”替换为你的真实GitHub ID)
  • 选择公开(Public)权限,私有仓库无法使用免费托管服务
  • 初始化时无需添加README或.gitignore,后续由Hexo自动生成

使用Hexo初始化并配置站点

Hexo作为基于Node.js的静态站点框架,以其简洁的目录结构和丰富的主题生态著称。

  1. 在本地新建项目目录:mkdir my-blog && cd my-blog
  2. 全局安装Hexo CLI:npm install -g hexo-cli
  3. 初始化项目:hexo init,该命令会生成基础文件结构
  4. 安装依赖包:npm install
  5. 修改 _config.yml 中的 urlroot 字段,指向你的GitHub Pages地址

编写内容并生成静态页面

Hexo采用Markdown语法撰写文章,这种轻量级标记语言学习成本极低,专注于内容表达而非排版细节。

  • 创建新文章:hexo new "我的第一篇博客",系统会在 source/_posts 目录下生成md文件
  • 使用任意文本编辑器打开该文件,输入标题、摘要和正文内容
  • 本地预览效果:hexo server,浏览器访问 http://localhost:4000 查看渲染结果
  • 生成静态资源:hexo generate,输出文件将存放在 public 文件夹中

部署到GitHub Pages实现在线访问

最后一步是将生成的静态文件推送到远程仓库,让全世界都能看到你的网站。

长期特惠 腾讯云服务器 · 3年/5年机特惠
低至2折 | 省钱首选
2折
轻量 2核2G4M
个人专享 | 约9.8元/月
1728元/3年
353元/3年
2折
轻量 2核4G6M
个人专享 | 约14.7元/月
2700元/3年
528元/3年
5年
CVM SA2 AMD
高性价比 | 约17.4元/月
3400元/5年
1044元/5年
5年
CVM S5 Intel
稳定计算 | 约21.2元/月
4230元/5年
1269元/5年
查看长期特惠详情 →

  1. 安装部署插件:npm install hexo-deployer-git --save
  2. 在 _config.yml 中添加 deploy 配置:
    deploy:
      type: git
      repo: https://github.com/你的用户名/你的用户名.github.io.git
      branch: main
  3. 执行发布命令:hexo clean && hexo deploy
  4. 等待几秒钟后,访问 https://你的用户名.github.io 即可查看线上站点

进阶技巧:自定义域名与HTTPS支持

虽然默认的github.io域名可用,但绑定自定义域名能提升专业形象,并且GitHub原生支持HTTPS加密。

  • 在域名注册商处添加一条CNAME记录,指向 你的用户名.github.io
  • 在Hexo项目根目录创建 CNAME 文件(无扩展名),内容为你的完整域名,如 www.example.com
  • 重新部署后,GitHub会在后台自动申请Let's Encrypt证书,通常10分钟内生效
  • 启用强制HTTPS:进入仓库Settings → Pages → Enforce HTTPS,勾选即可

何时需要转向云服务器方案

尽管免费方案足够应对初期需求,但随着流量增长或功能扩展,你可能会遇到以下限制:

  • 每月100GB的流量上限,在高并发场景下容易触及瓶颈
  • 无法运行PHP、Python等动态脚本,限制了交互功能的实现
  • 构建时间超过10分钟会被中断,不适合大型站点持续集成

当出现上述情况时,建议迁移到专业的云服务器环境。目前针对新用户推出了极具性价比的入门级VPS套餐,支持按月付费、随时升降配。

GPU 腾讯云 · GPU服务器 & 爆品专区
AI算力 | 限量抢购
GPU GN6S
NVIDIA P4 | 4核20G
501元/7天
175元/7天
GPU GN7
NVIDIA T4 | 8核32G
557元/7天
239元/7天
GPU GN8
NVIDIA P40 | 6核56G
1062元/7天
456元/7天
香港 2核 Linux
独立IP | 跨境电商
38元/月
32.3元/月
查看GPU服务器详情 →

如果你正在考虑升级基础设施,不妨curl.qcloud.com/jEVGu7kK,最低配置的云服务器首年费用不到200元,还能享受免费备案协助和技术支持服务。

对于需要更高性能或企业级稳定性的用户,也可以curl.qcloud.com/jEVGu7kK,这些实例特别适合部署WordPress、Discuz!等主流建站程序。

FAQ

GitHub Pages支持哪些编程语言?
仅支持前端三件套(/CSS/JavaScript),不支持任何服务端语言如PHP、Python或Node.js后端应用。
能否用GitHub Pages搭建电商网站?
不适合直接搭建传统电商后台,但可通过集成第三方SaaS服务(如Shopify嵌入)实现商品展示和购买功能。
网站访问速度受地理位置影响吗?
GitHub的CDN节点主要分布在欧美地区,亚洲尤其是中国大陆用户访问可能存在延迟,对速度要求高的建议选择国内云服务商。
是否需要定期维护服务器?
GitHub Pages属于完全托管服务,无需关心操作系统更新、安全补丁等问题,真正实现免运维。
如何备份我的网站数据?
由于所有源码都存储在本地Git仓库中,只需定期推送至GitHub即可完成云端备份,恢复时克隆仓库重新生成即可。
推荐 腾讯云服务器 · 更多优惠配置
点击查看详情
轻量 2核2G4M
50GB SSD | 300GB流量
99元/年
轻量 2核4G6M
70GB SSD | 600GB流量
199元/年
海外 Linux 2核2G30M
东京/新加坡 | 1TB流量
99元/年
海外 Win 2核2G30M
东京/新加坡 | 1TB流量
99元/年
上云大礼包 1670元
代金券礼包
轻量服务器特惠
跨境电商服务器
查看全部优惠 | 领取专属礼包 →