Mac ARM本地部署Overleaf：解决MongoDB版本与架构兼容性全攻略（支持M1/M2/M3芯片，手把手教你搭建私有LaTeX协作平台）

二、 解决核心问题：关键步骤与配置修改

1. 解决 Invalid MONGO_VERSION 问题

在执行 bin/init 初始化 Toolkit 时，可能会提示无效的 MongoDB 版本。这是因为默认脚本可能未正确识别 ARM 平台的版本号。

解决方法： 编辑 config/overleaf.rc 文件，手动指定 MONGO_VERSION=4.4 或 5.0。对于 Mac ARM，建议使用 5.0 版本以获得更好的兼容性。

2. 攻克 Docker 拉取 MongoDB 镜像超时

由于国内网络环境，直接拉取 MongoDB 镜像经常超时。这也是Docker安装LaTeX过程中最常见的障碍。

解决方法： 在 Docker Desktop 设置中，找到 "Docker Engine"，添加国内加速器镜像源，或者使用终端代理命令执行 docker pull mongo:5.0。

3. 处理 CPU 架构与平台不匹配问题

Mac ARM 运行 Linux 容器时，有时会默认拉取 amd64 镜像导致报错。我们需要明确指定 linux/arm64 平台。

解决方法： 在 docker-compose.yml 中，为 mongo 和 redis 容器添加 platform: linux/arm64 标签，或者在 toolkit 的变量中设置平台优先。针对MongoDB架构问题，这一步至关重要。

三、 端口绑定与服务启动

Overleaf Toolkit 默认占用 80 端口。如果你的 Mac 上已运行 Web 服务，会导致启动失败。

• 修改 config/overleaf.rc 中的 OVERLEAF_PORT=8080。
• 运行 bin/up 启动容器。
• 访问 localhost:8080/launchpad 创建管理员账户。

四、 总结与关键词

通过手动指定 MongoDB版本报错 对应的修复参数，并利用 Docker 平台标签适配 ARM 架构，我们可以完美地在本地运行 Overleaf。这样不仅解决了网络延迟，还保障了学术数据的安全。