哈喽大家好我是阿星实测一个部署 Skill 后我把 Next.js 静态主页发布到了 Cloudflare Pages。很多人第一次看到这类“一键部署” Skill都会有一个很自然的疑问Cloudflare 不是要账号、Token、Account ID 吗为什么命令里什么都没填网站就能上线 ㅤ我这次拿本地的homepage项目做了一次完整实测。它是一个 Next.js 主页但已经通过静态导出生成了out/目录。最终网站上线在ㅤㅤ原有的xxxx.work自定义域名没有被覆盖DNS 也没有改。更重要的是这次在国内网络环境下也实际打开验证过。先说结论 “不用填 Cloudflare 参数”不等于“不需要 Cloudflare 账号”而是把认证和部署参数拆开了。首次通过浏览器登录授权之后 Wrangler 会在本机复用这个授权Skill 再负责识别构建目录、创建 Pages 项目、上传文件和验证地址。ㅤㅤ先分清它发布的是新站还是覆盖你的主域名这件事必须先讲清楚不然很容易不敢按回车。Cloudflare Pages 有两层地址 ㅤ层级这次的结果是否影响xxxx.work自定义域名Pages 默认地址axing-homepage.pages.dev不影响自定义域名例如xxxx.work自定义域名或home. xxxx.work自定义域名只有你主动绑定时才可能影响ㅤ只要没有进入 Pages 项目的Custom domains页面绑定域名也没有改 DNS 记录发布只会得到一个新的*.pages.dev地址。这也是我建议第一次实操时的标准做法先让新站独立上线确认内容、访问速度和链接都没问题再考虑要不要绑定自己的域名。如果你以后想绑定子域名例如home. xxxx.work自定义域名需要在 Pages 项目里走一次“添加自定义域名”的流程。Cloudflare 托管 DNS 时确认后它可以创建对应记录否则要在当前 DNS 服务商处手动添加 CNAME。这个动作和首次发布是两件事Skill 不会替你默认执行。ㅤㅤㅤ为什么命令里没有 Token 和 Account ID答案是 OAuth 登录态。Cloudflare 的命令行工具 Wrangler 支持在本机执行...# 浏览器完成 Cloudflare OAuth 授权wrangler login授权成功后Wrangler 会保存本机凭据。下一次再执行部署时它会根据当前登录账号找到可用的 Cloudflare Account 和相应权限因此命令里不必暴露ㅤ这就是“一键”的本质把一次性的身份认证前置而不是让每次部署都复制敏感参数。ㅤㅤ这个 one-click-deploy Skill 实际做了什么这个 Skill 并不是“把任意项目一键变成网站”。它的定位更准确把已经构建完成的静态目录发布到 Surge 或 Cloudflare Pages。一句话说当你使用wrangler命令时你是在将静态资源如 HTML、CSS、JS 文件部署到 Cloudflare Pages 平台。这个命令会处理构建输出目录如dist或build并将其上传到 Pages生成一个可通过*.pages.dev访问的站点。以 Cloudflare Pages 为例脚本会依次做这些事1.找到可发布目录优先识别指定的--output-dir否则尝试dist、build、public等目录。2.检查目录中是否有index.html并拒绝上传.env、私钥、证书、凭据文件等敏感内容。3.检查 Wrangler 是否可用、当前账号是否已授权。4.查询 Pages 项目项目不存在时先创建项目并设置生产分支。5.再上传静态文件得到*.pages.dev地址。6.最后通过 HTTPS 验证地址可访问。ㅤㅤ实操把本地 Next.js 静态主页发布出去我的项目目录是.../Users/xingyang/Downloads/code/homepage项目已经配置了 Next.js 静态导出 ㅤ...// next.config.ts生成可直接托管的静态文件constnextConfig {output:export,images: {unoptimized:true}, };构建后真正需要上传的是out/...homepage/ ├── app/ # 源码不直接上传 ├── package.json ├── next.config.ts └── out/ ├── index.html # 静态站入口 ├── 404.html └── _next/ # JS、CSS 与静态资源ㅤ先在本地构建 ㅤ...# 生成静态站点产物 out/npm run build然后通过 Skill 发布时核心命令是...# 发布静态目录--name 决定新的 pages.dev 子域名one-click-deploy ./homepage \ --provider cf-pages \ --name axing-homepage \ --output-dir out其中 ㅤㅤ--name axing-homepage会对应axing-homepage.pages.dev。ㅤ--output-dir out明确告诉 Skill 上传 Next.js 静态导出结果而不是源码或.next。ㅤ没有--domain因此不会碰xxxx.work自定义域名也不会碰 DNS。第一次使用时如果本机没有 WranglerSkill 要求显式加--install才会通过 npm 安装避免工具在后台偷偷安装依赖...# 仅在确认需要安装 Wrangler 时使用one-click-deploy ./homepage --provider cf-pages --name axing-homepage --output-dir out --installㅤㅤㅤ这次踩到的一个新版 Wrangler 坑这里有一个截至本次实测才暴露出来的问题值得单独写出来。我最开始直接运行了下面这条命令...# 不推荐对“不存在的新 Pages 项目”直接这样运行npx wrangler pages deploy out --project-name axing-homepageㅤ当前安装到的 Wrangler4.120.0识别出这是一个 Next.js 项目后尝试把项目迁移到 OpenNext / Cloudflare Workers并准备ㅤ向package.json加入 Wrangler 和部署脚本ㅤ新增wrangler.jsoncㅤ安装opennextjs/cloudflare。这和“上传已经生成好的out/静态目录”不是一回事所以我中止了迁移。随后使用 Wrangler 给出的兼容路径 ㅤ...# 仅用于首次创建传统 Pages Direct Upload 项目npx wrangler pages deploy out --project-name axing-homepage --force发布成功后Cloudflare 返回了一个部署地址 ㅤ...https://d9d03fb0.axing-homepage.pages.dev稳定的生产地址则是...https://axing-homepage.pages.dev后续再更新这个已存在的 Pages 项目时Wrangler 已明确提示不再需要传--force。这也是为什么这个 Skill 的“先查项目、没有就先创建再部署”的流程很有价值——它比直接把一条命令丢给最新版 CLI 更稳。这条经验只针对本次使用的 Wrangler 版本和静态 Next.js 项目CLI 行为会更新部署前最好先执行一次...# 只检查授权和当前账号不上传文件wranglerwhoamiㅤㅤㅤ最后一键部署真正省掉的是什么它省掉的不是服务器也不是域名决策而是重复的人工交接找构建目录、检查敏感文件、确认账号、创建项目、上传、复制链接、验证可访问。当这些步骤被收进一个 SkillCodex 就不只是“写了一个网页”而是可以把完成的静态成果交付到一个真实、可打开的地址。但域名仍然应该由人来决定ㅤ想低风险试验就用新的*.pages.devㅤ想做正式入口再绑定子域名ㅤ想替换主站最后才去改主域名 DNS。把这三步分开部署会从一件让人紧张的事变成可回退、可验证的小闭环。ㅤㅤSkills开源github.com/vibe-any/skills-hub/tree/main/one-click-deploy