网站本地运行与 Cloudflare 发布流程

这篇笔记专门记住这个网站是怎么跑起来的，以及以后我自己改完代码后，应该怎么重新发到公网。

这个网站现在用什么写

• 前端框架：Astro
• 页面：.astro
• 样式：CSS
• 交互和接口：TypeScript / JavaScript
• 云端托管：Cloudflare Pages
• 服务端接口：Cloudflare Pages Functions

代码主要在哪里

• 页面内容：src/pages/
• 全站布局：src/layouts/BaseLayout.astro
• 全局样式：src/styles/global.css
• 服务端接口：functions/api/
• 静态资源：public/

本地开发怎么运行

进入项目目录后运行：

npm run dev

这时本地会启动 Astro 开发服务器，浏览器里打开：

http://localhost:4321

这个模式适合：

• 改首页文字
• 改导航栏
• 改颜色和样式
• 看页面是否即时刷新

发布到公网怎么做

这个项目当前不是 GitHub 自动构建，而是本地先 build，再手动 deploy 到 Cloudflare Pages。

正确流程：

npm run build
wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main

含义是：

1. npm run build

   • 把 Astro 项目编译成静态网站
   • 输出目录是 dist/

2. wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main

   • 把 dist/ 上传到 Cloudflare Pages
   • 然后域名 https://2005088.xyz 就会更新成新版本

为什么 wrangler pages deploy 会报错

如果只运行：

wrangler pages deploy

会报这种错：

Must specify a directory of assets to deploy

原因很简单：

• wrangler 不知道你要上传哪个目录
• 这个项目真正要上传的是 dist/

所以必须写成：

wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main

一个最短可记住的发布流程

以后只记住这几步就够：

cd C:\Users\z1831\Documents\Codex\2026-04-27\2005088-xyz-cloudflare
npm run build
wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main

本地预览和公网发布的区别

本地预览

npm run dev

• 在自己电脑上运行
• 改代码后页面会自动刷新
• 地址通常是 localhost:4321

公网发布

npm run build
wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main

• 先本地生成 dist
• 再上传到 Cloudflare
• 全网用户访问的是 https://2005088.xyz

这个站上线后是怎么运行的

分两层：

1. 静态页面

   • Cloudflare Pages 托管 dist 里的 HTML / CSS / JS
   • 通过 CDN 分发到公网

2. 服务端接口

   • 例如 functions/api/debug-snapshot.ts
   • 这类接口运行在 Cloudflare 边缘
   • 用来安全读取 InfluxDB、返回 JSON

以后最常改的文件

• 首页：src/pages/index.astro
• 导航栏：src/layouts/BaseLayout.astro
• 主题色：src/styles/global.css
• 调试面板：src/pages/debug-panel.astro
• 调试接口：functions/api/debug-snapshot.ts

一句话总结

这个网站现在的工作流就是：

先在 VS Code 里改代码，用 npm run dev 本地看效果；确认没问题后，运行 npm run build 和 wrangler pages deploy .\dist --project-name site-2005088-xyz --branch main，把新版本发到 Cloudflare Pages。