KnowledgeTree

外观

Windows本地部署Overleaf

约 868 字大约 3 分钟

2026-03-14

第一步：环境准备

在开始之前，请确保你的电脑已安装以下软件：

修改默认安装到C盘

  • 删除如下目录C:\Program Files\Docker
  • 在D盘新建目录：D:\Program Files\Docker
  • win+r，运行cmd
  • 在cmd中执行如下命令：mklink /j "C:\Program Files\Docker" "D:\Program Files\Docker"
  • 执行下载的安装程序，即可将Docker Desktop安装到D盘了

修改镜像默认下载到C盘

  • 新建目录 D:\ProgramData\Docker
  • 将 %LOCALAPPDATA%\Docker 下的所有文件copy到 D:\ProgramData\Docker
  • 删除目录 %LOCALAPPDATA%\Docker
  • 在%LOCALAPPDATA%下执行cmd /c mklink /J Docker D:\ProgramData\Docker
  • 上述命令是在powershell下执行，若是在cmd下执行则如下mklink /J Docker D:\ProgramData\Docker

Docker Desktop重装

删除注册表，再重新安装：

HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Docker Desktop

第二步：克隆 Overleaf Toolkit

Overleaf 官方提供了一套工具包来简化部署。打开 Git Bash，进入你想存放项目的目录，执行：

git clone https://github.com/overleaf/toolkit.git overleaf
cd overleaf

第三步：初始化配置文件

进入目录后，执行初始化脚本以生成环境配置文件：

bash 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 终端，再次执行：

bash bin/up

第六步：注册管理员账号

在浏览器中打开 http://localhost/launchpad。应该会看到一个包含电子邮件和密码字段的表单。填写想用作管理员账户的凭证，然后点击“注册”。然后点击链接进入登录页面（http://localhost/login）即可注册并登录。

第七步：安装全量 TeX Live 宏包（解决“找不到文件”问题）

这个问题可以安装全量 TeX Live 宏包或者单独安装某个包，直接安装全量 TeX Live 宏包。

1、同样先进入容器终端：

$env:MSYS_NO_PATHCONV = "1"
bash .\bin\shell

2、执行全量安装命令（注意：需要下载约 4GB 数据，耗时较长，请确保网络通畅）：

# 进入容器
docker exec -it overleaf-toolkit_sharelatex_1 bash

# 删除损坏的脚本
rm /overleaf/update-tlmgr-latest.sh

# 从官方源重新下载
curl -o /overleaf/update-tlmgr-latest.sh https://raw.githubusercontent.com/overleaf/toolkit/master/update-tlmgr-latest.sh

# 赋予执行权限
chmod +x /overleaf/update-tlmgr-latest.sh

# 再次执行更新
./update-tlmgr-latest.sh --update

tlmgr install scheme-full

3、输入 exit 退出。

第八步：开始使用

1、浏览器访问：http://localhost/project

2、使用刚才注册的账号登录。

原文出处链接：https://blog.csdn.net/2301_76769610/article/details/157733407、https://cloud.tencent.com/developer/article/2127691