部署到 Cloudflare Pages
这个学习站是 MkDocs 静态网站,适合部署到 Cloudflare Pages。
方式一:连接 GitHub 仓库
- 把当前项目推送到 GitHub 私有仓库。
- 打开 Cloudflare Dashboard。
- 进入
Workers & Pages。 - 选择
Create application->Pages->Connect to Git。 - 选择你的仓库。
- 构建设置:
| 项目 | 值 |
|---|---|
| Framework preset | MkDocs |
| Build command | pip install -r requirements.txt && mkdocs build |
| Build output directory | site |
- 部署成功后,会得到一个
*.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 站点加访问控制。