Overleaf LaTeX 在线编辑器部署教程

Overleaf 是目前最受欢迎的在线 LaTeX 编辑器，广泛用于学术论文、毕业论文和技术文档的撰写。其社区版（Overleaf Community Edition）是开源的，可以自行部署在服务器上使用。本文将介绍如何在搬瓦工 VPS 上通过 Docker 部署 Overleaf 社区版，并安装完整的 TeX Live 环境以支持中文排版。

一、Overleaf 社区版功能

在线 LaTeX 编辑：浏览器中直接编写和编译 LaTeX 文档，无需本地安装 TeX 发行版。
实时预览：编辑后即时查看 PDF 输出效果。
项目管理：创建和管理多个 LaTeX 项目，支持文件夹组织。
版本历史：追踪文档修改历史。
多用户支持：允许多用户注册和使用（社区版不支持实时协作编辑，但可共享项目）。
模板系统：可预置常用模板，如 IEEE、ACM 等期刊模板。

二、环境要求

Overleaf 对服务器资源要求较高，完整的 TeX Live 环境占用磁盘空间较大：

搬瓦工 VPS，建议 2GB 以上内存、40GB 以上硬盘（使用优惠码 NODESEEK2026 享受 6.77% 折扣）。
已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。
域名一个（推荐配置 HTTPS）。

2.1 创建项目目录

mkdir -p /opt/overleaf
cd /opt/overleaf

三、使用 Overleaf Toolkit 部署

Overleaf 官方提供了 Toolkit 工具来简化部署过程。

3.1 下载 Toolkit

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

3.2 初始化配置

bin/init

这会在 config/ 目录下生成配置文件。

3.3 编辑配置文件

# 编辑主配置
nano config/overleaf.rc

关键配置项：

OVERLEAF_LISTEN_IP=127.0.0.1
OVERLEAF_PORT=80
OVERLEAF_DATA_PATH=/opt/overleaf/data
SIBLING_CONTAINERS_ENABLED=false

编辑环境变量文件：

nano config/variables.env

设置以下变量：

OVERLEAF_APP_NAME=My LaTeX Editor
OVERLEAF_SITE_URL=https://latex.yourdomain.com
OVERLEAF_NAV_TITLE=LaTeX Editor
OVERLEAF_EMAIL_FROM_ADDRESS=noreply@yourdomain.com
OVERLEAF_ADMIN_EMAIL=admin@yourdomain.com

3.4 启动 Overleaf

bin/up -d

首次启动会下载镜像，需要等待几分钟。检查状态：

bin/doctor

四、创建管理员账户

Overleaf 不提供 Web 界面的注册页面，需要通过命令行创建第一个管理员账户：

cd /opt/overleaf/toolkit
bin/docker-compose exec sharelatex /bin/bash -c "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=admin@yourdomain.com"

执行后会输出一个密码重置链接，在浏览器中打开该链接设置密码。

五、安装完整 TeX Live

Overleaf Docker 镜像默认只包含基础的 TeX Live，如果需要编译复杂文档或使用中文，需要安装完整版本：

# 进入容器
docker exec -it sharelatex /bin/bash

# 更新 tlmgr
tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

# 安装完整 TeX Live（需要较长时间和大量磁盘空间）
tlmgr install scheme-full

# 或者只安装中文支持
tlmgr install ctex cjk xecjk

# 退出容器
exit

注意：完整的 TeX Live 安装需要约 7GB 磁盘空间，请确保 VPS 有足够的存储。

六、配置 Nginx 反向代理

cat > /etc/nginx/sites-available/overleaf <<'EOF'
server {
    listen 80;
    server_name latex.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    client_max_body_size 50m;
}
EOF

ln -sf /etc/nginx/sites-available/overleaf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d latex.yourdomain.com

七、添加自定义模板

你可以为用户预配置常用的论文模板：

以管理员身份登录 Overleaf。
创建一个新项目，上传模板文件。
在管理面板中将该项目标记为模板。

常用的模板包括：IEEE 期刊模板、ACM 会议模板、国内高校毕业论文模板等。

八、数据备份

# 备份数据目录
tar czf /opt/overleaf/backup_$(date +%Y%m%d).tar.gz /opt/overleaf/data

# 备份 MongoDB 数据库
docker exec sharelatex mongodump --out /tmp/mongodump
docker cp sharelatex:/tmp/mongodump /opt/overleaf/mongodump_$(date +%Y%m%d)

九、常见问题

编译超时

默认编译超时时间为 60 秒，对于大型文档可能不够。在 variables.env 中增加超时时间：

OVERLEAF_COMPILE_TIMEOUT=300

中文字体缺失

安装中文字体包：

docker exec -it sharelatex bash
apt update && apt install fonts-noto-cjk fonts-wqy-microhei -y
exit

内存不足导致编译失败

如果出现 OOM 错误，建议升级 VPS 方案或增加 swap 空间：

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

总结

Overleaf 社区版是学术写作者的利器，自行部署后可以不受官方免费版的协作人数和编译时长限制。建议选择磁盘空间充足的搬瓦工方案来部署。更多应用部署教程请参考 Docker 安装教程和 Nextcloud 云盘部署。选购搬瓦工 VPS 请访问 bwh81.net，购买时使用优惠码 NODESEEK2026 可享受 6.77% 优惠。