添加Docker部署支持并升级Node.js版本至LTS 22

[NTLx]

概述

本PR为项目添加了完整的Docker部署支持，并将Node.js运行环境从v18升级至v22 LTS版本。这一变更不仅增强了项目的部署灵活性，还确保了与最新Node.js生态系统的兼容性，同时提升了整体性能和安全性。

变更背景与目的

随着容器化技术在现代软件开发中的普及，以及Node.js 22 LTS版本的发布，我们决定进行以下关键更新：

1. Docker部署支持：添加完整的容器化解决方案，简化部署流程，提高环境一致性
2. Node.js版本升级：从v18升级至v22 LTS，获得最新性能优化和安全更新
3. 文档全面更新：确保所有文档与新的技术栈保持一致

这些变更将显著提升项目的部署体验、运行效率和长期维护性。

主要实现功能

1. Docker容器化支持

我们添加了完整的Docker部署解决方案，包括：

Dockerfile

• 基于Node.js 22 Alpine镜像构建，优化镜像大小
• 多阶段构建策略，减少最终镜像体积
• 配置健康检查端点，确保服务可靠性
• 设置非root用户运行，提高安全性

FROM node:22-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

FROM node:22-alpine
RUN addgroup -g 1001 -S nodejs
RUN adduser -S nodejs -u 1001
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
USER nodejs
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD node healthcheck.js
CMD ["node", "src/index.js"]

docker-compose.yml

• 提供一键启动的容器编排配置
• 配置本地目录挂载，实现数据持久化
• 设置环境变量，简化配置流程
• 包含端口映射和网络配置

version: '3.8'
services:
  pubmed-server:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - PUBMED_API_KEY=${PUBMED_API_KEY}
      - PUBMED_EMAIL=${PUBMED_EMAIL}
    volumes:
      - ./cache:/app/cache
      - ./downloads:/app/downloads
    restart: unless-stopped

.dockerignore

• 排除不必要的文件和目录，优化构建上下文
• 减少镜像大小，提高构建速度
• 保护敏感信息不被包含在镜像中

2. Docker部署文档

新增了详细的Docker部署指南(docs/DOCKER_README.md)，包含：

• 前置要求：Docker 20.10+、Docker Compose安装指南
• 环境变量配置：PubMed API密钥等关键配置说明
• 部署方式：Docker Compose和直接Docker命令两种方式
• 服务端点：SSE连接、消息处理、健康检查等API说明
• 生产环境建议：反向代理、HTTPS配置、监控等最佳实践
• 故障排除：常见问题及解决方案

3. Node.js版本升级

将项目运行环境从Node.js v18升级至v22 LTS，涉及以下更新：

package.json

{
  "engines": {
    "node": ">=22.0.0"
  }
}

README.md更新

• 前置要求中Node.js版本从v18.0.0+更新为v22.0.0+ LTS
• 更新安装和部署指南中的Node.js版本引用
• 确保所有示例命令使用正确的Node.js版本

GitHub Actions工作流

• 更新.github/workflows/publish.yml中的Node.js版本为22
• 确保CI/CD流程使用最新的Node.js版本

技术方案说明

Docker架构设计

我们采用了多阶段构建策略，优化Docker镜像：

1. 构建阶段：安装依赖，进行生产环境优化
2. 运行阶段：复制必要文件，配置运行环境
3. 安全配置：使用非root用户，最小权限原则
4. 健康检查：定期检查服务状态，确保可靠性

数据持久化方案

通过Docker卷挂载实现数据持久化：

volumes:
  - ./cache:/app/cache        # 缓存目录
  - ./downloads:/app/downloads # 下载文件目录

这确保了容器重启后数据不会丢失，同时便于备份和迁移。

环境变量管理

Docker部署支持通过环境变量进行配置：

• PUBMED_API_KEY：PubMed API访问密钥
• PUBMED_EMAIL：API访问邮箱
• NODE_ENV：运行环境（development/production）
• PORT：服务端口（默认3000）
• ABSTRACT_MODE：摘要处理模式（quick/deep）
• FULLTEXT_MODE：全文下载模式（enabled/disabled）

代码结构调整

新增文件

1. Dockerfile - 容器构建配置
2. docker-compose.yml - 容器编排配置
3. .dockerignore - 构建忽略文件配置
4. docs/DOCKER_README.md - Docker部署详细文档

修改文件

1. README.md

   • 添加Docker部署作为推荐方法
   • 更新Node.js版本要求为v22.0.0+ LTS
   • 增加Docker快速启动指南

2. package.json

   • 更新engines.node字段为">=22.0.0"
   • 确保依赖兼容Node.js 22

3. .github/workflows/publish.yml

   • 更新Node.js版本为22
   • 确保CI/CD流程与新版本兼容

4. docs/GITHUB_ACTIONS_PUBLISH.md

   • 更新文档中的Node.js版本引用
   • 确保发布指南与实际配置一致

测试情况

Docker部署测试

我们进行了全面的Docker部署测试：

1. 构建测试：验证Docker镜像构建成功
2. 启动测试：确认容器正常启动并监听端口
3. 功能测试：验证所有API端点正常工作
4. 持久化测试：确认数据在容器重启后保持
5. 健康检查测试：验证健康检查端点正常响应

Node.js 22兼容性测试

1. 单元测试：所有现有测试在Node.js 22环境下通过
2. 集成测试：验证与外部服务（PubMed API）的兼容性
3. 性能测试：对比Node.js 18和22的性能表现
4. 依赖测试：确保所有npm包与Node.js 22兼容

兼容性考虑

向后兼容性

1. API兼容性：所有现有API保持不变，确保客户端无需修改
2. 配置兼容性：环境变量配置方式保持一致
3. 数据兼容性：现有缓存和数据格式完全兼容

部署方式兼容性

1. 传统部署：仍支持直接在服务器上安装Node.js运行
2. 容器部署：新增Docker部署方式，提供更多选择
3. 云端部署：SSE模式部署流程保持不变

潜在风险及应对措施

风险评估

1. Node.js版本升级风险

   • 风险：某些依赖可能不兼容Node.js 22
   • 应对：全面测试所有依赖，更新不兼容的包

2. Docker部署学习成本

   • 风险：用户可能不熟悉Docker部署
   • 应对：提供详细文档和一键启动脚本

3. 容器安全风险

   • 风险：容器配置不当可能导致安全问题
   • 应对：遵循Docker安全最佳实践，使用非root用户

缓解措施

1. 渐进式迁移：提供多种部署方式，用户可逐步迁移
2. 全面文档：提供详细的迁移指南和故障排除文档
3. 监控支持：添加健康检查和日志记录，便于问题诊断

性能提升

Node.js 22 LTS带来了多项性能改进：

1. V8引擎更新：JavaScript执行性能提升
2. 内存管理优化：减少内存占用，提高稳定性
3. 网络性能增强：改善HTTP/HTTPS处理效率
4. 模块加载优化：加快应用启动速度

安全增强

1. 最新安全补丁：获得Node.js 22的最新安全更新
2. 容器安全：使用非root用户，最小权限原则
3. 依赖安全：更新依赖包，修复已知安全漏洞

总结

本PR成功实现了以下目标：

1. ✅ 添加完整的Docker部署支持，简化部署流程
2. ✅ 升级Node.js至v22 LTS，提升性能和安全性
3. ✅ 更新所有相关文档，确保一致性
4. ✅ 保持向后兼容性，不影响现有用户
5. ✅ 提供详细的部署指南和故障排除文档

这些变更将显著提升项目的部署体验、运行效率和长期维护性，使项目更好地适应现代开发和部署环境。我们建议用户优先采用Docker部署方式，以获得最佳体验。

[NTLx]

Hi! This PR is now MERGEABLE.

Summary:

• Added Docker deployment support and upgraded Node.js to LTS 22

Ready for merge!