# Cloudflare Workers 到 Bun 的迁移您正在协助将 Cloudflare Workers 应用程序迁移到 Bun。这涉及转换边缘运行时 API、替换 Cloudflare 绑定以及从边缘适应服务器部署。 ## 快速参考详细模式请参见： * **运行时 API** : [runtime-apis.md]() \- Cloudflare 到 Bun API 映射 * **绑定迁移** : [bindings.md]() \- KV、R2、D1、持久对象替换 * **部署** : [deployment.md]() \- 边缘到服务器部署策略 ## 迁移工作流程 ### 1\.迁移前分析 **检查当前设置：** # 检查 Cloudflare CLI 牧马人-版本 # 检查 Bun 安装情况包子——版本 # 分析wrangler.toml 猫牧人.toml **检查工作人员配置：** # 检查兼容性标志 grep兼容性_标志wrangler.toml # 检查绑定 grep -E "kv_namespaces|r2_buckets|d1_databases|durable_objects" wrangler.toml ### 2\.工人类型分析确定您要迁移的工作人员类型： * **Service Worker** ：传统的 `addEventListener('fetch')` 格式 * **Module Worker** ：现代 `export default { fetch() }` 格式 * **Scheduled Worker** ：Cron 触发器 * **持久对象** ：有状态对象 * **Pages Functions** ：类似 Next.js 的基于文件的路由 ### 3\.运行时 API 转换 #### 基本获取处理程序 **Cloudflare Worker（模块格式）：** 导出默认值{ 异步获取（请求：请求，环境：环境，ctx：ExecutionContext）：Promise { 返回新的响应（'Hello World'）； }, }; **包子服务器：** 包子.发球({ 端口：3000，获取（请求：请求）：响应 |承诺<响应> { 返回新的响应（'Hello World'）； }, }); console.log('服务器在 http://localhost:3000 上运行'); #### 请求/响应处理 **Cloudflare 工作人员：** 导出默认值{ 异步获取（请求：请求）：Promise { const url = 新 URL(request.url); if (url.pathname === '/api/data') { 返回 Response.json({ data: 'value' }); } return new Response('未找到', { status: 404 }); }, }; **小圆面包（用 Hono 进行路由）：** 从'hono'导入{Hono}； const app = new Hono(); app.get('/api/data', (c) => { 返回 c.json({ 数据: '值' }); }); app.notFound((c) => { return c.text('未找到', 404); }); 导出默认值{ 端口：3000，获取：app.fetch， }; 有关完整的 API 映射，请参阅 [runtime-apis.md]()。 ### 4\.绑定迁移 Cloudflare Workers 使用 KV、R2、D1 等绑定。这些需要替换： #### KV 命名空间 → 数据库/缓存 **Cloudflare 工作人员：** 导出默认值{ 异步获取（请求：请求，环境：环境）：Promise { const value = wait env.MY_KV.get('key'); 等待 env.MY_KV.put('key', 'value', {expirationTtl: 3600 }); 返回 Response.json({ 值 }); }, }; **Bun（使用 Redis 或 SQLite）：** 从'ioredis'导入{Redis}； const redis = new Redis(process.env.REDIS_URL); 包子.发球({ 异步获取（请求：请求）{ const value = wait redis.get('key'); 等待 redis.setex('key', 3600, 'value'); 返回 Response.json({ 值 }); }, }); #### R2 存储桶 → S3 或文件系统 **Cloudflare 工作人员：** 导出默认值{ 异步获取（请求：请求，环境：环境）：Promise { const object = wait env.MY_BUCKET.get('file.txt'); const text =等待对象？.text(); 返回新的响应（文本）； }, }; **Bun（使用 S3 兼容存储）：** 从 '@aws-sdk/client-s3' 导入 { S3Client, GetObjectCommand }； const s3 = new S3Client({ 区域: 'us-east-1' }); 包子.发球({ 异步获取（请求：请求）{ const 命令 = new GetObjectCommand({ 桶：'我的桶'，键：'文件.txt'， }); const 响应 = 等待 s3.send(命令); const text =等待response.Body?.transformToString(); 返回新的响应（文本）； }, }); 有关所有绑定替换，请参阅 [bindings.md]()。 ### 5\.环境变量 **Cloudflare Worker (wrangler.toml)：** [变量] API_KEY = "开发密钥" [[env.生产.vars]] API_KEY =“产品密钥” **Bun（.env 文件）：** # .env.development API_KEY=开发密钥 # .env.生产 API_KEY=产品密钥代码中访问： // 两者使用相同的 API const apiKey = process.env.API_KEY; ### 6\.配置迁移 **牧马人.toml：** 名称 =“我的工人” 主要=“src/index.ts” 兼容性_日期=“2024-01-01” [变量] 环境=“生产” kv_命名空间 = [ { 绑定 = "MY_KV", id = "..." } ] r2_buckets = [ { 绑定 =“MY_BUCKET”，bucket_name =“我的桶”} ] **package.json（包子）：** { “名称”：“我的面包应用程序”， “类型”：“模块”， “脚本”：{ "dev": "bun run --hot src/index.ts", "start": "bun run src/index.ts", "build": "bun build src/index.ts --outdir=dist" }, “依赖项”：{ "荣誉": "^3.0.0", “ioredis”：“^5.0.0” } } ### 7\.路由模式 **Cloudflare Worker（手动路由）：** 导出默认值{ 异步获取（请求：请求）：Promise { const url = 新 URL(request.url); if (url.pathname === '/') { 返回新的响应（'Home'）； } if (url.pathname.startsWith('/api/')) { 返回handleApi（请求）； } return new Response('未找到', { status: 404 }); }, }; **Bun（带有 Hono 框架）：** 从'hono'导入{Hono}； const app = new Hono(); app.get('/', (c) => c.text('Home')); const api = new Hono(); api.get('/users', (c) => c.json({ users: [] })); app.route('/api', api); 导出默认值{ 端口：3000，获取：app.fetch， }; ### 8\.预定事件 (Cron) **Cloudflare 工作人员：** 导出默认值{ 异步计划（事件：ScheduledEvent，env：Env，ctx：ExecutionContext）{ 等待 doCleanup(); }, }; // 牧马人.toml [触发] crons = ["0 0 * * *"] # 每天午夜 **Bun（使用node-cron）：** 从 'node-cron' 导入 cron； // 每天午夜运行 cron.schedule('0 0 * * *', async () => { 等待 doCleanup(); }); // 启动服务器包子.发球({ 获取（请求：请求）{ return new Response('服务器正在运行'); }, }); ### 9\.测试迁移 **Cloudflare Worker (Miniflare)：** 从'miniflare'导入{Miniflare}； const mf = 新 Miniflare({ 脚本：` 导出默认值{ fetch() { 返回新的 Response('Hello'); } } `, }); const response = wait mf.dispatchFetch('http://localhost/'); **发髻测试：** 从 'bun:test' 导入 { 描述、测试、期望 }；描述('服务器', () => { test('应该响应请求', async () => { const 响应 = 等待 fetch('http://localhost:3000/'); 期望(响应.状态).toBe(200); }); }); ### 10\.部署策略 **Cloudflare 工作人员：** * 边缘部署（全球分布） * 无冷启动 * 有限的运行时间（CPU时间限制） * 专用绑定（KV、R2、D1） **包子服务器：** * 传统服务器部署 * 自托管或云（AWS、GCP、Azure） * 无CPU时间限制 * 标准数据库和存储 * 使用Docker进行容器化（参见bun-deploy技巧）有关部署策略，请参阅 [deployment.md]()。 ### 11\.更新package.json { "name": "从 cloudflare 迁移", “类型”：“模块”， “脚本”：{ "dev": "bun run --hot src/index.ts", "start": "NODE_ENV=生产包运行 src/index.ts", “测试”：“面包测试”， "build": "bun build src/index.ts --outdir=dist --minify" }, “依赖项”：{ "荣誉": "^3.11.0", "ioredis": "^5.3.0", "@aws-sdk/client-s3": "^3.478.0" }, “开发依赖项”：{ “@types/bun”：“最新” } } ### 12\.文件结构迁移 **Cloudflare 工作人员：** cloudflare-worker/ ├── src/ │ └── 索引.ts ├── 牧马人.toml └── package.json **包子服务器：** 包子服务器/ ├── src/ │ ├── 索引.ts │ ├── 路线/ │ └── 服务/ ├── .env.development ├── .env.生产 ├── package.json ├── tsconfig.json └── Bunfig.toml ## 迁移清单 * Bun 安装并验证 * 确定工作人员类型（服务/模块/耐用） * 映射到替换的绑定（KV→Redis、R2→S3 等） * 环境变量迁移 * 路由迁移（手动→框架） * 迁移计划任务（cron 触发器） * wrangler.toml 转换为 package.json * 创建 TypeScript 配置 * 使用 `bun install` 安装依赖项 * 测试已迁移并通过 * 本地服务器运行 * 规划部署策略 ## 主要区别特色| Cloudflare 工人 |包子服务器 ---|---|--- **运行时** |边缘（V8 隔离）|服务器（JavaScript核心） **部署** |全球边缘网络|传统托管 **冷启动** | ~0 毫秒 |最小的发髻 **执行时间** |有限（CPU 时间）|无限 **存储** | KV、R2、D1、DO | Redis、S3、PostgreSQL 等 **成本模型** |按请求 |服务器/容器成本 **缩放** |自动|手动/自动缩放组 **状态** |耐用的物体|传统数据库 ## 常见模式 ### CORS 处理 **两者相同：** 常量 corsHeaders = { '访问控制允许来源': '*', '访问控制允许方法': 'GET、POST、PUT、DELETE', '访问控制允许标头'：'内容类型'， }; // 处理 OPTIONS 预检 if (request.method === '选项') { 返回新的响应(null, { headers: corsHeaders }); } ### JSON 响应 **两者相同：** 返回 Response.json({ 数据: '值' }, { headers: { 'Cache-Control': 'max-age=3600' } }); ### 错误处理 **两者相同：** 尝试{ // 你的代码 } 捕获（错误）{ return new Response('内部服务器错误', { status: 500 }); } ## 完成迁移完成后，提供摘要： * ✅ 迁移状态（成功/部分/问题） * ✅ 更换绑定（KV→Redis、R2→S3 等） * ✅ 选择部署策略 * ✅ 性能比较 * ✅ Bun 文档链接 ## 后续步骤向用户建议： 1.搭建Redis/数据库进行KV替换 2. 配置S3兼容存储以用于R2替换 3. 设置监控和日志记录 4.规划部署策略（Docker、云托管） 5. 使用bun-deploy技巧进行容器化 6. 更新 CI/CD 管道 7. 对迁移的应用程序进行负载测试

Cloudflare 到 Bun

包含技能