nodebbs 0.1.0 → 0.3.0-beta.0

package/dist/commands/pack/index.js

@@ -4,7 +4,8 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { getTemplatePath } from '../../utils/template.js';
-import { checkDocker } from '../../utils/docker.js';
+import { checkDocker, getComposeFiles, runCompose } from '../../utils/docker.js';
+import { getDeploymentMode } from '../../utils/selection.js';
 export default class Pack extends Command {
     static description = '生成离线部署包';
     static flags = {
@@ -19,61 +20,67 @@ export default class Pack extends Command {
         const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nodebbs-pack-'));
         this.log(`正在准备构建环境: ${tmpDir}`);
         try {
+            const mode = await getDeploymentMode();
+            if (mode !== 'source') {
+                this.error('打包命令仅支持源码部署模式。请在 NodeBBS 项目根目录下运行 (需要包含 package.json 和源代码)。');
+            }
             // 2. 导出配置文件
-            // 这里我们需要获取当前的 docker-compose.yml 和 prod 配置
-            // 假设用户当前目录下有这些文件，或者我们就用内置模板？
-            // 更好的方式是：如果在当前目录找到了配置文件，就用当前的；否则用内置模板。
-            // 但既然是打包，通常是想把当前开发好的代码打包。
-            // 所以我们假设在项目根目录运行。
-            if (!fs.existsSync('docker-compose.yml')) {
-                // TODO: 从 templates 复制 (简化起见，我们假设用户在项目根目录，或者我们强制要求)
-                // 如果没找到，我们实际上无法 build api/web，因为 build context 需要源码。
-                // 所以必须要求在项目根目录运行。
-                this.error('请在 NodeBBS 项目根目录下运行此命令 (需要包含 docker-compose.yml 和源代码)。');
+            // 使用 getComposeFiles 获取准确的配置文件路径 (包含 base 和 override)
+            // 默认打包生产环境配置
+            const { files, isBuiltIn } = await getComposeFiles('production');
+            if (isBuiltIn) {
+                console.warn('当前目录未找到 docker-compose.yml，将使用内置模板。');
             }
-            // 3. 构建镜像
-            this.log('正在构建应用镜像 (这可能通过需要几分钟)...');
-            await execa('docker', ['compose', 'build'], { stdio: 'inherit' });
+            // 3. 构建应用镜像
+            this.log('正在构建应用镜像 (这可能需要几分钟)...');
+            // 注意：如果使用内置模板，context 可能是错的，但 build 命令通常需要 context。
+            // getComposeFiles 返回的 file path 是绝对路径。
+            // 如果是 isBuiltIn，说明用的是 cli/templates/docker-compose.yml
+            // 在 source 模式下，如果必须用内置模板作为 base，我们需要确保 build context 正确。
+            // 如果我们只是为了获取 content，那没问题。但 docker compose build 需要 context。
+            // 我们之前 manual check 的时候，如果 missing local file, we fallback to template path.
+            // runCompose 会 handle -f arguments.
+            // 这里为了简单，我们直接运行 build。
+            // 但要注意，如果 isBuiltIn，runCompose 会自动加 --project-directory cwd
+            // 这里我们主要目的是打包，所以 build 应该基于 cwd。
+            // 原有逻辑直接 execa('docker', ['compose', 'build'])，这依赖于 cwd 下有 docker-compose.yml。
+            // 如果 cwd 下没有，我们需要传 -f。
+            // 所以这里应该使用 runCompose 来执行 build，以确保参数一致性
+            await runCompose(files, ['build'], isBuiltIn);
             // 4. 拉取依赖镜像
             this.log('正在确保数据库镜像已下载...');
             await execa('docker', ['pull', 'postgres:16-alpine'], { stdio: 'inherit' });
             await execa('docker', ['pull', 'redis:7-alpine'], { stdio: 'inherit' });
             // 5. 导出镜像
             this.log('正在导出镜像到文件 (nodebbs-images.tar)...');
-            // 获取实际的镜像名，这里假设 docker-compose build 生成的镜像名符合预期
-            // 通常是 <dir>_api 和 <dir>_web，或者我们在 compose 文件里指定了 image name?
-            // 查看 template: 没有指定 image name，所以默认为 ${dirname}-api。
-            // 为了确保准确，我们可以解析 docker compose config 的输出，或者强制指定 image name。
-            // 更稳妥的方式：直接 save 指定的服务镜像。
-            // docker compose images -q 可以获取 ID。
             // 获取所有相关镜像的列表
             const projectName = path.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9]/g, '');
-            const images = [
-                'postgres:16-alpine',
-                'redis:7-alpine',
-                `${projectName}-api`, // 默认命名规则
-                `${projectName}-web`
-            ];
-            // 我们最好通过 docker compose config 来确认镜像名，但这比较复杂。
+            // 我们最好通过 docker compose config 来确认镜像名
             // 简单策略：先 save postgres 和 redis，对于 api 和 web，我们先 tag 一下以确保名字固定。
             await execa('docker', ['tag', `${projectName}-api`, 'nodebbs-api:latest']);
             await execa('docker', ['tag', `${projectName}-web`, 'nodebbs-web:latest']);
             const imagesToSave = ['postgres:16-alpine', 'redis:7-alpine', 'nodebbs-api:latest', 'nodebbs-web:latest'];
             await execa('docker', ['save', '-o', path.join(tmpDir, 'nodebbs-images.tar'), ...imagesToSave], { stdio: 'inherit' });
-            // 6. 复制配置文件 (并进行修改)
-            // 读取 docker-compose.yml 并移除开发环境的源码挂载
-            // 这是一个关键步骤，因为在离线/生产环境中，我们不应该挂载 ./apps/xxx/src，
-            // 否则会覆盖掉镜像内构建好的代码，导致 "Cannot find module" 错误。
-            let composeContent = fs.readFileSync('docker-compose.yml', 'utf-8');
+            // 6. 复制配置文件 (并进行修改) - 移除源码挂载，适配离线环境
+            // files[0] -> Base
+            // files[1] -> Override (Optional)
+            const baseFile = files[0];
+            let composeContent = fs.readFileSync(baseFile, 'utf-8');
             const lines = composeContent.split('\n');
             const cleanedLines = lines.map(line => {
                 // 移除 api 和 web 的源码挂载
-                if (line.includes('./apps/api/src') || line.includes('./apps/web/src')) {
+                if (line.match(/- \.\/apps\/.*\/src:\/app\/apps\/.*\/src/)) {
                     return line.replace(/^/, '# [OFFLINE-PACK-REMOVED] ');
                 }
                 return line;
             });
             fs.writeFileSync(path.join(tmpDir, 'docker-compose.yml'), cleanedLines.join('\n'));
+            // 处理 Override 文件 (files[1])
+            // 我们的 install.sh 期望 docker-compose.prod.yml
+            if (files.length > 1) {
+                const overrideFile = files[1];
+                fs.copyFileSync(overrideFile, path.join(tmpDir, 'docker-compose.prod.yml'));
+            }
             if (fs.existsSync('.env')) {
                 this.warn('检测到 .env 文件，出于安全考虑，不会默认打包 .env 文件。请在部署时手动配置环境变量。');
             }
@@ -97,14 +104,9 @@ if [ ! -f .env ]; then
     echo "警告: 未找到 .env 文件，将使用默认配置或报错。请先复制 .env.example 为 .env 并修改配置。"
 fi
 
-# 修改 image 名称以匹配 load 进来的 tag (如果 compose 文件里没写 image，它会尝试 build)
-# 为了避免 build，我们需要修改 docker-compose.yml 或者使用环境变量 override
-# 最简单的办法：我们在 install 脚本里，强制用 docker run 或者修改 compose 文件?
-# 这里的难点是 compose file 里写的是 build: .
-# 离线环境没法 build。
-# 解决方案：生成一个专门的 docker-compose.offline.yml
-
-cat > docker-compose.override.yml <<EOF
+# 启动服务 (强制使用离线镜像)
+# 我们需要覆盖 build 配置，强制使用 image
+cat > docker-compose.offline.yml <<EOF
 services:
   api:
     build: !reset
@@ -114,9 +116,21 @@ services:
     image: nodebbs-web:latest
 EOF
 
-COMPOSE_FILES="-f docker-compose.yml -f docker-compose.override.yml"
+# 注意：这里假设第二个文件总是 docker-compose.prod.yml
+# 如果没有 override，命令可能会报错吗？
+# 我们在 pack 的时候，只要 files > 1，就生成了 docker-compose.prod.yml
+# 如果只有 base，install.sh 里的 -f docker-compose.prod.yml 会报错。
+# 应该动态生成 install.sh 或者在这里加判断。
+# 简单起见，我们确保 docker-compose.prod.yml 存在 (即使只是空的内容或者仅包含 version?)
+# 或者在 install.sh 里判断文件是否存在。
 
-docker compose \$COMPOSE_FILES up -d
+COMPOSE_Args="-f docker-compose.yml"
+if [ -f docker-compose.prod.yml ]; then
+    COMPOSE_Args="$COMPOSE_Args -f docker-compose.prod.yml"
+fi
+COMPOSE_Args="$COMPOSE_Args -f docker-compose.offline.yml"
+
+docker compose $COMPOSE_Args up -d
 
 echo "部署完成！"
 `;
@@ -137,7 +151,9 @@ echo "部署完成！"
         }
         finally {
             // 清理临时目录
-            fs.rmSync(tmpDir, { recursive: true, force: true });
+            if (fs.existsSync(tmpDir)) {
+                fs.rmSync(tmpDir, { recursive: true, force: true });
+            }
         }
     }
 }

package/dist/commands/restart/index.js

@@ -1,9 +1,10 @@
 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, getDeploymentMode } from '../../utils/selection.js';
+import { initImageEnv } from '../../utils/env.js';
 export default class Restart extends Command {
-    static description = '重启所有服务 (up --force-recreate)';
+    static description = '重启服务';
     static flags = {
         env: EnvFlag,
     };
@@ -13,12 +14,17 @@ export default class Restart extends Command {
         const env = await selectEnvironment(flags.env);
         const { files, isBuiltIn } = await getComposeFiles(env);
         logger.info('正在重启服务 (使用现有镜像)...');
-        logger.info('环境: ' + env);
-        // 使用 up -d --force-recreate 可以：
-        // 1. 如果服务不存在，则创建并启动
-        // 2. 如果服务已存在，则强制重启
+        // 确保镜像配置存在
+        await initImageEnv();
+        const mode = await getDeploymentMode();
+        logger.info(`环境: ${env} (${mode === 'image' ? '镜像部署' : '源码部署'})`);
         // 3. 不会执行构建 (除非镜像不存在)
-        await runCompose(files, ['up', '-d', '--force-recreate'], isBuiltIn);
+        // 在镜像模式下，我们需要确保不尝试构建 (哪怕镜像丢失，应该是 pull 而不是 build)
+        const args = ['up', '-d', '--force-recreate'];
+        if (mode === 'image') {
+            args.push('--no-build');
+        }
+        await runCompose(files, args, isBuiltIn);
         logger.success('服务已重启');
     }
 }

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

@@ -1,23 +1,28 @@
 import { Command, Flags } from '@oclif/core';
 import { confirm } from '@inquirer/prompts';
 import { checkDocker, runCompose, waitForHealth, execCompose, getComposeFiles } from '../../utils/docker.js';
-import { initEnv, checkEnv } from '../../utils/env.js';
+import { initEnv, checkEnv, initDockerIgnore, initImageEnv } 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';
+import { EnvFlag, selectEnvironment, getDeploymentMode } from '../../utils/selection.js';
 export default class Start extends Command {
-    static description = '开始部署';
+    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,88 @@ 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();
+        // 确保 .dockerignore 存在
+        await initDockerIgnore();
+        await initImageEnv();
         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
             });
+            if (!continueDeploy) {
+                logger.info('操作已取消。');
+                this.exit(0);
+            }
         }
-        // 构造新的镜像名称
-        // 逻辑：如果 .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();
+        // 4. 构建并启动服务
+        const mode = await getDeploymentMode();
+        if (flags.build) {
+            if (mode === 'image') {
+                logger.warning('镜像部署模式下不支持重新构建，将尝试拉取最新镜像...');
+                await runCompose(composeFiles, ['pull'], isBuiltIn);
+                await runCompose(composeFiles, ['up', '-d'], isBuiltIn);
+                logger.success('服务已更新并启动');
+            }
+            else {
+                logger.info('正在重新构建并启动服务...');
+                await runCompose(composeFiles, ['up', '-d', '--build'], isBuiltIn);
+                logger.success('服务已重新构建并启动');
             }
-            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 推送完成');
+        else {
+            if (mode === 'source') {
+                logger.info('正在构建 Docker 镜像...');
+                await runCompose(composeFiles, ['build', '--no-cache'], isBuiltIn);
+                logger.success('镜像构建完成');
+            }
+            else {
+                logger.info('检测到镜像部署模式，跳过本地构建...');
+                // 可选：在这里也可以尝试 pull 一下，或者让 up -d 自动处理
+                // await runCompose(composeFiles, ['pull'], isBuiltIn)
+            }
+            logger.info('正在启动服务...');
+            await runCompose(composeFiles, ['up', '-d'], isBuiltIn);
+            logger.success('服务启动指令已发送');
         }
-        const seedDb = await confirm({
-            message: '是否初始化种子数据？',
-            default: false
-        });
-        if (seedDb) {
-            logger.info('正在初始化数据...');
-            await execCompose(composeFiles, 'api', ['npm', 'run', 'seed'], isBuiltIn);
-            logger.success('数据初始化完成');
+        // 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('NodeBBS 启动成功！');
+        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';
+        logger.info(`环境: ${env} (${mode === 'image' ? '镜像部署' : '源码部署'})`);
+        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/commands/upgrade/index.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Upgrade 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/upgrade/index.js

@@ -0,0 +1,39 @@
+import { Command } from '@oclif/core';
+import { runCompose, getComposeFiles } from '../../utils/docker.js';
+import { logger } from '../../utils/logger.js';
+import { EnvFlag, selectEnvironment, getDeploymentMode } from '../../utils/selection.js';
+import { initImageEnv } from '../../utils/env.js';
+import Start from '../start/index.js';
+export default class Upgrade extends Command {
+    static description = '升级服务';
+    static flags = {
+        env: EnvFlag,
+    };
+    async run() {
+        const { flags } = await this.parse(Upgrade);
+        // 1. 检查部署模式
+        const mode = await getDeploymentMode();
+        if (mode === 'source') {
+            logger.info('当前为源码部署模式，执行重建...');
+            const args = ['--build'];
+            if (flags.env)
+                args.push('--env', flags.env);
+            await Start.run(args);
+            return;
+        }
+        // 2. 镜像模式：拉取更新并重启
+        logger.header('NodeBBS 服务升级');
+        // 选择环境 (通常需要与运行中一致，这里重新选择以防万一，或者可以复用 restart 的逻辑不传 env 则自选)
+        //为了简单，我们遵循 restart 的模式
+        const env = await selectEnvironment(flags.env);
+        // 确保镜像配置存在
+        await initImageEnv();
+        const { files, isBuiltIn } = await getComposeFiles(env);
+        logger.info('正在拉取最新镜像...');
+        await runCompose(files, ['pull'], isBuiltIn);
+        logger.success('镜像已更新');
+        logger.info('正在重新启动服务...');
+        await runCompose(files, ['up', '-d'], isBuiltIn);
+        logger.success('服务已升级并启动');
+    }
+}

package/dist/interactive.js

@@ -29,7 +29,7 @@ export async function runInteractive(root) {
     }
     await navigate(tree, [], config);
 }
-const GLOBAL_PRIORITY = ['start', 'stop', 'restart', 'rebuild', 'status', 'logs', 'shell', 'db', 'pack'];
+const GLOBAL_PRIORITY = ['start', 'stop', 'restart', 'upgrade', 'status', 'logs', 'shell', 'db', 'pack'];
 const SCOPED_PRIORITIES = {
     'logs': ['all', 'web', 'api', 'db', 'redis'],
 };

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

@@ -0,0 +1,10 @@
+services:
+  api:
+    build:
+      context: .
+      dockerfile: apps/api/Dockerfile
+
+  web:
+    build:
+      context: .
+      dockerfile: apps/web/Dockerfile

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

@@ -1,6 +1,12 @@
+# 低内存环境 Docker Compose 覆盖配置
+# 适用于 1C1G 或 1C2G 的低配服务器
+# 使用方式: docker compose -f docker-compose.yml -f docker-compose.lowmem.yml up -d
+
 services:
-  # PostgreSQL 数据库 - 低内存优化
+  # PostgreSQL - 低内存优化
   postgres:
+    restart: always
+    ports: []
     deploy:
       resources:
         limits:
@@ -10,16 +16,18 @@ services:
           cpus: '0.1'
           memory: 128M
     logging:
+      driver: "json-file"
       options:
         max-size: "5m"
         max-file: "2"
 
-  # Redis 缓存 - 低内存优化
+  # Redis - 低内存优化
   redis:
-    # 降低内存限制
+    restart: always
+    ports: []
     command: >
       redis-server
-      --requirepass ${REDIS_PASSWORD}
+      --requirepass ${REDIS_PASSWORD:-redis_password}
       --appendonly yes
       --appendfsync everysec
       --maxmemory 128mb
@@ -35,18 +43,17 @@ services:
           cpus: '0.1'
           memory: 64M
     logging:
+      driver: "json-file"
       options:
         max-size: "5m"
         max-file: "2"
 
-  # API 服务 - 低内存优化
+  # API - 低内存优化
   api:
+    restart: always
     environment:
-      # 降低 Node.js 内存限制
+      # 严格限制 Node.js 内存
       NODE_OPTIONS: "--max-old-space-size=384"
-    healthcheck:
-      start_period: 90s  # 低内存环境启动更慢
-      interval: 60s
     deploy:
       resources:
         limits:
@@ -56,17 +63,17 @@ services:
           cpus: '0.2'
           memory: 256M
     logging:
+      driver: "json-file"
       options:
         max-size: "10m"
+        max-file: "3"
 
-  # Web 前端服务 - 低内存优化
+  # Web - 低内存优化
   web:
+    restart: always
     environment:
-      # 降低 Node.js 内存限制
+      # 严格限制 Node.js 内存
       NODE_OPTIONS: "--max-old-space-size=384"
-    healthcheck:
-      start_period: 90s  # 低内存环境启动更慢
-      interval: 60s
     deploy:
       resources:
         limits:
@@ -76,5 +83,9 @@ services:
           cpus: '0.2'
           memory: 256M
     logging:
+      driver: "json-file"
       options:
         max-size: "10m"
+        max-file: "3"
+
+

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

@@ -0,0 +1,89 @@
+# 生产环境 Docker Compose 覆盖配置
+# 使用方式: docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
+# 本文件只包含与 docker-compose.yml 的差异部分
+
+services:
+  # PostgreSQL - 生产环境安全与资源优化
+  postgres:
+    restart: always
+    ports: []  # 安全：不暴露端口到主机
+    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
+    ports: []  # 安全：不暴露端口到主机
+    command: >
+      redis-server
+      --requirepass ${REDIS_PASSWORD}
+      --appendonly yes
+      --appendfsync everysec
+      --maxmemory 256mb
+      --maxmemory-policy allkeys-lru
+    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:
+      # 生产环境特有配置
+      NODE_OPTIONS: "--max-old-space-size=512"
+    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
+    environment:
+      # 生产环境特有配置
+      NODE_OPTIONS: "--max-old-space-size=512"
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 768M
+        reservations:
+          cpus: '0.3'
+          memory: 384M
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "20m"
+        max-file: "5"
+
+