Flue 框架从入门到精通
Part 3 · 进阶实战

§11 部署到任何地方:Node、Cloudflare 与 CI

写一次到处跑:Node、Cloudflare、CI 的部署要点

📑 本章目录

11.1 写一次,到处跑

去年我把一个 Agent 从 Node 迁到 Cloudflare。原本以为要重写,结果只改了 target

这是 Flue 的承诺:同一套 Agent,跑本地、跑 Node 服务器、跑 Cloudflare、跑 CI。

我把它在 Node 和 Cloudflare 都试过。同一份代码,换 target 就部署。

11.2 构建与启动

npm run build   # 构建到 dist/
npm start       # 启动生产服务器

生产启动脚本要显式加载环境变量和端口:

{
  "scripts": {
    "start": "bash -c 'set -a && source .env && set +a && PORT=3583 node dist/server.mjs'"
  }
}

11.3 开发 vs 生产

模式 命令 行为 标叔的结论
开发 flue dev 热重载,但一改文件就断连 只本地调试用
生产 npm start 稳定,不断连 上线必须用

重点看:"开发"那一行的"断连"。

flue dev 监听项目根目录所有文件。你改个 .md,它都重启,正在流的 SSE 直接断。线上服务用生产模式。

11.4 部署目的地

目的地 适合 说明
Node.js 普通长驻服务器/容器 最通用
Cloudflare Worker,免运维 cloudflare/ 模型免 Key
Render 托管 Node 服务 带可选持久化
GitHub Actions CI 里跑一次性任务 --target node

Cloudflare 有个爽点:用 cloudflare/@cf/... 模型,靠 Worker 的 AI 绑定,连 API Key 都不用配。

标叔的经验:部署前先 flue build

我偷懒直接 dev 上线过,遇到文件监听把连接搞挂。构建一次能提前抓出"Agent 没被发现"这类问题,省心。

四处都能跑了。最后两章,聊点虚但重要的——思维转变和框架选型。