Overleaf（sharelatex） docker 安装指南

这个教程使用 sharelatex 官方的 toolkit 来实现 overleaf（sharelatex）的安装，并封装具有完整 Texlive 的镜像。

需要的基本能力：
1. linux 基本操作，如 ssh、 shell 命令、sudo；
2. git 的基本操作，如pull/push等；
3. docker 的基本概念的理解，如容器、镜像、镜像源等；
4. Vim 或 nano 等编辑器的使用；
5. 科学上网。

1. 拉取安装脚本并初始化


1.1 从 GitHub 拉取文件并完成初始化

从 sharelatex 的 github 页面下载代码文件。

1. git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit && cd overleaf-toolkit

复制代码

因为绿联的系统不支持 git，所以需要手动从 github 页面下载整个库文件并解压缩到你的 docker 文件位置。



后面的操作默认在文件夹 overleaf-toolkit 中实现。官方在 bin 文件夹中提供了一系列脚本来方便安装。

1. 简单介绍常用的几个脚本
   
2. bin/doctor，用于输出目前容器配置环境状态，可用于检查；
   
3. bin/up，创建容器并拉起，可以使用 <b>-d</b> detach 参数来选择不输出 log；
   
4. bin/stop，停止容器；
   
5. bin/start，拉起容器；

复制代码

随后 sudo bin/init 来实现初始化。初始化后，在 ./config 文件夹中应该有以下三个文件，

overleaf.rc
variables.env
version

重要
建议先去修改 version 文件内容为镜像的最新 tag（最新 tag 见 [hub.docker.com/r/sharelatex/sharelatex/](https://hub.docker.com/r/sharelatex/sharelatex/)）。否则可能有一系列难搞的问题。同样，如果遇到难搞的问题，可以尝试拉取旧版本来处理。

1.2 修改监听IP和端口

在 ./config/overleaf.rc 中，需要修改以下字段：

OVERLEAF_LISTEN_IP=0.0.0.0 #监听所有的IP
OVERLEAF_PORT=8099           #默认是80端口

1.3 自定义网站名称、管理员邮箱

在 ./config/variables.env 文件中，修改：

OVERLEAF_APP_NAME="Hesheng's Overleaf"                     # 网页显示名称
OVERLEAF_SITE_URL=https://overleaf.hesheng.top:2053    # 网址，如果需要用外网访问
OVERLEAF_NAV_TITLE="Hesheng's Overleaf"                     # 网页 Tab 名称
[email protected]               # 管理员邮箱

1. 应用修改
   
2. 修改配置后需要重新创建容器才能应用新参数。
   
3. bin/stop && bin/up -d

复制代码

这个时候 bin/up 就已经能够拉起容器并使用了。

去到 http://localhost:8099/launchpad 就能创建管理员用户并开始使用了。

2. 安装完整版 TeXLive

2.1 更新文件

官方提供的镜像是不完整的 TexLive，缺少了很多宏包。还需要自己重新拉取并打包。

在拉起容器后，进入容器的命令行界面，进入到容器的文件夹

1. bin/up && bin/shell

复制代码

进入到 sharelatex 容器的 shell 中下载更新文件

1. # 下载并运行升级脚本
   
2. wget http://mirror.ctan.org/systems/texlive/tlnet/update-tlmgr-latest.sh
   
3. sh update-tlmgr-latest.sh -- --upgrade
   
4. 
   
5. # 更换texlive的下载源
   
6. tlmgr option repository https://mirrors.sustech.edu.cn/CTAN/systems/texlive/tlnet/
   
7. 
   
8. # 升级tlmgr
   
9. tlmgr update --self --all
   
10. 
    
11. # 安装完整版texlive（时间比较长，不要让shell断开）
    
12. tlmgr install scheme-full
    
13. 
    
14. # 你也可以安装一些其他的宏包
    
15. tlmgr install tikzlings tikzmarmots tikzducks

复制代码

然后 exit 退出容器内 shell，并 commit 镜像。

1. docker commit sharelatex sharelatex/sharelatex:with-texlive-full

复制代码

2.2 重新构建容器

在 ./config 目录下新建一个 docker-compose.override.yml 文件：

1. ---
   
2. version: '2.2'
   
3. services:
   
4.     sharelatex:
   
5.         image: sharelatex/sharelatex:with-texlive-full

复制代码

然后使用以下命令：

1. sudo bin/stop && sudo bin/docker-compose rm -f sharelatex && sudo bin/up -d

复制代码

重新构建容器。

警告
后面如果升级镜像，需要重复整个 安装完整版 TeXLive  的流程。最好保持记录自己安装过的宏包。或者写一个脚本实现以上流程的封装。

3. 参考文献

[1] “自建Overleaf - yangzhang’s Site.” Accessed: Nov. 13, 2025. [Online]. Available: https://yangzhang.site/Note/NAS/self-hosted-overleaf/

如果有需要，后续可以简单写个 docker compose 入门、linux 命令行简单使用指南以及 git 简单使用指南。

有没有更详细的步骤呀，卡在解压缩到docker文件夹位置了😂

期待更加完善的教程  

贺生 发表于 2025-11-13 21:34
如果有需要，后续可以简单写个 docker compose 入门、linux 命令行简单使用指南以及 git 简单使用指南。 ...

需要 docker compose    直接的   

贺生 发表于 2025-11-13 21:34
如果有需要，后续可以简单写个 docker compose 入门、linux 命令行简单使用指南以及 git 简单使用指南。 ...

期待简单的方法  太难了 搞不懂

跪求 docker compose  

贺生 发表于 2025-11-13 21:34
如果有需要，后续可以简单写个 docker compose 入门、linux 命令行简单使用指南以及 git 简单使用指南。 ...

付费   能绑忙弄一个吗