自制 ShareLaTeX 镜像
Overleaf 官方的 sharelatex 镜像的 TeX Live 版本可能较旧，无法安装最新的宏包，并且往往只包含了少量的基础宏包。为了方便使用，我们可以自己构建一个使用最新 TeX Live 的镜像，并一次安装全部宏包。下面是自制镜像的过程。
⚠️: 自制镜像需要 40 分钟左右
构建镜像
我们可以使用官方的配置构建新的镜像，或者在官方已经构建好的镜像的基础上重新构建自己的镜像。
如果你和我一样，使用 ARM 架构的芯片，那么你最好使用官方配置构建一个新的镜像。因为官方的 ShareLaTeX 镜像只有 amd64 版本。
使用官方配置构建镜像（推荐）
Overleaf 官方提供了一个仓库 overleaf，该仓库包含了构建 ShareLaTeX 镜像的全部配置文件。不过，该配置只会安装基础宏包套件 scheme-basic。我们需要修改配置文件以安装全部宏包套件 scheme-full。
-
克隆
overleaf仓库：# 克隆仓库 git clone https://github.com/overleaf/overleaf.git # 进入 overleaf/server-ce 目录 cd overleaf/server-ce -
修改安装方案为
scheme-full：# 修改配置文件以使用 scheme-full 套件 sed -i 's/scheme-basic/scheme-full/g' Dockerfile-base # TeX Live 换源（可选） sed -i 's@TEXLIVE_MIRROR=.*@TEXLIVE_MIRROR=https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet@g' Dockerfile-base -
安装依赖：
（可选）在
server-ce目录下新建一个目录fonts，并将你需要用到的字体拷贝进来，然后在Dockerfile合适的位置添加如下命令：ADD server-ce/fonts/ /usr/local/share/fonts/在上一条命令的下面添加如下命令，以安装宏包依赖：
RUN ln -s /usr/local/texlive/2024/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf && \ fc-cache -fv && \ apt-get update && \ apt-get install -y inkscape python3-pygments && \ echo "shell_escape = t" >> /usr/local/texlive/2024/texmf.cnf记得将路径中的
2024改为你当前最新版使用的年份你也可以在 APT 安装命令中添加 Windows 字体包
ttf-mscorefonts-installer提示：在使用 APT 安装软件包时你可能想要换源
-
构建镜像
make构建之后你会获得一个自己版本的
sharelatex/sharelatex:latest镜像。为了方便后面使用我们最好重新给它设置一个名字：docker tag sharelatex/sharelatex:latest xxx/sharelatex:5.0.3将
xxx替换为你喜欢的名字。版本号可以随意设置，不过要和之后运行 Overleaf 时toolkit/config/version中的版本号一致。
在官方镜像的基础上构建
新建一个 Dockerfile：
FROM sharelatex/sharelatex:5.0.3
# 拷贝字体文件。把你需要用到的字体放到 fonts 文件夹
ADD fonts/ /usr/local/share/fonts/
# 更新 TeX Live
RUN cd /tmp \
&& tlmgr path remove \
&& mv /usr/local/texlive/2023 /usr/local/texlive/2024 \
&& wget https://mirror.ctan.org/systems/texlive/tlnet/update-tlmgr-latest.sh \
&& export PATH="/usr/local/texlive/2024/bin/x86_64-linux:$PATH" \
&& sh update-tlmgr-latest.sh -- --upgrade \
&& tlmgr update --self --all \
&& tlmgr install scheme-full \
&& luaotfload-tool -fu \
&& tlmgr path add \
&& ln -s /usr/local/texlive/2024/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf \
&& fc-cache -fv
# 安装依赖
RUN apt-get update && \
apt-get install -y inkscape python3-pygments && \
echo "shell_escape = t" >> /usr/local/texlive/2024/texmf.cnf
EXPOSE 80
ENTRYPOINT ["/sbin/my_init"]
记得将所有路径中的
2024改为你当前最新版使用的年份提示：在使用 APT 安装软件包时你可能想要换源
如果需要设置 TeX Live 镜像源，可以在上面配置中添加：
&& tlmgr option repository https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet \
即：
RUN cd /tmp \
...
&& tlmgr option repository https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet && \
# 添加到 tlmgr update 之上
&& tlmgr update --self --all \
...
编译
docker build . --tag xxx/sharelatex:5.0.3
将
xxx替换为你喜欢的名字。版本号可以随意设置，不过要和之后运行 Overleaf 时toolkit/config/version中的版本号一致。
启动 ShareLaTeX
-
克隆
toolkit仓库并初始化：git clone https://github.com/overleaf/toolkit.git cd toolkit bin/init # 初始化 -
检查 ShareLaTeX 版本，打开
config/version，检查其中的版本号和你之前构建的镜像的版本号是否一致。 -
ShareLaTeX 的启动脚本检测环境变量
OVERLEAF_IMAGE_NAME来确定要使用的 ShareLaTeX 镜像。因此启动 ShareLaTeX 时需要将OVERLEAF_IMAGE_NAME变量设为你编译的镜像，然后再运行start脚本：OVERLEAF_IMAGE_NAME=xxx/sharelatex bin/start或者你嫌麻烦，可以直接在启动脚本中加入环境变量
OVERLEAF_IMAGE_NAME。编辑bin/docker-compose：#! /usr/bin/env bash # shellcheck source-path=.. # 加入下面这行 OVERLEAF_IMAGE_NAME=xxx/sharelatex set -euo pipefail然后重新运行
bin/up，之后再用bin/start启动。
参考：实践自部署 Overleaf
相关阅读：本地部署 Overleaf 服务
