用 CNB + 帽子云,把静态博客跑起来

国外那几个 Git 仓库 + Cloudflare + Netlify 的组合,国内访问越来越抽风,有时候页面能打开但 Webhook 死活不通,构建状态转半天没反应而且用户访问也不友好。加上Makers 商业化不再按照次数计费后,我把手上的静态站部署到了 CNB 存代码、跑构建,帽子云托管页面。 :代码在 CNB,页面在帽子云,国内访问稳,静态站免费。

一、先理清谁干啥

  • CNB(cnb.cool):放仓库源码,写 .cnb.yml 跑流水线,负责把 前端项目构建成静态文件。
  • 帽子云(maoziyun.com):接 Git 仓库,拿构建产物对外提供服务,给 *.maozi.io 域名,也能绑自己的域名、自动 HTTPS而且还是免费的,唯一缺点就是每次要自己重新部署。

不买服务器,不配 Nginx,不自己管证书。

二、准备仓库

CNB 上建个组织,再建仓库,比如 my-blog。

纯静态(HTML/CSS/JS)直接推根目录 index.html 就行。

用 Hexo / Vite / 其他框架,正常放源码,构建完再交给帽子云。

以 Hexo 为例,本地结构不用变:

my-blog/
├── scaffolds/
├── source/
├── themes/
├── _config.yml
├── package.json
└── .cnb.yml

三、写 CNB 构建配置

仓库根目录新建 .cnb.yml:

main:
  push:
    - docker:
        image: node:20
      volumes:
        - /root/.npm:copy-on-write
      stages:
        - name: 安装依赖并构建
          script:
            - npm install --registry=https://registry.npmmirror.com
            - npx hexo clean
            - npx hexo generate

推到 main 就触发。

构建完,静态文件在 public/ 里。

纯 HTML 项目可以不用这段,帽子云直接读仓库根目录。

四、帽子云接 CNB 仓库

帽子云目前部署来源主要接 GitHub / Gitee / 公开 Git 仓库。

CNB 仓库设成「公开」,把仓库的 HTTPS 地址复制出来就能用。

  1. 打开 dash.maoziyun.com,注册登录
  2. 新建 → 静态网站
  3. 部署来源选「公开 Git 仓库」,填 CNB 仓库地址
  4. 分支填 main
  5. 构建命令:
    • 纯静态:留空
    • Hexo:npm install && npx hexo generate
  6. 输出目录:
    • 纯静态:./
    • Hexo:public
  7. 点部署

等几分钟,平台会给你一个 应用名-xxxx.maozi.io 的地址,打开就能看。

五、绑自己的域名

有短域名的话,这时候派上用场。

  1. 帽子云「域名证书」里申请证书(Let's Encrypt / ZeroSSL,自动续)
  2. 域名解析商加一条 CNAME,指向 cname.maozi-dns.com
  3. 帽子云「域名」里添加自定义域名,选证书
  4. 等 5–10 分钟生效

六、日常怎么用

以后写文章就是三件事:

git add .
git commit -m "写点东西"
git push

CNB 构建完,帽子云拉新产物,页面自动更新。

不用登服务器,不用手动传 FTP,不用管缓存刷新(帽子云自己有边缘节点)。

七、几个踩过的点

  • CNB 私有仓库帽子云拉不到,要么公开,要么以后走 CNB 构建完再传对象存储
  • 构建用 npx 别用全局 hexo,CI 环境更稳
  • npm 换 npmmirror 源,构建快一倍
  • 图片别塞仓库里太狠,大图走图床或 COS
  • 自定义域名没备案,大陆网络会绕、会慢

这套组合的意义不是「多牛」,是省心、省钱、能长期写。

代码在自己仓库里,构建在 CNB,页面在帽子云。

Makers 收不收费,不影响我继续发文章。

This article was updated on 十一月 15, 2026