5. 个性化你的实例

​

个性化你的实例

在首次启动 Overleaf 实例之前，请使用你的自定义信息更新 config/variables.env 配置文件。

1. 编辑变量文件

   用你喜欢的文本编辑器打开 config/variables.env，并将下列环境变量更新为所需的值。

2. 必需的环境变量

   更新 config/variables.env 中的以下变量：

   名称	描述	示例
   OVERLEAF_SITE_URL	你的 Overleaf 实例对外公开访问的地址。它用于公开链接以及 WebSocket 连接，因此必须正确配置！	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	该邮箱地址将用作所有外发邮件的 from 地址。	[e-mail]
   OVERLEAF_ADMIN_EMAIL	用户联系站点运维人员时使用的邮箱地址。	[e-mail]

   更新这些环境变量后，保存并退出。

3. 配置沙盒编译

   接下来，为 sandboxed-compiles.md 配置 TeX Live Full。打开 config/variables.env 并更新以下环境变量：

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. 启动你的实例

   要启动实例，请运行：

   Start the instance

   bin/up
   

   该命令会下载包括 texlive 在内的所需镜像，（根据你的自定义配置）创建容器并启动实例。你应该会看到来自各个 Docker 容器的日志输出。

   之后如需再次启动它们（不附加到日志输出），请运行：

   Start without attaching to logs

   bin/start
   

Toolkit 使用 docker compose 来管理 Overleaf 的 Docker 容器。Toolkit 提供了一组封装 docker compose 的脚本，可以为你处理大部分细节。

如果一切顺利，你应该能够在浏览器中访问 http://127.0.0.1/ 或 http://localhost/，看到新 Overleaf 实例的登录页面。

根据你的网络配置以及 Overleaf 实例的托管位置，你可能需要进行额外的配置更改。更多详情请参阅 Toolkit 设置：toolkit-settings.md