告别 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

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

相关推荐
蝎子莱莱爱打怪15 小时前
GitLab CI/CD + Docker Registry + K8s 部署完整实战指南
后端·docker·kubernetes
chlk1231 天前
Linux文件权限完全图解:读懂 ls -l 和 chmod 755 背后的秘密
linux·操作系统
舒一笑1 天前
Ubuntu系统安装CodeX出现问题
linux·后端
改一下配置文件1 天前
Ubuntu24.04安装NVIDIA驱动完整指南(含Secure Boot解决方案)
linux
深紫色的三北六号1 天前
Linux 服务器磁盘扩容与目录迁移:rsync + bind mount 实现服务无感迁移(无需修改配置)
linux·扩容·服务迁移
SudosuBash2 天前
[CS:APP 3e] 关于对 第 12 章 读/写者的一点思考和题解 (作业 12.19,12.20,12.21)
linux·并发·操作系统(os)
小p2 天前
docker学习7:docker 容器的通信方式
docker
小p2 天前
docker学习5:提升Dockerfile水平的5个技巧
docker
小p2 天前
docker学习3:docker是怎么实现的?
docker
哈基咪怎么可能是AI2 天前
为什么我就想要「线性历史 + Signed Commits」GitHub 却把我当猴耍 🤬🎙️
linux·github