乔木网站开发自动化部署

一键完成从代码推送到域名上线及 HTTPS 验证的全流程。

详细介绍

qiaomu-website-develop

你说“用这个域名部署一下”，Agent 就按固定流程完成 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证。

适用场景

网站发布时，需要自动化部署到 Vercel 并绑定自定义域名

需要确保 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证的完整流程无误

效果预览

已验证样例：

项目
结果

GitHub
https://github.com/joeseesun/qiaomu-artist-style

Vercel project
qiaomu-artist-style

Vercel URL
https://qiaomu-artist-style.vercel.app

Custom domain
https://style.qiaomu.ai

Cloudflare DNS
TXT 验证 + 非代理 CNAME

最终验证
curl -I https://style.qiaomu.ai 返回 HTTP/2 200

核心能力

检查 CLI 登录状态

本地构建项目

推送代码到 GitHub

在 Vercel 中 link、deploy、连接 Git 仓库

添加自定义域名到 Vercel

在 Cloudflare 中写入 TXT、CNAME、A 记录

执行 Vercel 域名验证

通过 curl 验证 HTTPS 访问是否正常

工作方式

用户用自然语言提出部署请求，例如：“把这个网站发布到 Vercel，并绑定 style.qiaomu.ai ”

Agent 按照固定流程依次执行：检查 CLI 登录 → 本地构建 → GitHub 推送 → Vercel link/deploy/git connect → Vercel 添加域名 → Cloudflare 写 DNS 记录 → Vercel verify → curl 验证 HTTPS

最终输出部署成功的 URL 和验证结果

你需要提供

安装并登录 GitHub CLI： brew install gh && gh auth login

安装并登录 Vercel CLI： npm i -g vercel && vercel login

安装并登录 Wrangler： npm i -g wrangler && wrangler login

Cloudflare DNS 写入时，设置 CLOUDFLARE_API_TOKEN 或 CF_API_TOKEN

Cloudflare API token 至少具备目标 zone 的 zone read 和 DNS edit/write 权限

你会获得

部署后的 Vercel 项目

自定义域名绑定成功

HTTPS 验证通过，可通过 curl -I 获得 HTTP/2 200 响应

使用示例

把这个项目部署到 Vercel，绑定 style.qiaomu.ai，并关联 GitHub。

以后这个 Web 项目用 Cloudflare Pages 发布，域名用 demo.qiaomu.ai。

这个域名在 Cloudflare 托管，你直接用 CLI 帮我设置到 Vercel 项目上。

内置自动化脚本

先 dry-run：

python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
–project-dir . \
–domain style.qiaomu.ai \
–dry-run

执行 Vercel + Cloudflare 绑定：

export CLOUDFLARE_API_TOKEN="…"
python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
–project-dir . \
–domain style.qiaomu.ai \
–ensure-link \
–connect-git \
–deploy \
–wait \
–check-http

注意事项

安全

不要把 API token 写入仓库、README、脚本或聊天总结。如果 token 曾经被贴出来，用完后建议到 Cloudflare 里轮换。

常见问题

问题
处理

wrangler whoami 正常但 DNS 写入失败
Wrangler OAuth 不等于脚本可写 DNS。设置 Cloudflare API token，并给目标 zone 的 zone read 和 DNS edit/write 权限。

Vercel 显示 domain verification required
让脚本写入 Vercel 返回的 TXT 记录，然后重新调用 verify。

Vercel 显示 DNS misconfigured
检查同名 A/AAAA/CNAME 冲突；Vercel 子域名 CNAME 默认应关闭 Cloudflare proxy。

apex 域名不能设置 CNAME
apex 用 Vercel 推荐的 A 记录；子域名才用 CNAME。

试试这样做

• 把这个项目部署到 Vercel，绑定 style.qiaomu.ai，并关联 GitHub。
• 以后这个 Web 项目用 Cloudflare Pages 发布，域名用 demo.qiaomu.ai。
• 这个域名在 Cloudflare 托管，你直接用 CLI 帮我设置到 Vercel 项目上。

作者：乔木 产品经理，拥有 180+ repos çš„é«˜äº§åˆ›ä½œè€ ｜ GitHub Stars 9 ｜ 标签：编程开发 发布分发 已认证 开源许可: MIT

来源：colaos.ai ｜ Skill ID：qiaomu-website-develop