专业服务 · 聪颖博客 —— 内容持续更新,欢迎指正。
工具推荐技术分享成长记录
在线咨询

GitHub Actions部署博客难吗,具体步骤有哪些?

技术分享分类
3551字数
0阅读
8分钟

结论:用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地址更新。

三个最容易翻车的细节

站点根路径
Hexo看_config.yml里的url和root,Hug
缓存键
setup-node的cache: npm依赖锁文件。没有p

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的问题。两者优化手段不一样。

构建慢和访问慢不是一回事

构建慢
依赖下载、镜像源、缓存没配。可在workflow里设置npm
访问慢
GitHub Pages的线路受运营商影响。据公开行业信息,

可落地的加速组合

  1. 构建层:用npm ci锁定依赖,开启setup-node缓存;Hugo加--minify;Hexo关掉不必要插件。
  2. 发布层:把仓库接到Cloudflare Pages、Netlify或Vercel做镜像构建,或给GitHub Pages前挂CDN。
  3. 国内访问:用对象存储加CDN回源,域名按国内要求备案;GitHub Pages保留为备用源。
  4. 监控层:定期检查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构建分钟数

泰州市喃彰坪鞋帽批发有限公司 苏ICP备2026071437号-3