第一步：环境准备
在开始之前，请确保你的电脑已安装以下软件：
-
Docker Desktop: 官方下载地址。安装后请确保启用 WSL 2 后端。
-
Git for Windows (Git Bash): 官方下载地址。我们将使用 Git Bash 执行脚本。
第二步：克隆 Overleaf Toolkit
Overleaf 官方提供了一套工具包来简化部署。打开 Git Bash，进入你想存放项目的目录，执行：
git clone https://github.com/overleaf/toolkit.git overleaf-toolkit
cd overleaf-toolkit
第三步：初始化配置文件
进入目录后，执行初始化脚本以生成环境配置文件：
bin/init
执行后，config/ 目录下会生成 overleaf.rc、variables.env 、version三个配置文件。
第四步：解决 bin/up 报错（避坑指南）
在 Windows 的 Git Bash 中直接运行 bin/up 通常会遇到如下报错：
[+] Running 3/3
✔ Container redis Created 0.1s
✔ Container mongo Running 0.0s
✘ Container sharelatex Error response from dae… 0.0s
Error response from daemon: mount denied:
the source path "…(自己的路径)" too many colons
原因：
Git Bash 会自动将 /var/lib/overleaf 这种 Linux 路径转换成 Windows 盘符路径（带冒号），导致 Docker 无法识别。
解决方案：
不要直接修改 bin/up，而是修改 bin/docker-compose 脚本，在执行命令前禁止路径转换：
1、使用编辑器（如 VS Code 或记事本）打开 bin/docker-compose找到如下内容
function set_base_vars() {
…
OVERLEAF_IN_CONTAINER_DATA_PATH=/var/lib/overleaf
if [[ "$IMAGE_VERSION_MAJOR" -lt 5 ]]; then
OVERLEAF_IN_CONTAINER_DATA_PATH=/var/lib/sharelatex
fi
…
}
2、在路径前加上/，如下所示
function set_base_vars() {
…
OVERLEAF_IN_CONTAINER_DATA_PATH=//var/lib/overleaf
if [[ "$IMAGE_VERSION_MAJOR" -lt 5 ]]; then
OVERLEAF_IN_CONTAINER_DATA_PATH=//var/lib/sharelatex
fi
…
}
3、保存退出
第五步：正式启动 Overleaf
回到 Git Bash 终端，再次执行：
bin/up
第六步：注册管理员账号
在浏览器中打开 http://localhost/launchpad。应该会看到一个包含电子邮件和密码字段的表单。填写想用作管理员账户的凭证，然后点击“注册”。然后点击链接进入登录页面（http://localhost/login）即可注册并登录。
第七步：安装全量 TeX Live 宏包（解决“找不到文件”问题）
当你想要继续直接在云端的项目，会出现：
这个问题可以安装全量 TeX Live 宏包或者单独安装某个包。我比较懒，直接安装全量 TeX Live 宏包。
1、同样先进入容器终端：
MSYS_NO_PATHCONV=1 bin/shell
2、执行全量安装命令（注意：需要下载约 4GB 数据，耗时较长，请确保网络通畅）：
tlmgr install scheme-full
3、输入 exit 退出。
第八步：开始使用
1、浏览器访问：http://localhost
2、使用刚才注册的账号登录。
