贴娘饭1. 为什么需要私有化部署Overleaf？
作为科研工作者和LaTeX重度用户，我经历过太多次这样的崩溃时刻：凌晨三点赶论文deadline时Overleaf突然卡顿，编译速度慢如蜗牛；合作者同时在线编辑导致版本冲突；或是需要插入涉密数据时对云端存储的安全性心存顾虑。这些问题最终促使我走上了私有化部署的道路。
私有化部署的核心价值在于：
- 性能可控：本地服务器资源独占，编译速度不再受共享平台限制
- 数据安全：敏感论文和实验数据完全掌握在自己手中
- 定制自由：可以安装任意LaTeX宏包和字体，不受平台白名单限制
- 离线可用：断网环境下仍能持续工作
重要提示：选择ShareLaTeX-CE社区版而非商业版，因为前者是开源的且功能完整，后者需要付费授权。最新稳定版本为v2.5.1，基于Node.js和MongoDB架构。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 硬件准备与基础环境配置
2.1 服务器选型建议
经过多次实测，推荐以下配置方案：
| 使用场景 | CPU核心 | 内存 | 存储 | 网络带宽 |
|---|---|---|---|---|
| 个人/小型团队 | 4核 | 8GB | 100GB | 100Mbps |
| 中型科研团队 | 8核 | 16GB | 500GB | 1Gbps |
| 机构级部署 | 16核+ | 32GB+ | 1TB+ | 10Gbps |
我在阿里云ECS上实测发现：编译含有200页公式的论文时，8核16GB配置比Overleaf官方免费版快3-5倍。如果预算有限，4核8GB是最低可行配置。
2.2 系统环境准备
以Ubuntu 20.04 LTS为例（CentOS也可行但需要调整部分命令）：
bash复制# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装基础依赖
sudo apt install -y git curl build-essential python3 python3-pip
# 配置SSH安全访问（关键步骤！）
sudo sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin no/' /etc/ssh/sshd_config
echo "AllowUsers your_username" | sudo tee -a /etc/ssh/sshd_config
sudo systemctl restart sshd
3. 核心组件安装与配置
3.1 数据库部署
ShareLaTeX-CE依赖MongoDB 4.4+，推荐以下优化配置：
bash复制# 安装MongoDB
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 656408E390CFB1F5
echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
sudo apt update
sudo apt install -y mongodb-org
# 优化配置
sudo sed -i 's/# engine:/ engine: wiredTiger/' /etc/mongod.conf
sudo sed -i 's/# wiredTiger:/ wiredTiger:/' /etc/mongod.conf
echo " collectionConfig:
blockCompressor: snappy
indexConfig:
prefixCompression: true" | sudo tee -a /etc/mongod.conf
sudo systemctl enable mongod
sudo systemctl start mongod
3.2 Node.js环境搭建
使用nvm管理Node版本更灵活：
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 16.14.2
npm install -g npm@8.5.0
npm install -g grunt-cli
4. ShareLaTeX-CE部署实战
4.1 源码获取与初始化
bash复制git clone https://github.com/sharelatex/sharelatex.git
cd sharelatex
git checkout v2.5.1
npm install
grunt install
4.2 关键配置调整
修改config/settings.coffee：
coffeescript复制module.exports =
clsi:
cmdRunner: "docker" # 使用Docker隔离编译环境更安全
docker:
socketPath: "/var/run/docker.sock"
path:
compilesDir: "/mnt/overleaf/compiles" # 建议挂载SSD存储
dumpFolder: "/mnt/overleaf/dumps"
redis:
host: "127.0.0.1"
port: "6379"
4.3 启动服务
bash复制# 首次启动需要初始化数据库
node modules/server-ce/scripts/initializedb.js
# 使用PM2守护进程
npm install -g pm2
pm2 start npm --name "sharelatex" -- run start:web
pm2 start npm --name "sharelatex-clsi" -- run start:clsi
pm2 save
pm2 startup
5. 高级优化与维护
5.1 编译性能调优
在config/settings.coffee中添加：
coffeescript复制 clsi:
compileGroup:
timeout: 60 # 延长编译超时时间
compileTimeout: 45
maxCompiles: 10 # 并发编译数
docker:
image: "texlive/texlive:latest" # 使用完整版TexLive镜像
memory: 4096 # 限制内存使用(MB)
5.2 定期维护脚本
创建/usr/local/bin/overleaf-maintenance.sh：
bash复制#!/bin/bash
# 清理旧编译文件
find /mnt/overleaf/compiles -type f -mtime +7 -delete
# 数据库优化
mongo sharelatex --eval "db.runCommand({compact: 'projects'})"
# 重启服务
pm2 restart all
设置cron每周执行：
bash复制0 3 * * 0 /usr/local/bin/overleaf-maintenance.sh
6. 常见问题解决方案
6.1 中文支持问题
安装完整中文字体包：
bash复制sudo apt install -y fonts-noto-cjk fonts-noto-cjk-extra
docker exec sharelatex tlmgr install ctex
6.2 PDF预览异常
调整config/settings.coffee：
coffeescript复制 apis:
pdfjs:
url: "http://localhost:3042"
workerPort: 3043
internal:
pdfjs:
enable: true
path: "modules/pdf-viewer"
6.3 第三方包安装
通过Docker容器安装缺失宏包：
bash复制docker exec sharelatex tlmgr install <package_name>
docker commit sharelatex texlive/texlive:latest
docker restart sharelatex
7. 安全加固措施
7.1 防火墙配置
bash复制sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
7.2 定期备份方案
bash复制# 数据库备份
mongodump --out /mnt/backups/mongodb-$(date +%Y%m%d)
# 文件备份
rsync -avz /mnt/overleaf /mnt/backups/overleaf-$(date +%Y%m%d)
# 加密上传到OSS
tar czf - /mnt/backups | openssl enc -aes-256-cbc -salt -out backup-$(date +%Y%m%d).tgz.enc
这套方案在我实验室稳定运行两年多，支撑了50+用户的日常论文写作。最关键的收获是：一定要做好定期备份，我曾经因为硬盘故障丢失过一周的数据。现在采用每日增量+每周全量的策略，备份文件同时存储在本地和云端。