结论:用GitHub Actions部署静态博客,最稳的做法是把“构建”和“发布”拆成两个作业,源码推送到主分支后自动生成静态文件并发布到GitHub Pages,个人博客的CI现金成本多数情况下可以控制在0到几十元。这套方案适合Hexo、Hugo、Jekyll这类静态站点,不适合需要数据库和常驻进程的动态博客。下面按落地顺序拆开讲,命令和路径都能直接对照。
GitHub Actions部署博客教程:从零跑通自动发布
先把仓库结构定下来,再写workflow。顺序反了,后面改路径会很折腾。
仓库、分支和Pages设置
- 源码放
main分支,构建产物不要提交到源码分支。 - 发布方式选GitHub Pages官方制品,不额外维护
gh-pages分支也可以。 - 在仓库
Settings > Pages > Source里选GitHub Actions。 - 自定义域名把
CNAME文件放在源码根目录,Hexo用户通常放source/CNAME。
本地先确认能构建:Hexo执行npx hexo generate,Hugo执行hugo --minify,Jekyll执行bundle exec jekyll build。产物目录分别是public、public、_site。这一步别省,本地失败就别指望云端能过。
workflow文件怎么写
在仓库根目录建.github/workflows/deploy.yml。下面这份以Hexo为例,Hugo和Jekyll只需改构建命令和path。
name: Deploy Blog
on:
push:
branches: [main]
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: pages
cancel-in-progress: true
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
cache: npm
- run: npm ci
- run: npx hexo generate
- uses: actions/upload-pages-artifact@v3
with:
path: public
deploy:
needs: build
runs-on: ubuntu-latest
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4
据GitHub官方文档,workflow必须放在.github/workflows目录,权限要在permissions里显式声明。发布作业依赖构建作业,靠needs: build串起来。你把文章推一次main,Actions页面会出现运行记录,构建完成后Pages地址更新。
三个最容易翻车的细节
GitHub Actions和Jenkins部署博客哪个好?小团队选型对比
如果博客只是个人内容站,行业共识认为优先托管型CI。Jenkins更适合已有内网服务器、需要复杂流水线或强内网控制的团队。业内专家指出,博客部署的频率通常低于业务系统,流水线复杂度不是首要矛盾。
| 对比项 | GitHub Actions | Jenkins |
|---|---|---|
| 托管与维护 | 托管型,免服务器维护 | 自建服务器,插件和安全补丁要管 |
| 触发方式 | 推送、PR、定时、手动 | 轮询、Webhook、手动,需配置 |
| 构建环境 | 官方runner,环境干净 | 节点可控,依赖要自己装 |
| 生态 | Marketplace动作多,YAML入库 | 插件丰富,但版本兼容要试 |
| 成本 | 公开仓库通常不产生Actions账单 | 服务器和运维人力是隐性成本 |
| 适合场景 | 个人博客、小团队静态站 | 内网系统、复杂发布链路 |
维护成本和触发方式怎么取舍
- GitHub Actions把配置放进仓库,换人接手看YAML就能懂,回滚也直观。
- Jenkins要维护主节点、构建节点、插件升级,博客量级下性价比不高。
- 如果代码必须留在内网,Jenkins或自建runner更合适;公开博客没必要。
国内访问GitHub Actions部署博客速度慢怎么解决
先分清两件事:构建慢,是runner在境外拉依赖;访问慢,是Pages线路和CDN的问题。两者优化手段不一样。
构建慢和访问慢不是一回事
可落地的加速组合
- 构建层:用
npm ci锁定依赖,开启setup-node缓存;Hugo加--minify;Hexo关掉不必要插件。 - 发布层:把仓库接到Cloudflare Pages、Netlify或Vercel做镜像构建,或给GitHub Pages前挂CDN。
- 国内访问:用对象存储加CDN回源,域名按国内要求备案;GitHub Pages保留为备用源。
- 监控层:定期检查DNS、证书和404,别等读者反馈才发现线路变了。
成本与选型:个人博客用GitHub Actions自动部署多少钱
免费额度和隐性成本
按GitHub公开的计费规则,公开仓库的标准runner通常不产生Actions账单;私有仓库有月度免费分钟数,超出按分钟计费。个人博客每次构建多在几分钟内,每月推送次数有限,较大比例用户不会触发付费。现金支出主要在域名和CDN流量,域名按注册商报价,CDN按流量阶梯计费。隐性成本是备案时间、证书维护和排错精力。
什么情况该换方案
- 私有仓库构建量很大,分钟数接近上限:考虑自建runner或换托管CI。
- 国内访问要求稳定低延迟:优先对象存储加CDN,或换国内托管平台。
- 博客要评论、搜索、会员等动态能力:静态站加第三方服务,或直接上动态CMS。
把构建和发布拆开、把缓存和权限配好,GitHub Actions部署博客对个人站点来说足够省心。真正决定读者体验的往往不是流水线,而是发布线路和内容更新频率。
GitHub Actions部署博客常见问题解答
GitHub Actions部署博客需要自己买服务器吗?
不需要。静态博客由GitHub Pages托管,Actions只负责构建和发布。绑定自定义域名时,按Pages文档配置CNAME和DNS即可。需要数据库和后台进程的动态博客才要服务器。
私有仓库用GitHub Actions部署博客会不会很快超出免费额度?
看单次构建时长和推送频率。私有仓库按账户套餐赠送月度分钟数,超出后按分钟计费。个人博客如果每次构建在几分钟内、每天推送次数不多,多数情况在额度内;大量提交或长时间构建才需要关注账单。
GitHub Actions自动部署Hexo博客和Hugo博客步骤差别大吗?
流程一样,命令和产物目录不同。Hexo用npx hexo generate,产物在public;Hugo用hugo --minify,产物也在public;Jekyll用bundle exec jekyll build,产物在_site。改workflow里的构建命令和upload-pages-artifact的path即可。公开仓库的Actions构建分钟数