别再只用在线版了！手把手教你用Docker Compose在本地服务器部署私有Overleaf（含TeXLive完整版升级）-程序员充电站

私有化部署Overleaf全攻略：从零构建企业级LaTeX协作平台

在学术写作和技术文档领域，Overleaf已成为LaTeX用户的首选协作工具。然而，当团队需要处理敏感研究数据或企业需要符合内部合规要求时，公有云服务往往无法满足需求。私有化部署不仅能解决数据安全问题，还能根据团队需求深度定制功能——比如预装数千个TeXLive宏包以避免编译中断的尴尬。

我曾为某生物医药团队部署私有Overleaf时发现，他们90%的编译错误都源于缺失的化学结构绘图包。通过本文介绍的全套方案，你将掌握如何在内网环境搭建功能比官方托管版更强大的Overleaf实例，特别针对科研场景优化了LaTeX生态支持。

1. 环境规划与资源评估

私有化部署的首要任务是明确硬件需求。根据托管文档项目的规模和并发用户数，推荐以下配置基准：

用户规模	CPU核心	内存	存储空间	适用场景
1-5人	2核	4GB	20GB	个人或小型课题组
5-20人	4核	8GB	100GB	实验室或研发小组
20+人	8核	16GB+	500GB+	院系或企业级部署

关键组件依赖：

Docker 20.10+
Docker Compose 2.0+
Git 2.20+
至少10GB的可用磁盘空间用于TeXLive完整版

实测发现，TeXLive完整版安装需要约8GB空间，而每个活跃用户会占用约500MB内存。如果团队常处理包含大量高分辨率图片的文档，建议额外预留存储空间。

2. 部署流程精要

2.1 基础设施准备

对于Ubuntu 22.04 LTS系统，执行以下命令完成基础环境配置：

# 安装必备工具 sudo apt update && sudo apt install -y git curl python3-pip # 配置Docker官方源 curl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER # 安装Compose插件 sudo apt install -y docker-compose-plugin

为避免权限问题，建议新建专用数据目录：

mkdir -p /opt/overleaf/{data,config} chmod -R 775 /opt/overleaf

2.2 获取部署套件

Overleaf官方维护的Toolkit简化了部署流程：

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

此时目录结构应包含：

bin/：操作脚本集
config/：自定义配置文件
lib/：Docker编排模板

2.3 关键配置调整

编辑config/overleaf.rc定义核心参数：

OVERLEAF_IMAGE_NAME=sharelatex/sharelatex OVERLEAF_DATA_PATH=/opt/overleaf/data OVERLEAF_PORT=8080 SHARELATEX_APP_NAME="Private Overleaf"

对于需要外网访问的情况，务必修改：

OVERLEAF_LISTEN_IP=0.0.0.0

3. TeXLive完整版集成方案

官方镜像仅包含基础TeX包，这些操作可扩展至完整环境：

3.1 进入容器终端

bin/shell

3.2 执行完整安装

# 更新包管理器 tlmgr update --self # 安装完整套件（耗时约60分钟） tlmgr install scheme-full # 补充常见科研包 tlmgr install \ chemfig \ siunitx \ pgfplots \ biblatex \ minted

遇到跨版本问题时，使用官方升级脚本：

wget https://mirror.ctan.org/systems/texlive/tlnet/update-tlmgr-latest.sh sh update-tlmgr-latest.sh -- --upgrade

3.3 固化定制镜像

docker commit sharelatex private/overleaf:full-texlive

更新配置指向新镜像：

OVERLEAF_IMAGE_NAME=private/overleaf:full-texlive

4. 高级管理技巧

4.1 批量用户导入

创建users.csv文件格式：

email,password,is_admin user1@domain.com,pass123,true user2@domain.com,pass456,false

执行导入脚本：

while IFS=, read -r email pass admin; do bin/docker-compose exec sharelatex \ node modules/server-ce-scripts/scripts/create-user \ --email="$email" --password="$pass" $([ "$admin" = "true" ] && echo "--admin") done < users.csv

4.2 自动化备份策略

设置每日凌晨的完整备份：

# 备份脚本示例 tar -czf /backups/overleaf-$(date +%F).tar.gz \ /opt/overleaf/data \ /opt/overleaf/toolkit/config

搭配MongoDB专业备份工具：

docker exec mongo mongodump --archive=/data/db/backup.gz --gzip

5. 性能调优实战

5.1 编译集群配置

在docker-compose.override.yml中添加：

services: sharelatex: environment: TEXMFVAR: "/var/lib/texmf" PATH: "/usr/local/texlive/2023/bin/x86_64-linux:${PATH}" deploy: resources: limits: cpus: '4' memory: 8G

5.2 Redis缓存优化

调整config/variables.env：

REDIS_MAX_MEMORY=1gb REDIS_MAX_MEMORY_POLICY=allkeys-lru

5.3 Nginx前端加速

示例配置：

server { listen 443 ssl; server_name latex.yourdomain.com; location / { proxy_pass http://localhost:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_read_timeout 86400s; } }