Cloudflare Pages 部署备忘

一次部署

npm run build
npx wrangler pages deploy dist --project-name=muyweb

首次会创建项目,之后每次都是增量上传,通常几十秒生效。验证:

curl -I https://muyweb.pages.dev
# 期望 HTTP/2 200,cf-cache-status: HIT

鉴权方式

本机使用 API Token(环境变量 CLOUDFLARE_API_TOKEN),不用每次浏览器授权。令牌权限只需要两行:

• 账户 → Cloudflare Pages → 编辑
• 用户 → User Details → 读取

令牌在 API 令牌页可随时撤销重发。

国内访问

• *.pages.dev 在大陆无法直连,通过自备线路访问;海外直连,全球边缘节点都很快。
• 若将来想大陆直连:买一个域名(约 ¥70/年)绑定到 Pages,一般即可直连;追求国内速度则需备案 + 腾讯云 EdgeOne。

想搬到自己的服务器?

dist/ 就是全部——纯静态文件,任何地方都能跑:

server {
  listen 80;
  server_name _;
  root /var/www/muyweb;
  index index.html;
  location / {
    try_files $uri $uri/ $uri.html /404.html;
  }
}

Astro 默认构建出 about/index.html 形式的目录,try_files 记得带上 $uri.html。