跳转到主要内容
本页介绍 Toolkit 部署中 config/variables.env 文件所支持的环境变量。 config/variables.env 文件由 NAME=value 形式的变量定义组成;以 # 开头的行被视为注释。
在修改 config/overleaf.rc 或 config/variables.env 中的任何内容后,必须运行 bin/up 重新创建 Docker 容器。

所有版本

这些环境变量兼容 Overleaf Community Edition、Overleaf Server Pro 和 Ayakaleaf Pro,为它们之间的迁移提供了便捷途径。它们也可同时用于 Toolkit 和 Docker Compose 部署。
使用 Overleaf 登录系统(本地账户)而非 LDAP 等 SSO 方式时,可以对用户强制执行密码限制。对于 SSO 账户,密码策略将由你的身份提供商或目录服务执行,并且还可以支持多因素身份验证。

问答

回答:未设置 OVERLEAF_SESSION_SECRET。没有它时,Overleaf 会使用容器创建时生成的随机密钥来签名会话 Cookie。每当 config/variables.env 或 config/overleaf.rc 发生变化时,bin/up 都会重新创建容器,每次升级也是如此,因此密钥会改变,所有现有的登录 Cookie 都将不再匹配。会话本身仍保存在 Redis 中;只是签名不再有效。停止并启动同一个容器(bin/stop 和 bin/start)会保留该密钥。要解决此问题,请在 config/variables.env 中设置一次固定的密钥,然后运行 bin/up -d:
添加该设置时,用户会最后一次被退出登录。此后,会话在 bin/up 和升级后都会保留。请将该值与备份一起保存;如果运行多个实例,请在每个实例上使用相同的值。
回答:不可以,没有用于此目的的环境变量。登录表单每分钟接受来自同一 IP 地址的 20 个请求,每个邮箱地址在 2 分钟内可尝试 10 次;成功登录会清除该邮箱地址的计数。如果位于反向代理之后,请设置 OVERLEAF_TRUSTED_PROXY_IPS,使 Overleaf 能看到每个用户自己的 IP 地址,否则所有用户将共享代理的地址及其限制。
最后修改于 2026年11月2日