Overleaf/ShareLaTeX 升级 TeX Live 2024 的解决方案

在 Overleaf/ShareLaTeX 项目中，当用户尝试安装完整的 TeX Live 套件(scheme-full)时，可能会遇到版本不兼容的问题。本文将详细解释这一问题的成因，并提供完整的解决方案。

问题背景

当在 Overleaf/ShareLaTeX 环境中执行 docker exec sharelatex tlmgr install scheme-full 命令时，系统会报错提示本地 TeX Live 版本(2023)比远程仓库版本(2024)旧，无法直接进行跨版本更新。

根本原因

TeX Live 的版本更新机制要求用户必须使用专门的升级脚本进行跨版本更新，而不能直接通过 tlmgr 命令完成。这是 TeX Live 项目设计的安全机制，防止意外的大版本升级导致系统不稳定。

解决方案

1. 获取升级脚本

首先需要下载官方的升级脚本：

wget http://mirror.ctan.org/systems/texlive/tlnet/update-tlmgr-latest.sh
chmod +x update-tlmgr-latest.sh

2. 执行升级

运行以下命令完成升级：

./update-tlmgr-latest.sh -- --update

3. 进入 Docker 容器

对于不熟悉 Docker 的用户，需要先进入容器内部：

docker exec -it sharelatex bash

然后在容器内执行上述升级命令。

4. 持久化升级

升级完成后，为了确保容器重启后不丢失更新，需要提交容器更改：

docker commit sharelatex sharelatex/sharelatex:<自定义标签>

然后在 docker-compose.yml 中更新镜像引用：

services:
    sharelatex:
        image: sharelatex/sharelatex:<自定义标签>

最新版本支持

在 Overleaf Server Pro 5.1 及更高版本中，这一问题已得到修复，用户可以直接安装 scheme-full 而无需手动升级。

技术建议

1. 定期检查 TeX Live 版本更新
2. 对于生产环境，建议在测试环境中先验证升级
3. 考虑使用版本控制管理 Docker 镜像变更
4. 备份重要数据后再进行大版本升级

通过以上步骤，用户可以顺利完成 TeX Live 从 2023 到 2024 版本的升级，并安装完整的 TeX Live 套件。