告别 LaTeX 配置地狱:我的 Overleaf (ShareLaTeX-CE) 完整版私有化部署方案

HI! 作为一个经常和 LaTeX 打交道的人,我深知本地配置 TeX Live 环境有多么令人头疼。

适用于需要写论文, 基于latex模板的简历编写等期刊. 对于科研人需求更大, 包含了免费的多人协同编写和无限制的编译时间

因此,我基于官方 Docker 镜像,创建了一个完整的私有化部署方案 xuhe2/sharelatex-ce ,旨在解决部署中的两大痛点:缺少宏包硬件兼容性

痛点一:宏包缺失问题一次解决

官方提供的基础版 Overleaf Docker 镜像往往只包含最基础的 TeX Live 宏包。每当我们引入一个新的 .sty 文件,却发现编译报错,就得手动进入容器安装,非常繁琐。

在我的这个方案中,我在 Dockerfile 构建过程中集成了 完整的 TeX Live 安装。这意味着您部署完成后,几乎可以支持所有主流和非主流的 LaTeX 宏包,彻底告别"缺少文件"的编译错误,开箱即用。

痛点二:老旧硬件的兼容性考量(AVX 问题)

在私有化部署社区中,许多用户反映在不带 AVX 指令集 的老旧服务器或 NAS 上运行 MongoDB 时会失败,导致整个 Overleaf 服务无法启动。这是因为新版 MongoDB 对 CPU 架构有了更高的要求。

为了解决这个兼容性问题,我的镜像方案特意采用了兼容性更好的老版本 MongoDB 和 ShareLaTeX 基础镜像。虽然这牺牲了新版本的一些特性,但保证了它能在最广泛的硬件环境中稳定运行,让您的私有化部署不再受硬件限制。

部署与配置,一步到位

整个部署流程通过 Docker Compose 实现,非常便捷:

  1. 构建镜像: 使用提供的 Dockerfile 构建包含完整 TeX Live 的镜像。
  2. 一键启动: 使用 docker-compose up -d 启动 Overleaf、MongoDB 和 Redis 三大核心服务。
  3. 初始化 MongoDB 副本集: 部署后,通过一条 docker exec 命令初始化 MongoDB 副本集,确保 Overleaf 的所有功能正常启用。

如果您正计划私有化部署一个稳定、兼容性好且宏包齐全的 Overleaf 环境,欢迎访问我的 GitHub 仓库 xuhe2/sharelatex-ce ,查看详细的部署指南和 README 内容。

喜欢的请点一个STAR

希望这个项目能帮助大家更专注于内容创作.

相关推荐
爱凤的小光5 小时前
Linux清理磁盘技巧---个人笔记
linux·运维
耗同学一米八6 小时前
2026年河北省职业院校技能大赛中职组“网络建设与运维”赛项答案解析 1.系统安装
linux·服务器·centos
知星小度S7 小时前
系统核心解析:深入文件系统底层机制——Ext系列探秘:从磁盘结构到挂载链接的全链路解析
linux
2401_890443027 小时前
Linux 基础IO
linux·c语言
智慧地球(AI·Earth)8 小时前
在Linux上使用Claude Code 并使用本地VS Code SSH远程访问的完整指南
linux·ssh·ai编程
原神启动18 小时前
Docker 场景化作业:生产环境容器操作实训
运维·docker·容器
老王熬夜敲代码9 小时前
解决IP不够用的问题
linux·网络·笔记
zly35009 小时前
linux查看正在运行的nginx的当前工作目录(webroot)
linux·运维·nginx
QT 小鲜肉9 小时前
【Linux命令大全】001.文件管理之file命令(实操篇)
linux·运维·前端·网络·chrome·笔记
呼啦啦呼啦啦啦啦啦啦9 小时前
docker制作镜像的两种方式(保姆级教学)
运维·docker·容器