跳转至

部署到 Cloudflare Pages

这个学习站是 MkDocs 静态网站,适合部署到 Cloudflare Pages。

方式一:连接 GitHub 仓库

  1. 把当前项目推送到 GitHub 私有仓库。
  2. 打开 Cloudflare Dashboard。
  3. 进入 Workers & Pages
  4. 选择 Create application -> Pages -> Connect to Git
  5. 选择你的仓库。
  6. 构建设置:
项目
Framework preset MkDocs
Build command pip install -r requirements.txt && mkdocs build
Build output directory site
  1. 部署成功后,会得到一个 *.pages.dev 地址。

绑定自己的域名

在 Pages 项目中进入 Custom domains,添加你的域名或子域名,例如:

study.example.com

如果域名已经托管在同一个 Cloudflare 账号下,Cloudflare 会自动创建需要的 DNS 记录。

方式二:本地用 Wrangler 发布

先构建:

.venv/bin/mkdocs build

然后发布:

npx wrangler pages deploy site --project-name money-banking-study

首次运行会要求登录 Cloudflare。

注意

  • .env 不要上传,里面可能包含 Telegram token。
  • PDF、EPUB、MOBI 原始书籍文件不建议公开上传到 GitHub 或网站。
  • 对外网站只发布学习讲解、摘要、考点、练习和案例。
  • 如果想保护隐私,可以在 Cloudflare Zero Trust 里给 Pages 站点加访问控制。