ShareLaTeX 社区版 Docker Compose 部署架构解析

概述

ShareLaTeX 是一个开源的在线 LaTeX 协作编辑平台，本文将从技术架构角度深入解析其 Docker Compose 部署方案。通过分析其服务组成、数据存储和网络配置，帮助开发者理解 ShareLaTeX 的微服务架构设计。

核心服务架构

ShareLaTeX 采用典型的微服务架构，通过 Docker Compose 编排多个独立服务：

1. 前端服务：

   • web：主Web应用服务
   • webpack：前端资源打包和热更新服务

2. 协作编辑核心：

   • real-time：实时协作服务
   • document-updater：文档更新服务
   • project-history：项目历史服务

3. 编译系统：

   • clsi：LaTeX编译服务(CLSI)
   • spelling：拼写检查服务

4. 存储服务：

   • filestore：文件存储服务
   • docstore：文档存储服务
   • history-v1：历史版本服务

5. 辅助服务：

   • chat：聊天服务
   • contacts：联系人服务
   • notifications：通知服务

数据存储设计

ShareLaTeX 使用多种数据存储方案，通过Docker卷实现持久化：

volumes:
  clsi-cache:       # LaTeX编译缓存
  clsi-output:      # 编译输出
  filestore-public-files:  # 公共文件
  filestore-template-files: # 模板文件
  filestore-uploads:       # 上传文件
  filestore-user-files:    # 用户文件
  mongo-data:       # MongoDB数据
  redis-data:       # Redis数据
  sharelatex-data:  # 共享数据
  spelling-cache:   # 拼写检查缓存
  web-data:         # Web应用数据
  history-v1-buckets: # 历史版本存储桶

这种设计实现了：

• 不同类型数据隔离存储
• 服务重启后数据不丢失
• 便于备份和迁移

关键服务配置解析

LaTeX编译服务(CLSI)

clsi:
  build:
    context: ..
    dockerfile: services/clsi/Dockerfile
  environment:
    - DOCKER_RUNNER=true
    - TEXLIVE_IMAGE=texlive-full
  volumes:
    - ${PWD}/compiles:/overleaf/services/clsi/compiles
    - ${DOCKER_SOCKET_PATH:-/var/run/docker.sock}:/var/run/docker.sock

CLSI服务特点：

• 使用Docker-in-Docker技术隔离编译环境
• 支持自定义TeXLive镜像(texlive-full)
• 挂载主机Docker socket实现动态容器管理
• 独立缓存和输出卷提高性能

文件存储服务(Filestore)

filestore:
  volumes:
    - filestore-public-files:/overleaf/services/filestore/public_files
    - filestore-template-files:/overleaf/services/filestore/template_files
    - filestore-uploads:/overleaf/services/filestore/uploads
    - filestore-user-files:/overleaf/services/filestore/user_files

文件分类存储设计：

• 公共文件：系统级共享资源
• 模板文件：LaTeX模板库
• 上传文件：用户上传的原始文件
• 用户文件：用户项目文件

历史版本服务(History-v1)

history-v1:
  environment:
    OVERLEAF_EDITOR_ANALYTICS_BUCKET: "/buckets/analytics"
    OVERLEAF_EDITOR_BLOBS_BUCKET: "/buckets/blobs"
    PERSISTOR_BACKEND: fs
  volumes:
    - history-v1-buckets:/buckets

历史服务特点：

• 多类型数据分桶存储
• 支持文件系统后端(PERSISTOR_BACKEND)
• 包含分析数据、二进制大对象等专用存储

数据库服务

mongo:
  image: mongo:5
  command: --replSet overleaf
  
redis:
  image: redis:5

数据库配置要点：

• MongoDB配置为副本集(生产环境推荐)
• Redis作为缓存和消息代理
• 数据卷确保持久化

开发环境特色配置

web:
  environment:
    - APP_NAME=Overleaf Community Edition
    - EMAIL_CONFIRMATION_DISABLED=true
    - NODE_ENV=development
    - OVERLEAF_ALLOW_PUBLIC_ACCESS=true

webpack:
  command: ["npx", "webpack", "serve", "--config", "webpack.config.dev-env.js"]
  ports:
    - "127.0.0.1:80:3808"

开发优化配置：

• 禁用邮件确认简化测试
• 允许公开访问
• Webpack热重载支持
• 前端资源实时编译

部署建议

1. 硬件要求：

   • 至少4GB内存(编译LaTeX需要资源)
   • 建议SSD存储提高编译速度

2. 网络配置：

   • 确保容器间网络通畅
   • 暴露必要端口(80, 443)

3. 安全建议：

   • 生产环境应配置TLS
   • 限制公共访问
   • 定期备份数据卷

4. 性能优化：

   • 调整CLSI服务资源限制
   • 配置Redis缓存策略
   • 监控关键服务指标

总结

ShareLaTeX的Docker Compose配置展示了一个复杂的在线协作系统的微服务架构设计。通过分析其服务划分、数据存储和网络交互，开发者可以深入理解如何构建类似的实时协作平台。这种架构提供了良好的扩展性，各服务可以独立扩展以满足不同负载需求。