在 Windows 上使用 Docker、Git Bash 和 overleaf-toolkit 部署 Overleaf 社区版

0. 前言#

Overleaf 是一个广受欢迎的在线 LaTeX 编辑器，它极大地简化了 LaTeX 的使用门槛。虽然官方提供了在线服务，但是处于数据隐私、网络稳定或自定义需求，我们常常希望搭建一个私有的 Overleaf 实例。Overleaf 官方提供了基于 Docker 的 toolkit 工具来简化社区版的部署流程。

然而，官方的 toolkit 主要面向 Linux/macOS 环境，在 Windows 上通过 Git Bash 执行时会遇到一个棘手的路径问题。本教程将详细记录如何在 Windows 11/10 环境下，借助 Docker Desktop 和 Git Bash，成功部署 Overleaf 社区版，并提供关键的脚本修复方案。

1. 环境准备#

在开始之前，请确保你的系统已安装并正确配置了以下软件：

• Windows 10/11：需开启 Hyper-V 或 WSL 2 功能
• Docker Desktop for Windows：建议使用 WSL 2 后端，性能更佳。安装后请确保 Docker 服务已正常启动。
• Git for Windows: 安装时请务必勾选 Git Bash Here 选项，我们将使用它来执行 shell 脚本。

笔者环境参考：

• OS: Windows 11 Professional 24H2
• Docker: 28.5.1
• Git: 2.51.0.windows.2

2. 部署步骤#

1
# 进入 D:\
2
cd /d
3

4
# 克隆官方仓库
5
git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit
6
cd ./overleaf-toolkit

1
OVERLEAF_IN_CONTAINER_DATA_PATH=/var/lib/overleaf

1
OVERLEAF_IN_CONTAINER_DATA_PATH=//var/lib/overleaf

1
./bin/init

1
./bin/up

3. 日常管理#

在日常使用中，你可能会需要启动或停止 Overleaf 服务。

• 停止服务：在 overleaf-toolkit 目录下打开 Git Bash，执行：

1
./bin/stop

• 重新启动服务：同样，在 overleaf-toolkit 目录下执行：

1
./bin/up

总结#

通过对 bin/docker-compose 脚本进行一个小小的修改，我们成功解决了 overleaf-toolkit 在 Windows + Git Bash 环境下的路径兼容性问题，顺利地部署了 Overleaf 社区版。自托管 Overleaf 不仅保障了数据安全，还提供了更自由的定制空间。

希望这篇教程能帮助到同样遇到此问题的同学。