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\shell2、执行全量安装命令(注意:需要下载约 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-full3、输入 exit 退出。
第八步:开始使用
1、浏览器访问:http://localhost/project
2、使用刚才注册的账号登录。
原文出处链接:https://blog.csdn.net/2301_76769610/article/details/157733407、https://cloud.tencent.com/developer/article/2127691
