1. 为什么你需要一个本地版Overleaf如果你经常用Overleaf写论文肯定遇到过这样的场景DDL前夜疯狂改稿突然发现Overleaf服务器崩了或者编译速度慢得像蜗牛。我去年写毕业论文时就深有体会——每次点击编译都要等十几秒有时候还会遇到网络延迟导致编辑内容丢失。更不用说有些敏感数据放在云端总让人心里不踏实。本地部署Overleaf能完美解决这些问题。实测下来在我的ThinkPad上编译一个30页的LaTeX文档仅需1-2秒比云端快5-10倍。所有数据都存储在本地硬盘既不用担心服务中断也不用顾虑隐私泄露。更重要的是你可以完全自定义TeX环境安装任何你需要的宏包不用受限于云端版本。2. 环境准备这些工具缺一不可2.1 Docker安装与配置首先需要安装Docker Desktop for Windows。建议下载最新稳定版目前是4.25.0安装过程中有两个关键点需要注意启用WSL2后端这是性能最佳的选择。如果安装时提示缺少WSL2内核需要先安装WSL2 Linux内核更新包分配足够资源建议在Docker设置中给容器分配至少4GB内存8GB更佳否则编译大型文档时容易卡死。我通常这样配置# 查看当前资源限制 docker info | grep -i memory2.2 获取Overleaf镜像官方提供了两个关键镜像sharelatex/sharelatex: 基础镜像不含完整TeXLivesharelatex/sharelatex:with-texlive-full: 完整TeX环境镜像建议先拉取基础镜像等容器运行后再安装完整TeXLive这样更容易排查问题docker pull sharelatex/sharelatex3. 一步步搭建你的私有Overleaf3.1 配置docker-compose.yml从GitHub获取官方docker-compose文件时建议做以下修改端口映射将80:80改为9000:80避免与本地IIS冲突数据卷添加持久化存储防止数据丢失volumes: sharelatex_data: driver: local资源限制防止容器占用过多内存deploy: resources: limits: memory: 8G3.2 启动与初始化容器第一次启动时建议加上-d参数让容器在后台运行docker-compose up -d如果遇到端口冲突可以用这个命令找出占用端口的进程netstat -ano | findstr :90003.3 安装完整TeX环境使用中科大镜像源加速TeXLive安装docker exec sharelatex tlmgr option repository https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet/安装完整版需要约30分钟取决于网络速度建议在晚上进行。完成后记得提交镜像变更docker commit sharelatex sharelatex/sharelatex:with-texlive-full4. 高级配置与优化技巧4.1 用户管理与权限设置通过launchpad页面创建管理员账户后建议立即关闭公开注册在Admin Settings中设置allowPublicRegistration: false配置SMTP邮件服务这样用户才能收到密码重置邮件email: { smtpOptions: { host: smtp.example.com, port: 587, secure: false, auth: { user: userexample.com, pass: password } } }4.2 性能调优启用文档预编译docker exec sharelatex bash -c echo SHARELATEX_PRE_COMPILEtrue /etc/environment调整Node.js内存限制docker exec sharelatex node --max-old-space-size4096 web.js定期清理临时文件docker exec sharelatex find /var/lib/sharelatex/data/compiles -mtime 7 -delete5. 日常使用与维护5.1 启动与停止服务建议创建两个快捷脚本start_overleaf.bat:echo off cd /d %~dp0 docker-compose up -dstop_overleaf.bat:echo off cd /d %~dp0 docker-compose down5.2 数据备份策略Overleaf数据主要存储在三个位置用户文档/var/lib/sharelatex/data/user_files编译缓存/var/lib/sharelatex/data/compilesMongoDB数据库/var/lib/sharelatex/data/mongo建议每天用这个命令备份docker exec sharelatex tar -czvf /backup/overleaf-$(date %Y%m%d).tar.gz /var/lib/sharelatex/data6. 常见问题解决方案6.1 编译速度突然变慢可能原因及解决方法内存不足检查Docker资源使用情况适当增加内存限制磁盘空间不足清理旧的编译缓存docker exec sharelatex du -sh /var/lib/sharelatex/data/compiles宏包冲突尝试在项目设置中勾选清除缓存后编译6.2 中文支持问题确保安装了完整中文字体包docker exec sharelatex apt-get install fonts-noto-cjk然后在文档开头添加\usepackage{xeCJK} \setCJKmainfont{Noto Sans CJK SC}7. 与云端Overleaf协同工作虽然本地版功能强大但协作时仍需云端服务。我的工作流是这样的日常写作使用本地Overleaf享受闪电编译需要协作时将项目打包下载docker exec sharelatex tar -czvf project.tar.gz /var/lib/sharelatex/data/user_files/project_id上传到云端Overleaf进行协作完成后下载最新版同步到本地这样既保证了写作效率又不影响团队协作。我还写了个自动同步脚本可以定时将本地变更推送到Git仓库实现多设备同步。