升级 TeX Live

为了节省带宽，Overleaf Community Edition 和 Overleaf Pro 镜像仅包含一个最小安装的 TeX Live。您可以使用 tlmgr 命令在 sharelatex 容器内。

以下说明 仅 适用于 Community Edition 安装。我们强烈建议 Overleaf Pro 用户启用 沙箱编译 ，因为这为用户提供了与 overleaf.com 上使用的相同 TeX Live 镜像的访问权限，并在项目编译之间提供隔离以增强安全性。

进入 sharelatex 容器内部

要在 sharelatex 容器内启动一个 shell，请运行

bin/shell

您将看到类似如下的提示：

root@309b192d4030:/#

在下面的说明中，我们将假设您已在容器中。

确定您当前的 TeX Live 版本

TeX Live 每年大约在四月发布。使用 tlmgr 的步骤取决于您使用的是当前发行版还是较旧的版本。您可以使用以下命令检查正在运行的 TeX Live 版本 tlmgr --version。例如，此安装运行的是 TeX Live 2021：

# tlmgr --version
tlmgr 修订版 59291 (2021-05-21 05:14:40 +0200)
tlmgr 使用的安装路径：/usr/local/texlive/2021
TeX Live (https://tug.org/texlive) 版本 2021

TeX Live 的当前发行版可以在 TeX Live 主页.

找到。如果您正在运行较旧的 TeX Live 版本，您有两个选择。TeX Live 发布后不久通常会发布新的 Overleaf Docker 镜像，您可以等待它并使用 bin/upgrade 脚本升级您的部署，或者，如果您希望保留较旧的 TeX Live 发行版，您首先需要告诉 tlmgr 使用历史仓库。您可以在 这里.

找到相关说明。

安装软件包 sharelatex 要安装完整的 TeX Live，请在

容器内运行此命令：

tlmgr install scheme-full

您也可以手动安装单个软件包：

tlmgr install tikzlings tikzmarmots tikzducks 3.3.0 从 发行版起，运行 tlmgr path add 是 在每次使用 tlmgr install之后再次

所必需的，以便将所有二进制文件正确地符号链接到系统路径中。

还有更多命令可用。通过以下命令了解更多：

tlmgr help 完成后，输入 exit

或按 Control-D 退出 shell。

保存您的更改 sharelatex 您刚才所做的更改已更改了

容器，但这些更改是临时的 —— 如果 Docker Compose 重新创建容器（例如作为更新配置的一部分），它们将会丢失。 要使其持久化，请使用 docker commit

将更改保存为一个新的 docker 镜像：
cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full

echo 5.2.1-with-texlive-full > config/version 提交更改后，相应地更新 config/version bin/up。然后运行 sharelatex 容器内。

以重新创建 每当您 升级到新的 Overleaf 版本时，您都需要重复这些步骤。