cloudflare pages插件支持vs code一键拖拽部署html站点至全球节点。安装插件后授权github账号(需勾选pages:read/write权限),右键文件夹选择“deploy to cloudflare pages”或通过命令面板部署,自动设framework为none、output directory为.,生成pages.dev域名并支持自定义域名与https自动配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想把本地写好的HTML页面一键发到全球200+节点,让访客无论在东京、圣保罗还是开普敦,打开都是毫秒级响应——Cloudflare Pages插件能绕过GitHub直接拖拽部署,省掉建仓库、配CI的步骤。
安装并启用Codex Cloudflare Pages插件
打开VS Code扩展市场,搜索“Codex Cloudflare Pages”,点击安装→重启VS Code→按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板。
输入“Cloudflare Pages: Setup Account”,回车后会跳转到Cloudflare登录页;用GitHub账号授权时【必须勾选“pages:read pages:write”权限】,否则后续无法触发部署。
授权成功后,插件自动在VS Code状态栏右下角显示“CF Pages Ready”。这一步失败常见原因是浏览器弹窗被拦截,手动放行即可。
用插件部署纯HTML静态站
方法一:直接拖拽文件夹
在VS Code资源管理器中,右键点击含index.html的根目录→选择“Deploy to Cloudflare Pages”→插件自动检测为纯静态项目,构建预设默认设为“None”,输出目录默认为“.”。
方法二:命令面板部署
按Ctrl+Shift+P→输入“Cloudflare Pages: Deploy”→选择目标文件夹→确认后插件生成临时构建配置,跳过npm install等冗余步骤,直接打包上传。
部署日志出现在VS Code底部终端,看到“✅ Deployment successful”和绿色URL链接即完成。默认域名形如https://your-project-name.pages.dev,首次访问可能需等待30秒边缘节点同步。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
绑定自定义域名并强制HTTPS
第一步:确保DNS已托管至Cloudflare
登录Cloudflare控制台→进入DNS设置→检查域名状态是否为“Active”;若显示“Offline”,说明NS记录未切换,需去域名注册商处将NS改为Cloudflare提供的地址(如lila.ns.cloudflare.com)。
第二步:在Pages项目中添加域名
进入Cloudflare控制台→Workers & Pages→找到对应项目→点击“Custom domains”→输入你的域名(如example.com)→点击“Add domain”。【主域名example.com必须走DNS迁移,二级域名www.example.com可直接CNAME到your-project-name.pages.dev】
第三步:验证并激活
Cloudflare自动下发TXT验证记录→回到DNS设置页面,确认该TXT记录已存在→返回Pages页面点击“Check DNS records”→状态变为“Active”后,HTTPS证书10秒内自动签发,无需手动操作。
排查404与路径错误
如果访问自定义域名出现404,先检查HTML中资源路径是否全为相对路径:/css/style.css会失败,./css/style.css才正确;绝对路径开头的斜杠会被解析为根目录,但Pages默认部署在域名根路径,所以根路径本身没问题。
Vue或Vite项目需额外处理:打开vite.config.js,确认base选项为'/'而非'./'或'/my-app/';React项目检查package.json中homepage字段是否设为"."或"https://your-domain.com",否则构建产物里的JS/CSS路径会多一层前缀导致404。
纯HTML项目最简验证法:把所有和<script>标签里的href/src属性删掉路径中的"http://localhost:3000"或"../",统一改成"./assets/logo.png"这类形式,保存后重新部署。</script>










