从Docker到团队协作：打造高效LaTeX写作环境的完整指南

当我在研究生实验室第一次尝试让整个团队迁移到自建Overleaf环境时，才意识到容器化部署只是万里长征的第一步。真正的挑战在于如何让这个系统在多人协作场景下稳定运行，同时兼顾安全性与使用体验。下面分享我们团队两年来的实战经验，从基础配置到高级运维技巧，帮你避开我们踩过的所有坑。

1. 基础环境搭建与优化

1.1 容器部署的正确姿势

官方Overleaf Toolkit确实简化了部署流程，但默认配置需要针对性调整才能适应团队环境。建议使用以下命令初始化项目：

git clone https://github.com/overleaf/toolkit.git ./overleaf-team
cd overleaf-team
bin/init

关键配置修改集中在三个文件：

• overleaf.rc：将监听IP改为0.0.0.0
• variables.env：设置时区TZ=Asia/Shanghai和语言OVERLEAF_SITE_LANGUAGE=zh-CN
• docker-compose.base.yml：映射端口建议使用80:80而非随机端口

注意：生产环境务必修改默认的MongoDB和Redis密码，这些信息在variables.env中可配置

1.2 TeXLive完整安装方案

官方镜像的TeXLive是精简版，团队协作必须安装完整套件。进入容器后执行：

tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/
tlmgr install scheme-full

安装完成后，建议在docker-compose.override.yml中添加持久化配置，避免重复安装：

services:
  sharelatex:
    volumes:
      - texlive-data:/usr/local/texlive
volumes:
  texlive-data:

2. 网络与访问控制

2.1 Nginx反向代理配置

直接暴露Docker端口存在安全隐患。以下是推荐Nginx配置：

server {
    listen 443 ssl;
    server_name latex.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

2.2 访问权限管理

Overleaf默认开放注册，团队环境应该限制访问。有三种可行方案：

方案类型	实施方式	适用场景	优缺点
邀请注册	关闭公开注册，管理员手动添加用户	小型固定团队	简单但管理成本高
LDAP集成	对接公司/学校目录服务	已有LDAP基础设施	配置复杂但管理方便
OAuth集成	对接GitHub/Google等认证	技术团队	用户体验好，依赖第三方

在variables.env中配置：

SHARELATEX_ALLOW_PUBLIC_REGISTRATION=false
SHARELATEX_LDAP_ENABLED=true
# LDAP具体配置略...

3. 数据安全与备份策略

3.1 持久化存储配置

必须为MongoDB和用户文件配置卷映射：

services:
  mongo:
    volumes:
      - mongo-data:/data/db
  sharelatex:
    volumes:
      - sharelatex-data:/var/lib/sharelatex
volumes:
  mongo-data:
  sharelatex-data:

3.2 自动化备份方案

我们采用的备份脚本示例（每天凌晨执行）：

#!/bin/bash
BACKUP_DIR=/path/to/backups
DATE=$(date +%Y%m%d)

# MongoDB备份
docker exec overleaf-mongo mongodump --archive > $BACKUP_DIR/mongo-$DATE.archive

# 用户文件备份
rsync -av /var/lib/docker/volumes/overleaf-team_sharelatex-data/_data $BACKUP_DIR/sharelatex-$DATE

# 保留最近7天备份
find $BACKUP_DIR -type f -mtime +7 -delete

4. 团队协作最佳实践

4.1 项目组织结构建议

• 按功能模块划分：每个子项目独立文档，主文档使用\include引用
• 版本控制集成：虽然Overleaf有历史记录，但重要节点应该推送到Git
• 模板标准化：建立团队模板库，包含：
  • 统一的页眉页脚
  • 预配置的参考文献样式
  • 常用宏包和命令定义

4.2 性能优化技巧

当团队规模超过10人时，可能需要调整默认配置：

1. 增加编译容器数量：

   SHARELATEX_COMPILES_PER_DOC=3
   

2. 调整资源限制：

   services:
     sharelatex:
       deploy:
         resources:
           limits:
             cpus: '2'
             memory: 4G
   

3. 启用编译缓存：

   SHARELATEX_COMPILE_CACHE_ENABLED=true
   

5. 常见问题排查

5.1 中文编译问题

即使安装了完整TeXLive，仍可能遇到：

• 字体缺失：将中文字体放入容器/usr/share/fonts/目录
• 编码问题：确保文档指定\documentclass[UTF8]{ctexart}
• 缓存干扰：清除/var/lib/sharelatex/compiles缓存

5.2 性能下降处理

当系统变慢时，检查：

1. MongoDB索引状态
2. Redis内存使用情况
3. 编译队列积压量

可以通过以下命令监控：

docker stats
docker exec overleaf-mongo mongotop

经过两年运行，我们的Overleaf实例已经稳定支持20多人的科研团队。最大的收获是：定期备份比想象中重要，而好的文档规范能减少80%的协作问题。现在每当有新成员加入，我们都会提供一份Markdown格式的《LaTeX协作规范》，这个小小的习惯让团队效率提升了至少三倍。