1. 为什么我们需要私有化部署Overleaf作为一个在学术界摸爬滚打多年的研究者我深知LaTeX排版系统的重要性也深刻体会过LaTeX配置地狱的痛苦。每次换新电脑、重装系统或者需要多人协作时那些繁琐的环境配置、包依赖冲突、字体缺失问题总让人抓狂。而Overleaf作为最流行的在线LaTeX编辑器虽然解决了跨设备和协作问题但免费版的功能限制和网络依赖又成了新的痛点。1.1 在线LaTeX编辑器的核心痛点免费版的Overleaf存在三大致命缺陷编译时间限制复杂文档经常因超时无法完成编译协作人数限制科研团队经常需要多人同时编辑隐私安全问题敏感研究内容上传到第三方服务器我团队最近就遇到了尴尬情况在论文截稿前一天Overleaf突然提示编译超时而本地环境又没配置好。这种关键时刻掉链子的经历促使我下决心搭建私有化部署方案。1.2 私有化部署的核心优势私有化部署的ShareLaTeX-CEOverleaf开源版完美解决了这些问题无编译时间限制支持大型文档自定义协作人数适合科研团队数据完全自主掌控符合机构安全要求可集成机构账号系统如LDAP支持离线使用网络不稳定时也能工作重要提示ShareLaTeX-CE是Overleaf收购前的开源版本虽然界面稍旧但核心功能完全一致且没有商业版的功能限制。2. 部署环境准备与架构设计2.1 硬件需求建议根据我们的实测经验不同规模团队的建议配置用户规模CPU内存存储适用场景1-5人2核4GB50GB个人或小型课题组5-20人4核8GB100GB中型实验室20人8核16GB500GB院系级部署我们实验室选择的是Dell R740xd服务器双路Xeon Silver 421020核40线程128GB DDR4 ECC内存1TB NVMe SSD 10TB HDD RAID5千兆网络连接这种配置可以轻松支持50人同时协作编译200页以上的论文毫无压力。2.2 软件依赖安装部署基于Ubuntu 20.04 LTS以下是必须的软件包# 基础依赖 sudo apt update sudo apt install -y \ git docker.io docker-compose \ texlive-full latexmk \ python3-pip nodejs npm \ redis-server # 配置docker免sudo sudo usermod -aG docker $USER newgrp docker # 验证安装 docker --version docker-compose --version特别注意texlive-full约4GB大小下载需要耐心内存小于8GB的机器建议改用texlive-base国内用户建议配置apt和npm镜像源2.3 网络架构设计我们的生产环境采用分层架构[客户端] ←HTTPS→ [Nginx] ←HTTP→ [ShareLaTeX] ↑ ├─ [Redis缓存] └─ [MongoDB数据库]关键配置要点使用Nginx做SSL终端和负载均衡Redis配置持久化避免会话丢失MongoDB启用认证和定期备份所有服务通过Docker隔离3. 分步部署指南3.1 获取ShareLaTeX-CE源码git clone https://github.com/sharelatex/sharelatex.git cd sharelatex git checkout v1.3.0 # 稳定版本国内用户建议使用Gitee镜像git clone https://gitee.com/mirrors/ShareLaTeX.git3.2 配置docker-compose.yml这是我们优化过的配置示例version: 3 services: sharelatex: build: . ports: - 5000:80 environment: - SHARELATEX_APP_NAMEPrivateOverleaf - SHARELATEX_MONGO_URLmongodb://mongo/sharelatex - SHARELATEX_REDIS_HOSTredis volumes: - data:/var/lib/sharelatex - /usr/local/texlive:/usr/local/texlive:ro depends_on: - mongo - redis mongo: image: mongo:4.4 volumes: - mongo_data:/data/db command: mongod --auth environment: - MONGO_INITDB_ROOT_USERNAMEadmin - MONGO_INITDB_ROOT_PASSWORDyour_secure_password redis: image: redis:6 volumes: - redis_data:/data command: redis-server --appendonly yes volumes: data: mongo_data: redis_data:3.3 初始化与启动# 构建镜像约10-20分钟 docker-compose build # 启动服务 docker-compose up -d # 初始化管理员账号 docker-compose exec sharelatex /bin/bash -c cd /var/www/sharelatex; grunt user:create-admin --emailadminyour.domain --passwordyour_password3.4 配置Nginx反向代理创建/etc/nginx/sites-available/overleaf.confserver { listen 443 ssl; server_name overleaf.your.domain; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://localhost:5000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Host $host; } }启用配置sudo ln -s /etc/nginx/sites-available/overleaf.conf /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx4. 高级配置与优化技巧4.1 TeX Live镜像加速国内用户必做优化修改/usr/local/texlive/texmf.cnf% 清华大学镜像源 TEXMFSYSTEM http://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet TEXMFDIST http://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet更新包数据库tlmgr update --self --all4.2 定期维护脚本创建/usr/local/bin/overleaf-maintenance#!/bin/bash # 每日凌晨3点执行维护 docker-compose -f /path/to/sharelatex/docker-compose.yml exec sharelatex /bin/bash -c cd /var/www/sharelatex; grunt check-references docker-compose -f /path/to/sharelatex/docker-compose.yml exec mongo mongodump --out /data/backup/$(date %Y%m%d) find /var/lib/docker/volumes/sharelatex_mongo_data/_data/backup/ -mtime 7 -delete添加到crontab(crontab -l ; echo 0 3 * * * /usr/local/bin/overleaf-maintenance) | crontab -4.3 常见问题排查指南编译超时问题检查docker-compose.yml中的资源限制增加Nginx超时设置proxy_read_timeout 300s; proxy_connect_timeout 300s;中文支持问题确保安装了完整中文字体包sudo apt install fonts-noto-cjk fonts-noto-cjk-extra在文档中使用\usepackage{xeCJK} \setCJKmainfont{Noto Serif CJK SC}PDF预览空白问题检查Nginx配置是否正确传递WebSocket确保Redis服务正常运行docker-compose exec redis redis-cli ping5. 生产环境安全加固5.1 安全防护措施防火墙规则sudo ufw allow 443/tcp sudo ufw enable定期更新docker-compose pull docker-compose build --no-cache数据库加密docker-compose exec mongo mongod --enableEncryption --encryptionKeyFile /data/keyfile5.2 监控与告警使用PrometheusGrafana监控关键指标# docker-compose-monitor.yml services: prometheus: image: prom/prometheus ports: [9090:9090] volumes: [./prometheus.yml:/etc/prometheus/prometheus.yml] grafana: image: grafana/grafana ports: [3000:3000]示例prometheus.yml配置scrape_configs: - job_name: overleaf static_configs: - targets: [sharelatex:80] - job_name: redis static_configs: - targets: [redis:6379]6. 实际使用体验与建议经过半年生产环境运行我们的私有Overleaf实例已稳定支持30多位研究人员。相比公共版私有部署带来了三大显著改进编译速度提升3-5倍百页文档编译仅需15秒团队协作更流畅实时预览延迟低于500ms定制化功能集成了机构SSO登录自动备份到校内NAS预装了学科专用模板对于考虑部署的用户我的实用建议首次部署建议先在测试环境演练做好每日数据库快照为不同课题组创建独立的群组空间定期清理未活跃项目我们设置了180天自动归档经验之谈在/var/lib/sharelatex/data目录下建立符号链接到NAS可以既享受Docker的便利性又保证数据安全。我们曾因未做这步导致一次磁盘故障损失了部分数据。
