SuperAPI AI 工具集

nuxthub-migration

部署与运维

查看项目

更新于 10-16 02:39

技能介绍

用途:在 NuxtHub Admin 停用(2025年12月31日)、项目使用 .github/workflows/nuxthub.yml 或 NuxtHub GitHub Action、含 NUXT_HUB_PROJECT_KEY / NUXT_HUB_PROJECT_DEPLOY_TOKEN 环境变量,或需自托管、升级 v0.10 时启用。迁移分两阶段,阶段一稳定推荐,阶段二为多云支持且有破坏性变更。

阶段一(v0.9.X,推荐):从 NuxtHub Admin/GitHub Actions 迁移到自托管 Cloudflare Workers,无需改代码。步骤包括:删除 .github/workflows/nuxthub.yml 及相关 GitHub Actions secrets 与环境变量;用 npx wrangler secret list/delete 清理 Worker secrets;用 npx wrangler d1 list、kv namespace list、r2 bucket list 复用已有资源,必要时创建 D1/KV/R2;创建 wrangler.jsonc 并配置绑定名(Database→DB,KV→KV,Cache→CACHE,Blob→BLOB);在 nuxt.config.ts 设 nitro.preset: 'cloudflare_module';在 Cloudflare Dashboard 用 Workers Builds 连接仓库,构建命令如 pnpm build,部署命令 npx wrangler deploy;可用 npx nuxt dev --remote 测试。注意 Nuxt cloudflare-module 预设输出到 dist/。

阶段二(v0.10/nightly,多云):需先完成阶段一。将 @nuxthub/core 换为 @nuxthub/core-nightly;hub.database: true 改为 hub.db: 'sqlite'(或 postgresql/mysql);server/database 改名 server/db;导入路径改为 ~/server/db/;hubDatabase() 改为 hub:db 的 db 与 schema,hubKV() 改为 hub:kv 的 kv,hubBlob() 改为 hub:blob 的 blob,方法不变;用 npx nuxt db generate 等 CLI 命令管理迁移。支持 PostgreSQL、MySQL、SQLite/Turso 及 Upstash、Redis、Deno KV、Vercel、S3、Netlify Blobs 等提供商(需相应依赖与环境变量)。v0.10 移除 hubAI、hubBrowser、hubVectorize、hubAutoRAG 等 Cloudflare 专属功能。

限制:阶段二存在破坏性变更,且为 nightly 版本;具体版本行为与兼容性以官方文档为准,资料未提供价格或收费信息。