mira-app-server 1.0.7 → 1.0.9

package/.dockerignore

@@ -1,16 +1,79 @@
+# Node modules 和包管理器文件
 node_modules
-npm-debug.log
-test
-plugins
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.yarn-integrity
+
+# 构建输出（会在容器内重新构建）
 dist
-tools
-data
-*.tar
+build
+
+# 源码文件（除了src目录）
 *.ts
-!dist
-.idea
+!src/**/*.ts
+
+# 测试相关
+test
+coverage
+.nyc_output
+
+# 开发工具配置
 .vscode
+.idea
+*.swp
+*.swo
+*~
+
+# Git相关
 .git
 .gitignore
+.gitattributes
+
+# 环境配置
+.env
+.env.local
+.env.*.local
+
+# 日志文件
+logs
+*.log
+
+# 临时文件
+.tmp
+.temp
+temp
+*.tmp
+
+# OS生成的文件
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Docker相关
+Dockerfile*
+docker-compose*
+.dockerignore
+*.tar
+
+# 数据库文件
 *.db
-*.md
+*.sqlite
+
+# 文档
+*.md
+README*
+
+# 脚本文件
+*.bat
+*.sh
+
+# 其他项目目录（如果不需要）
+tools
+data
+plugins

package/Dockerfile

@@ -1,42 +1,79 @@
-# 使用Node.js官方镜像作为基础
-FROM node:20-alpine
+# 多阶段构建 - 构建阶段
+FROM node:20-alpine AS builder
 
-# 安装构建依赖（用于编译native modules如sqlite3）
+# 安装构建依赖
 RUN apk add --no-cache \
     python3 \
     py3-setuptools \
     make \
     g++ \
-    sqlite \
-    sqlite-dev
+    sqlite-dev \
+    && rm -rf /var/cache/apk/*
+
+# 设置环境变量
+ENV SETUPTOOLS_USE_DISTUTILS=stdlib
 
 # 创建工作目录
 WORKDIR /app
 
-# 复制package.json和package-lock.json
+# 复制package.json和package-lock.json（利用Docker缓存）
 COPY package*.json ./
 
-# 复制项目文件（需要在npm install之前复制，因为prepublish脚本会运行build）
-COPY . .
+# 安装所有依赖（开发和生产）
+RUN npm ci && npm cache clean --force
 
-# 设置环境变量修复distutils问题并安装依赖
-ENV SETUPTOOLS_USE_DISTUTILS=stdlib
+# 复制源代码和配置文件
+COPY src/ ./src/
+COPY tsconfig.json ./
 
-# 清理现有的node_modules和package-lock.json（如果存在）
-RUN rm -rf node_modules package-lock.json
+# 构建项目
+RUN npm run build && \
+    # 删除开发依赖
+    npm prune --production && \
+    # 清理构建缓存
+    rm -rf /tmp/* /root/.npm
 
-# 先安装依赖
-RUN npm install
+# 多阶段构建 - 运行阶段
+FROM node:20-alpine AS runtime
 
-# 构建项目
-RUN npm run build
+# 只安装运行时必需的系统依赖
+RUN apk add --no-cache \
+    sqlite \
+    ffmpeg \
+    && rm -rf /var/cache/apk/*
+
+# 设置环境变量
+ENV NODE_ENV=production \
+    FFMPEG_PATH=/usr/bin/ffmpeg \
+    FFPROBE_PATH=/usr/bin/ffprobe
+
+# 创建非root用户
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S mira -u 1001
+
+# 创建工作目录并设置权限
+WORKDIR /app
+RUN chown mira:nodejs /app
+
+# 切换到非root用户
+USER mira
+
+# 复制package.json
+COPY --chown=mira:nodejs package*.json ./
+
+# 从构建阶段复制node_modules（只包含生产依赖）
+COPY --from=builder --chown=mira:nodejs /app/node_modules ./node_modules
+
+# 从构建阶段复制编译后的文件
+COPY --from=builder --chown=mira:nodejs /app/dist ./dist
 
-# 清理构建依赖以减小镜像大小
-RUN apk del python3 make g++
+# 健康检查（可选）
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD node -e "console.log('Health check')" || exit 1
 
 # 暴露端口
 EXPOSE 3000
 EXPOSE 8081
 
-# 启动命令(使用JSON格式)
-CMD ["npm", "start"]
+# 启动命令
+CMD ["node", "dist/index.js"]

package/Dockerfile.distroless

@@ -0,0 +1,52 @@
+# 极端优化版本 - 使用 distroless 镜像
+# 这个版本会产生最小的镜像，但调试会更困难
+
+# 构建阶段
+FROM node:20-alpine AS builder
+
+# 安装构建依赖
+RUN apk add --no-cache \
+    python3 \
+    py3-setuptools \
+    make \
+    g++ \
+    sqlite-dev \
+    && rm -rf /var/cache/apk/*
+
+ENV SETUPTOOLS_USE_DISTUTILS=stdlib
+
+WORKDIR /app
+
+# 复制并安装依赖
+COPY package*.json ./
+RUN npm ci && npm cache clean --force
+
+# 复制源码并构建
+COPY src/ ./src/
+COPY tsconfig.json ./
+RUN npm run build
+
+# 只保留生产依赖
+RUN npm prune --production && \
+    rm -rf /tmp/* /root/.npm
+
+# 最终运行阶段 - 使用 distroless
+FROM gcr.io/distroless/nodejs20-debian12:latest
+
+# 设置环境变量
+ENV NODE_ENV=production
+
+# 创建工作目录
+WORKDIR /app
+
+# 从构建阶段复制必要文件
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package.json ./package.json
+
+# 暴露端口
+EXPOSE 3000
+EXPOSE 8081
+
+# 启动命令（distroless 不支持shell，所以直接使用node）
+CMD ["dist/index.js"]

package/docker-build-optimized.bat

@@ -0,0 +1,64 @@
+@echo off
+setlocal enabledelayedexpansion
+
+REM Docker 镜像优化构建脚本 (Windows版本)
+REM 使用该脚本来构建更小的 Docker 镜像
+
+set IMAGE_NAME=mira-server
+set TAG=latest
+
+echo 🔨 开始构建优化的 Docker 镜像...
+
+REM 先检查网络连接
+echo 🔍 检查 Docker Hub 连接...
+docker pull hello-world:latest > nul 2>&1
+if !errorlevel! neq 0 (
+    echo ⚠️  Docker Hub 连接有问题，将使用备用方案
+    set USE_CN_MIRROR=1
+) else (
+    echo ✅ Docker Hub 连接正常
+    set USE_CN_MIRROR=0
+)
+
+echo.
+if !USE_CN_MIRROR! equ 1 (
+    echo 🇨🇳 使用国内镜像源构建...
+    docker build -f Dockerfile.distroless-cn -t "%IMAGE_NAME%:%TAG%" .
+) else (
+    echo 🌍 使用标准镜像构建...
+    docker build --no-cache --compress -t "%IMAGE_NAME%:%TAG%" .
+)
+
+if !errorlevel! neq 0 (
+    echo ❌ 构建失败！
+    echo.
+    echo 🔧 故障排除建议：
+    echo 1. 运行 docker-network-check.bat 检查网络
+    echo 2. 尝试使用: docker build -f Dockerfile.distroless-cn -t %IMAGE_NAME%:%TAG% .
+    echo 3. 或配置 Docker 镜像加速器
+    pause
+    exit /b 1
+)
+
+echo.
+echo 📊 镜像大小统计:
+docker images "%IMAGE_NAME%:%TAG%" --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
+
+echo.
+echo 🔍 镜像层分析:
+docker history "%IMAGE_NAME%:%TAG%" --human --format "table {{.CreatedBy}}\t{{.Size}}"
+
+echo.
+echo ✅ 构建完成！
+
+REM 可选：移除悬挂镜像以清理空间
+echo.
+echo 🧹 清理悬挂镜像...
+docker image prune -f
+
+echo.
+echo 💡 提示：
+echo - 使用 'docker run -p 3000:3000 -p 8081:8081 %IMAGE_NAME%:%TAG%' 运行容器
+echo - 使用 'docker scout cves %IMAGE_NAME%:%TAG%' 检查安全漏洞（如果安装了 Docker Scout）
+
+pause

package/docker-build-optimized.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# Docker 镜像优化构建脚本
+# 使用该脚本来构建更小的 Docker 镜像
+
+set -e
+
+# 镜像名称
+IMAGE_NAME="mira-server"
+TAG="latest"
+
+echo "🔨 开始构建优化的 Docker 镜像..."
+
+# 构建镜像
+docker build \
+  --no-cache \
+  --compress \
+  --squash \
+  -t "${IMAGE_NAME}:${TAG}" \
+  .
+
+echo "📊 镜像大小统计:"
+docker images "${IMAGE_NAME}:${TAG}" --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"
+
+echo "🔍 镜像层分析:"
+docker history "${IMAGE_NAME}:${TAG}" --human --format "table {{.CreatedBy}}\t{{.Size}}"
+
+echo "✅ 构建完成！"
+
+# 可选：移除悬挂镜像以清理空间
+echo "🧹 清理悬挂镜像..."
+docker image prune -f
+
+echo "💡 提示："
+echo "- 使用 'docker run -p 3000:3000 -p 8081:8081 ${IMAGE_NAME}:${TAG}' 运行容器"
+echo "- 使用 'docker scout cves ${IMAGE_NAME}:${TAG}' 检查安全漏洞（如果安装了 Docker Scout）"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mira-app-server",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Mira Server - standalone server application using mira-core",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,8 +11,8 @@
     "build": "tsc",
     "rebuild": "npm install && npm run build",
     "start": "node dist/index.js",
-    "start:ts": "ts-node src/index.ts",
-    "dev": "ts-node src/index.ts",
+    "start:ts": "node --inspect -r ts-node/register src/index.ts",
+    "dev": "node --inspect -r ts-node/register src/index.ts",
     "cli": "ts-node src/cli.ts",
     "prepublish": "npm run build"
   },
@@ -30,6 +30,6 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "mira-app-core": "^1.0.6"
+    "mira-app-core": "^1.0.12"
   }
 }