nodebbs 0.0.5 → 0.0.7

package/README.md

@@ -168,6 +168,20 @@ npx nodebbs logs:db
 npx nodebbs logs:redis
 ```
 
+### 离线部署
+
+#### `nodebbs pack`
+生成离线部署包（包含镜像、配置文件和安装脚本）
+
+```bash
+npx nodebbs pack
+npx nodebbs pack -o my-deployment.tar.gz
+```
+
+**参数**：
+- `-o, --output` - 输出文件名 (默认: nodebbs-offline.tar.gz)
+
+
 ### Shell 访问
 
 #### `nodebbs shell`
@@ -340,6 +354,30 @@ npx nodebbs db:seed
 npx nodebbs shell:db
 ```
 
+### 场景 6：离线服务器部署
+
+1. **在开发机打包**：
+```bash
+# 生成离线包
+npx nodebbs pack
+```
+
+2. **上传到服务器**：
+将 `nodebbs-offline.tar.gz` 上传到目标服务器。
+
+3. **在服务器部署**：
+```bash
+# 解压
+tar -xzf nodebbs-offline.tar.gz
+
+# 配置环境变量
+cp .env.example .env
+vi .env
+
+# 一键安装启动
+./install.sh
+```
+
 
 
 ## ⚙️ 环境配置

package/dist/commands/pack/index.js

@@ -86,7 +86,6 @@ export default class Pack extends Command {
                 this.warn('检测到 .env 文件，出于安全考虑，不会默认打包 .env 文件。请在部署时手动配置环境变量。');
             }
             // 创建 .env.example
-            // 创建 .env.example
             const envTemplatePath = getTemplatePath('env');
             let envExample = '';
             try {

package/dist/commands/restart/index.js

@@ -1,9 +1,9 @@
 import { Command } from '@oclif/core';
 import { runCompose, getComposeFiles } from '../../utils/docker.js';
 import { logger } from '../../utils/logger.js';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
+import { EnvFlag, selectEnvironment, setStoredEnv } from '../../utils/selection.js';
 export default class Restart extends Command {
-    static description = '重启所有服务 (docker compose restart)';
+    static description = '重启所有服务 (up --force-recreate)';
     static flags = {
         env: EnvFlag,
     };
@@ -11,10 +11,15 @@ export default class Restart extends Command {
         const { flags } = await this.parse(Restart);
         // 1. 选择环境
         const env = await selectEnvironment(flags.env);
+        await setStoredEnv(env);
         const { files, isBuiltIn } = await getComposeFiles(env);
-        logger.info('正在重启服务...');
+        logger.info('正在重启服务 (使用现有镜像)...');
         logger.info('环境: ' + env);
-        await runCompose(files, ['restart'], isBuiltIn);
+        // 使用 up -d --force-recreate 可以：
+        // 1. 如果服务不存在，则创建并启动
+        // 2. 如果服务已存在，则强制重启
+        // 3. 不会执行构建 (除非镜像不存在)
+        await runCompose(files, ['up', '-d', '--force-recreate'], isBuiltIn);
         logger.success('服务已重启');
     }
 }

package/oclif.manifest.json

@@ -91,76 +91,6 @@
         "backup.js"
       ]
     },
-    "db:generate": {
-      "aliases": [],
-      "args": {},
-      "description": "生成 Prisma Client (db:generate)",
-      "flags": {
-        "env": {
-          "char": "e",
-          "description": "部署环境 (production, lowmem, basic)",
-          "name": "env",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "production",
-            "lowmem",
-            "basic"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "db:generate",
-      "pluginAlias": "nodebbs",
-      "pluginName": "nodebbs",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "db",
-        "generate.js"
-      ]
-    },
-    "db:migrate": {
-      "aliases": [],
-      "args": {},
-      "description": "执行数据库迁移 (db:migrate)",
-      "flags": {
-        "env": {
-          "char": "e",
-          "description": "部署环境 (production, lowmem, basic)",
-          "name": "env",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "production",
-            "lowmem",
-            "basic"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "db:migrate",
-      "pluginAlias": "nodebbs",
-      "pluginName": "nodebbs",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "db",
-        "migrate.js"
-      ]
-    },
     "db:push": {
       "aliases": [],
       "args": {},
@@ -266,37 +196,6 @@
         "seed.js"
       ]
     },
-    "pack": {
-      "aliases": [],
-      "args": {},
-      "description": "生成离线部署包",
-      "flags": {
-        "output": {
-          "char": "o",
-          "description": "输出文件名",
-          "name": "output",
-          "default": "nodebbs-offline.tar.gz",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "pack",
-      "pluginAlias": "nodebbs",
-      "pluginName": "nodebbs",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "pack",
-        "index.js"
-      ]
-    },
     "logs:api": {
       "aliases": [],
       "args": {},
@@ -472,6 +371,37 @@
         "web.js"
       ]
     },
+    "pack": {
+      "aliases": [],
+      "args": {},
+      "description": "生成离线部署包",
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "输出文件名",
+          "name": "output",
+          "default": "nodebbs-offline.tar.gz",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "pack",
+      "pluginAlias": "nodebbs",
+      "pluginName": "nodebbs",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "pack",
+        "index.js"
+      ]
+    },
     "rebuild": {
       "aliases": [],
       "args": {},
@@ -496,7 +426,7 @@
     "restart": {
       "aliases": [],
       "args": {},
-      "description": "重启所有服务 (docker compose restart)",
+      "description": "重启所有服务 (up --force-recreate)",
       "flags": {
         "env": {
           "char": "e",
@@ -788,5 +718,5 @@
       ]
     }
   },
-  "version": "0.0.5"
+  "version": "0.0.7"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nodebbs",
   "description": "NodeBBS 论坛系统专业运维工具",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "author": "wengqianshan",
   "bin": {
     "nodebbs": "./bin/run.js"
@@ -65,7 +65,7 @@
         "description": "数据库操作 (备份, 迁移, 种子数据等)"
       },
       "shell": {
-        "description": "服务的交互式 Shell"
+        "description": "进入容器终端"
       }
     }
   },

package/dist/commands/db/generate.d.ts

@@ -1,8 +0,0 @@
-import { Command } from '@oclif/core';
-export default class DbGenerate extends Command {
-    static description: string;
-    static flags: {
-        env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/db/generate.js

@@ -1,18 +0,0 @@
-import { Command } from '@oclif/core';
-import { execCompose, getComposeFiles } from '../../utils/docker.js';
-import { logger } from '../../utils/logger.js';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
-export default class DbGenerate extends Command {
-    static description = '生成 Prisma Client (db:generate)';
-    static flags = {
-        env: EnvFlag,
-    };
-    async run() {
-        const { flags } = await this.parse(DbGenerate);
-        const env = await selectEnvironment(flags.env);
-        const { files, isBuiltIn } = await getComposeFiles(env);
-        logger.info('正在生成 Prisma Client...');
-        await execCompose(files, 'api', ['npm', 'run', 'db:generate'], isBuiltIn);
-        logger.success('数据库迁移文件生成完成');
-    }
-}

package/dist/commands/db/migrate.d.ts

@@ -1,8 +0,0 @@
-import { Command } from '@oclif/core';
-export default class DbMigrate extends Command {
-    static description: string;
-    static flags: {
-        env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/db/migrate.js

@@ -1,18 +0,0 @@
-import { Command } from '@oclif/core';
-import { execCompose, getComposeFiles } from '../../utils/docker.js';
-import { logger } from '../../utils/logger.js';
-import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
-export default class DbMigrate extends Command {
-    static description = '执行数据库迁移 (db:migrate)';
-    static flags = {
-        env: EnvFlag,
-    };
-    async run() {
-        const { flags } = await this.parse(DbMigrate);
-        const env = await selectEnvironment(flags.env);
-        const { files, isBuiltIn } = await getComposeFiles(env);
-        logger.info('正在执行数据库迁移...');
-        await execCompose(files, 'api', ['npm', 'run', 'db:migrate'], isBuiltIn);
-        logger.success('数据库迁移完成');
-    }
-}