nodebbs 0.1.0 → 0.2.0

package/README.md

@@ -15,7 +15,7 @@ NodeBBS CLI 是一个专为全栈开发者设计的命令行工具，用于简
 - 🎯 **全栈友好** - 命令设计贴近开发者思维
 - 📊 **实时日志** - 方便查看各服务日志
 - 💾 **数据库管理** - 内置数据库迁移和管理工具
-- 🌐 **内置模板** - 无需本地配置文件即可通过远程镜像快速部署
+- 🌐 **内置模板** - 无需本地配置文件即可使用
 
 ## 📦 安装
 
@@ -46,7 +46,7 @@ npx nodebbs [command]
 npx nodebbs
 ```
 - **start**： 开始部署（首次使用推荐选择此项）
-- **rebuild**： 更新并重启（Pull & Restart，代码/镜像更新后使用）
+- **rebuild**： 重新构建并启动（跳过检查，通常在代码更新后选择此项）
 
 ## 📚 命令参考
 
@@ -60,25 +60,21 @@ npx nodebbs start
 # 指定环境启动
 npx nodebbs start -e production
 
+# 重新构建并启动（跳过检查）
+npx nodebbs start --build
+```
+
 **参数**：
-- `-e, --env` - 部署环境（production, lowmem）
-- `-t, --tag` - 镜像版本 tag (默认: latest)
+- `-e, --env` - 部署环境（production, lowmem, basic）
+- `-b, --build` - 重新构建镜像并启动（跳过健康检查和初始化）
 
 启动流程包含：
 - Docker 环境检查
 - 环境变量验证
-- 拉取最新镜像
+- 镜像构建
 - 服务启动
-- 健康检查（默认开启）
-- 数据库初始化（默认开启）
-
-#### `nodebbs rebuild`
-拉取最新镜像并重启服务 (Update & Restart)
-
-```bash
-npx nodebbs rebuild
-```
-> 此命令是 `start` 的别名，用于快速更新部署。
+- 健康检查（默认开启，使用 `--build` 跳过）
+- 数据库初始化（默认开启，使用 `--build` 跳过）
 
 #### `nodebbs restart`
 重启所有服务（不更新镜像，支持环境选择）
@@ -276,8 +272,9 @@ vi .env
 
 ### 支持的环境
 
+- **basic** - 基础环境（仅用于测试）
 - **lowmem** - 低配环境（1C1G/1C2G）
-- **production** - 生产环境（标准配置，推荐）
+- **production** - 生产环境（2C4G+，推荐）
 
 ### 环境变量
 
@@ -312,7 +309,7 @@ CLI 会自动记住您上次启动的环境：
 2. 后续运行 `nodebbs logs`, `nodebbs status` 等命令时，会自动使用该环境，无需再次指定 `-e production`。
 3. 运行 `nodebbs stop` 成功停止服务后，会自动删除 `.nodebbs-env` 文件。
 
-**注意**：如果您需要临时操作其他环境，仍然可以使用 `-e` 参数强制指定，例如 `nodebbs logs -e lowmem`。
+**注意**：如果您需要临时操作其他环境，仍然可以使用 `-e` 参数强制指定，例如 `nodebbs logs -e basic`。
 
 ## 🛠️ 高级用法
 
@@ -333,8 +330,9 @@ CLI 会自动：
 ### 自定义配置
 
 如果需要自定义配置，在项目根目录创建：
-- `docker-compose.yml` - 基础/生产环境配置
-- `docker-compose.lowmem.yml` - 低配环境配置 (Override)
+- `docker-compose.yml` - 基础配置
+- `docker-compose.prod.yml` - 生产环境配置
+- `docker-compose.lowmem.yml` - 低配环境配置
 
 CLI 会优先使用本地配置文件。
 

package/dist/commands/pack/index.js

@@ -74,6 +74,9 @@ export default class Pack extends Command {
                 return line;
             });
             fs.writeFileSync(path.join(tmpDir, 'docker-compose.yml'), cleanedLines.join('\n'));
+            if (fs.existsSync('docker-compose.prod.yml')) {
+                fs.copyFileSync('docker-compose.prod.yml', path.join(tmpDir, 'docker-compose.prod.yml'));
+            }
             if (fs.existsSync('.env')) {
                 this.warn('检测到 .env 文件，出于安全考虑，不会默认打包 .env 文件。请在部署时手动配置环境变量。');
             }
@@ -114,9 +117,7 @@ services:
     image: nodebbs-web:latest
 EOF
 
-COMPOSE_FILES="-f docker-compose.yml -f docker-compose.override.yml"
-
-docker compose \$COMPOSE_FILES up -d
+docker compose -f docker-compose.yml -f docker-compose.prod.yml -f docker-compose.override.yml up -d
 
 echo "部署完成！"
 `;

package/dist/commands/rebuild/index.js

@@ -1,11 +1,11 @@
 import { Command } from '@oclif/core';
 import Start from '../start/index.js';
 export default class Rebuild extends Command {
-    static description = '拉取最新镜像并重启服务 (Update & Restart)';
+    static description = '重新构建并启动服务 (start --build)';
     // Allow passing flags like -e to the underlying start command
     static strict = false;
     async run() {
-        // Invoke Start command to pull latest images and restart
-        await Start.run(this.argv);
+        // Invoke Start command with --build flag and any other arguments
+        await Start.run(['--build', ...this.argv]);
     }
 }

package/dist/commands/start/index.d.ts

@@ -3,7 +3,7 @@ export default class Start extends Command {
     static description: string;
     static flags: {
         env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        tag: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        build: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/start/index.js

@@ -4,20 +4,25 @@ import { checkDocker, runCompose, waitForHealth, execCompose, getComposeFiles }
 import { initEnv, checkEnv } from '../../utils/env.js';
 import { logger } from '../../utils/logger.js';
 import dotenv from 'dotenv';
-import { input } from '@inquirer/prompts';
 import { EnvFlag, selectEnvironment } from '../../utils/selection.js';
 export default class Start extends Command {
     static description = '开始部署';
     static flags = {
         env: EnvFlag,
-        tag: Flags.string({
-            char: 't',
-            description: 'Image version tag (e.g. latest, v0.1.0)',
+        build: Flags.boolean({
+            char: 'b',
+            description: '重新构建并启动服务 (跳过健康检查和数据初始化)',
+            default: false,
         }),
     };
     async run() {
         const { flags } = await this.parse(Start);
-        logger.header('NodeBBS Docker 部署');
+        if (flags.build) {
+            logger.header('NodeBBS 重新构建启动');
+        }
+        else {
+            logger.header('NodeBBS Docker 部署');
+        }
         // 1. 选择环境
         const env = await selectEnvironment(flags.env);
         // 2. 获取 Compose 文件
@@ -34,83 +39,69 @@ export default class Start extends Command {
         else if (env === 'lowmem') {
             logger.success('已选择：低配环境');
         }
+        else {
+            logger.success('已选择：基础环境');
+            if (!flags.build) {
+                logger.warning('注意：无资源限制，不推荐用于生产环境。');
+            }
+        }
         // 3. 检查 Docker 和环境变量
         await checkDocker();
         // initEnv 保证 .env 存在（或退出）
         await initEnv();
         await checkEnv(env);
-        // 如果不是本地构建，则询问镜像版本
-        // 先加载环境变量以获取当前的 IMAGE 配置（如果有）
-        const envConfig = dotenv.config().parsed || {};
-        let tag = flags.tag;
-        if (!tag) {
-            tag = await input({
-                message: '请选择要部署的镜像版本:',
-                default: 'latest'
+        if (!flags.build) {
+            const continueDeploy = await confirm({
+                message: '是否继续启动？',
+                default: true
             });
-        }
-        // 构造新的镜像名称
-        // 逻辑：如果 .env 里定义了 API_IMAGE，则解析出 registry/name 部分，然后拼接 tag
-        // 否则使用默认 registry
-        const defaultApiImage = 'ghcr.io/aiprojecthub/nodebbs-api';
-        const defaultWebImage = 'ghcr.io/aiprojecthub/nodebbs-web';
-        let currentApiImage = envConfig.API_IMAGE || defaultApiImage;
-        let currentWebImage = envConfig.WEB_IMAGE || defaultWebImage;
-        const replaceTag = (image, newTag) => {
-            const parts = image.split(':');
-            if (parts.length > 1 && !parts[parts.length - 1].includes('/')) {
-                // 最后一个部分不包含 '/'，认为是 tag
-                parts.pop();
+            if (!continueDeploy) {
+                logger.info('操作已取消。');
+                this.exit(0);
             }
-            return `${parts.join(':')}:${newTag}`;
-        };
-        process.env.API_IMAGE = replaceTag(currentApiImage, tag);
-        process.env.WEB_IMAGE = replaceTag(currentWebImage, tag);
-        logger.info(`将部署版本: ${tag}`);
-        logger.info(`API Image: ${process.env.API_IMAGE}`);
-        logger.info(`Web Image: ${process.env.WEB_IMAGE}`);
-        const continueDeploy = await confirm({
-            message: '是否继续启动？',
-            default: true
-        });
-        if (!continueDeploy) {
-            logger.info('操作已取消。');
-            this.exit(0);
         }
-        // 4. 拉取并启动服务
-        logger.info('正在拉取最新的 Docker 镜像...');
-        await runCompose(composeFiles, ['pull'], isBuiltIn);
-        logger.success('镜像拉取完成');
-        logger.info('正在启动服务...');
-        await runCompose(composeFiles, ['up', '-d'], isBuiltIn);
-        logger.success('服务启动指令已发送');
-        // 5. 启动后操作
-        await waitForHealth(composeFiles, isBuiltIn);
-        const pushDb = await confirm({
-            message: '是否推送数据库 schema？',
-            default: false
-        });
-        if (pushDb) {
-            logger.info('正在推送数据库 schema...');
-            await execCompose(composeFiles, 'api', ['npm', 'run', 'db:push'], isBuiltIn);
-            logger.success('数据库 schema 推送完成');
+        // 4. 构建并启动服务
+        if (flags.build) {
+            logger.info('正在重新构建并启动服务...');
+            await runCompose(composeFiles, ['up', '-d', '--build'], isBuiltIn);
+            logger.success('服务已重新构建并启动');
         }
-        const seedDb = await confirm({
-            message: '是否初始化种子数据？',
-            default: false
-        });
-        if (seedDb) {
-            logger.info('正在初始化数据...');
-            await execCompose(composeFiles, 'api', ['npm', 'run', 'seed'], isBuiltIn);
-            logger.success('数据初始化完成');
+        else {
+            logger.info('正在构建 Docker 镜像...');
+            await runCompose(composeFiles, ['build', '--no-cache'], isBuiltIn);
+            logger.success('镜像构建完成');
+            logger.info('正在启动服务...');
+            await runCompose(composeFiles, ['up', '-d'], isBuiltIn);
+            logger.success('服务启动指令已发送');
         }
-        logger.header('NodeBBS 启动成功！');
+        // 5. 启动后操作 (仅完整部署)
+        if (!flags.build) {
+            await waitForHealth(composeFiles, isBuiltIn);
+            const pushDb = await confirm({
+                message: '是否推送数据库 schema？',
+                default: false
+            });
+            if (pushDb) {
+                logger.info('正在推送数据库 schema...');
+                await execCompose(composeFiles, 'api', ['npm', 'run', 'db:push'], isBuiltIn);
+                logger.success('数据库 schema 推送完成');
+            }
+            const seedDb = await confirm({
+                message: '是否初始化种子数据？',
+                default: false
+            });
+            if (seedDb) {
+                logger.info('正在初始化数据...');
+                await execCompose(composeFiles, 'api', ['npm', 'run', 'seed'], isBuiltIn);
+                logger.success('数据初始化完成');
+            }
+        }
+        logger.header(flags.build ? '启动成功！' : 'NodeBBS 启动成功！');
         // 6. 显示信息
         logger.info(`环境: ${env}`);
-        // 复用之前的 envConfig 或重新读取 (这里直接复用即可，或者为了保险重新读取但不要 redeclare)
-        const finalEnvConfig = dotenv.config().parsed || {};
-        const webPort = finalEnvConfig.WEB_PORT || '3100';
-        const apiPort = finalEnvConfig.API_PORT || '7100';
+        const envConfig = dotenv.config().parsed || {};
+        const webPort = envConfig.WEB_PORT || '3100';
+        const apiPort = envConfig.API_PORT || '7100';
         console.log(`  Web 前端: http://localhost:${webPort}`);
         console.log(`  API 服务: http://localhost:${apiPort}`);
         console.log(`  API 文档: http://localhost:${apiPort}/docs`);

package/dist/templates/docker-compose.lowmem.yml

@@ -1,6 +1,19 @@
+# 低内存环境 Docker Compose 覆盖配置
+# 适用于 1C1G 或 1C2G 的低配服务器
+# 使用方式: docker compose -f docker-compose.yml -f docker-compose.lowmem.yml up -d
+
 services:
   # PostgreSQL 数据库 - 低内存优化
   postgres:
+    restart: always
+    ports: []  # 不暴露端口到主机，只在内部网络访问
+    environment:
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    healthcheck:
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 40s
     deploy:
       resources:
         limits:
@@ -10,13 +23,14 @@ services:
           cpus: '0.1'
           memory: 128M
     logging:
+      driver: "json-file"
       options:
         max-size: "5m"
         max-file: "2"
 
   # Redis 缓存 - 低内存优化
   redis:
-    # 降低内存限制
+    restart: always
     command: >
       redis-server
       --requirepass ${REDIS_PASSWORD}
@@ -26,6 +40,12 @@ services:
       --maxmemory-policy allkeys-lru
       --save 900 1
       --save 300 10
+    ports: []  # 不暴露端口到主机
+    healthcheck:
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 20s
     deploy:
       resources:
         limits:
@@ -35,15 +55,23 @@ services:
           cpus: '0.1'
           memory: 64M
     logging:
+      driver: "json-file"
       options:
         max-size: "5m"
         max-file: "2"
 
   # API 服务 - 低内存优化
   api:
+    restart: always
     environment:
-      # 降低 Node.js 内存限制
+      USER_CACHE_TTL: ${USER_CACHE_TTL:-300}
+      JWT_SECRET: ${JWT_SECRET}
+      CORS_ORIGIN: ${CORS_ORIGIN}
+      APP_URL: ${APP_URL}
+      # Node.js 内存限制
       NODE_OPTIONS: "--max-old-space-size=384"
+    volumes:
+      - api_uploads:/app/apps/api/uploads
     healthcheck:
       start_period: 90s  # 低内存环境启动更慢
       interval: 60s
@@ -56,13 +84,22 @@ services:
           cpus: '0.2'
           memory: 256M
     logging:
+      driver: "json-file"
       options:
         max-size: "10m"
+        max-file: "3"
 
   # Web 前端服务 - 低内存优化
   web:
+    restart: always
+    build:
+      args:
+        NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL}
+        NEXT_PUBLIC_APP_URL: ${NEXT_PUBLIC_APP_URL}
     environment:
-      # 降低 Node.js 内存限制
+      NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL}
+      NEXT_PUBLIC_APP_URL: ${NEXT_PUBLIC_APP_URL}
+      # Node.js 内存限制
       NODE_OPTIONS: "--max-old-space-size=384"
     healthcheck:
       start_period: 90s  # 低内存环境启动更慢
@@ -76,5 +113,14 @@ services:
           cpus: '0.2'
           memory: 256M
     logging:
+      driver: "json-file"
       options:
         max-size: "10m"
+        max-file: "3"
+
+# 网络配置
+networks:
+  nodebbs-network:
+    ipam:
+      config:
+        - subnet: 172.28.0.0/16

package/dist/templates/docker-compose.prod.yml

@@ -0,0 +1,120 @@
+# 生产环境 Docker Compose 覆盖配置
+# 使用方式: docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
+# 本文件只包含与 docker-compose.yml 的差异部分
+
+services:
+  # PostgreSQL 数据库 - 生产环境优化
+  postgres:
+    restart: always
+    ports: []  # 生产环境不暴露端口到主机，只在内部网络访问
+    environment:
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}  # 生产环境必须设置强密码
+    healthcheck:
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 40s
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 512M
+        reservations:
+          cpus: '0.25'
+          memory: 256M
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # Redis 缓存 - 生产环境优化
+  redis:
+    restart: always
+    command: >
+      redis-server
+      --requirepass ${REDIS_PASSWORD}
+      --appendonly yes
+      --appendfsync everysec
+      --maxmemory 256mb
+      --maxmemory-policy allkeys-lru
+    ports: []  # 生产环境不暴露端口到主机
+    healthcheck:
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 20s
+    deploy:
+      resources:
+        limits:
+          cpus: '0.5'
+          memory: 256M
+        reservations:
+          cpus: '0.1'
+          memory: 128M
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # API 服务 - 生产环境优化
+  api:
+    restart: always
+    environment:
+      USER_CACHE_TTL: ${USER_CACHE_TTL:-300}  # 生产环境缓存时间更长
+      JWT_SECRET: ${JWT_SECRET}  # 生产环境必须设置
+      CORS_ORIGIN: ${CORS_ORIGIN}  # 生产环境必须明确设置
+      APP_URL: ${APP_URL}  # 生产环境实际域名
+      NODE_OPTIONS: "--max-old-space-size=512"  # 限制 Node.js 内存使用
+    volumes:
+      - api_uploads:/app/apps/api/uploads  # 生产环境不挂载源代码
+    healthcheck:
+      start_period: 60s
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 768M
+        reservations:
+          cpus: '0.3'
+          memory: 384M
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "20m"
+        max-file: "5"
+
+  # Web 前端服务 - 生产环境优化
+  web:
+    restart: always
+    build:
+      args:
+        NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL}
+        NEXT_PUBLIC_APP_URL: ${NEXT_PUBLIC_APP_URL}
+    environment:
+      NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL}
+      NEXT_PUBLIC_APP_URL: ${NEXT_PUBLIC_APP_URL}
+      NODE_OPTIONS: "--max-old-space-size=512"  # 限制 Node.js 内存使用
+    healthcheck:
+      start_period: 60s
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 768M
+        reservations:
+          cpus: '0.3'
+          memory: 384M
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "20m"
+        max-file: "5"
+
+# 网络 - 生产环境使用固定子网
+networks:
+  nodebbs-network:
+    ipam:
+      config:
+        - subnet: 172.28.0.0/16