OVERLEAF_SITE_URL | 你的 Overleaf 实例对外公开访问的地址。它用于公开链接以及 websocket 连接,因此必须正确配置! |
OVERLEAF_ADMIN_EMAIL | 用户可以联系站点运营者的电子邮件地址。 |
OVERLEAF_APP_NAME | 提及正在运行的应用时显示的名称。默认为 ‘Overleaf (Community Edition)‘。 |
OVERLEAF_MONGO_URL 和 MONGO_URL | 要使用的 Mongo 数据库的 URL。 |
OVERLEAF_REDIS_HOST 和 REDIS_HOST | 要使用的 Redis 实例的主机名。两者都是必需的(参见发布说明)。 |
OVERLEAF_REDIS_PORT 和 REDIS_PORT | 要使用的 Redis 实例的端口。两者都是必需的(参见发布说明)。 |
OVERLEAF_REDIS_PASS 和 REDIS_PASSWORD | 连接 Redis 时使用的密码(如适用)。两个环境变量都需要设置。更多信息请参阅启用密码认证。 |
OVERLEAF_REDIS_TLS | 如果设置为 true,则允许连接到需要 TLS 的 Redis 实例。
注意:目前不支持 mTLS。 |
OVERLEAF_NAV_TITLE | 设置应用的标签页标题。 |
OVERLEAF_HEADER_IMAGE_URL_LIGHT 和 OVERLEAF_HEADER_IMAGE_URL_DARK | 浅色和深色主题下自定义页眉 Logo 的 URL(6.3.0 中新增)。当某个主题对应的变量未设置时,会回退到 OVERLEAF_HEADER_IMAGE_URL。参见品牌定制。 |
OVERLEAF_LINKED_URL_OUTBOUND_PROXY | HTTP(S) 代理的 URL,用于获取外部链接文件,以及通过 Open in Overleaf API 获取外部 ZIP 或 TeX 资源。自重新发布的 Ayakaleaf Pro 6.3.0(2026 年 10 月 3 日)起可用。不设置则直接连接。示例:OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128。有关配置和网络访问限制,请参阅出站代理。 |
OVERLEAF_INVITE_TOKEN_SECRET | 必需。用于保护项目共享令牌的随机字符串(6.2.0 中新增)。 最少字符数:16 |
OVERLEAF_SESSION_SECRET | 推荐。用于签名会话 Cookie 的随机字符串;如果使用负载均衡,需要在所有机器上设置为相同的值。 如果未设置,每次创建容器时都会生成一个新的随机值,因此每次重新创建容器的 bin/up(例如修改 config/variables.env 之后)或升级都会使所有用户退出登录。请使用 openssl rand -hex 32 生成一次并妥善保存。 |
OVERLEAF_COOKIE_SESSION_LENGTH | 允许你覆盖默认 5 天的会话 Cookie 过期时间。覆盖值以毫秒为单位。示例:要使会话持续 1 小时,请设置 COOKIE_SESSION_LENGTH=3600000。 |
OVERLEAF_TRUSTED_PROXY_IPS | 如果未设置,默认为 loopback。如果手动设置,除了你信任的 IP 之外,还必须包含 loopback(或 127.0.0.1),以信任在 sharelatex 容器内运行的 nginx 实例。仅接受 IP 地址和 CIDR 范围:不要添加 localhost 等主机名,否则 Overleaf 将无法启动并返回 502 Bad Gateway。
如果你的常规网络使用了 172.16.0.0/12(Docker 网络的默认子网)中的子网,请在 config/variables.env 中设置 OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network>。其中 <network> 是 docker inspect overleaf_default 中 IPAM -> Config -> Subnet 的值,例如 OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16。这样可以防止 X-Forwarded 请求头被伪造。
如果你使用外部 TLS 代理(即不由 Overleaf Toolkit 管理),请确保设置 OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>,例如 OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37。 |
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS | 如果设置为 true,则仅允许向与现有用户账户对应的电子邮件地址发送项目邀请。 |
OVERLEAF_ALLOW_PUBLIC_ACCESS | 如果设置为 true,则允许未经身份验证的用户查看站点。默认值为 false,即未经身份验证的用户在尝试查看站点的任何部分时都会被无条件重定向到登录页面。注意,设置此选项不会以任何方式禁用身份验证或安全机制。如果你的用户打算公开其项目并让未经身份验证的用户查看这些项目,则需要启用此选项。 |
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING | 如果设置为 true,则允许匿名用户查看和编辑通过链接共享功能共享的项目。 |
OVERLEAF_DISABLE_LINK_SHARING | 禁用链接共享功能。 |
EMAIL_CONFIRMATION_DISABLED | 设置为 true 时,将不显示请求确认电子邮件的横幅。 |
ADDITIONAL_TEXT_EXTENSIONS | 用于配置可编辑文件额外扩展名的字符串数组。 |
DEFAULT_LATEX_COMPILER | 用于设置新项目默认使用的编译器。(6.2.0 中新增)。 可选值:pdflatex、latex、xelatex 或 lualatex |
OVERLEAF_STATUS_PAGE_URL | 自定义状态页 URL,例如 status.example.com。 |
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS | 设置为 'false' 可阻止新项目使用完整项目历史(Full Project History)进行初始化。 |
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS | 设置为 'false' 可阻止新项目显示完整项目历史,而改为显示旧版历史。 |
ENABLE_CRON_RESOURCE_DELETION | 将此环境变量设置为 true,可在 90 天后自动清理已删除的项目和用户。 |
OVERLEAF_USER_HARD_DELETION_DELAY | 用于修改已删除用户的过期延迟。以毫秒为单位配置。
默认值:90 天 |
OVERLEAF_PROJECT_HARD_DELETION_DELAY | 用于修改已删除项目的过期延迟。以毫秒为单位配置。
默认值:90 天 |
MAX_UPLOAD_SIZE | 控制单次上传的最大大小,单位为 MB。默认为 50。
注意:此变量只是一个纯数字,不带单位(MB)或任何包装。
上传的 .zip 文件解压后的总大小限制为该值的 6 倍(默认为 300 MB)。 |
COMPILE_SIZE_LIMIT | 控制请求体的最大大小,单位为字节。这是项目中所有文档文件大小的总和(main.tex、references.bib(如果未链接)等),这些文件需要在初始编译请求中发送到 CLSI 服务。 |
COMPILE_TIMEOUT | 允许编译完成的时间,单位为秒。更多信息请参阅更新项目编译超时。 |
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS | 编辑器平滑重连、数据刷新与容器关闭之间的可配置延迟,用于降低数据丢失的风险。 |
SECCOMP_PROFILE | 将此环境变量设置为 Docker 主机上指向 SECCOMP 配置文件的路径。你可以在这里下载该配置文件的副本。
目前在 Podman 部署中使用沙盒编译时需要此设置。 |
OVERLEAF_DISABLE_CHAT | 如果设置为 true,则禁用项目内聊天功能。 |
OVERLEAF_DISABLE_LOCAL_LOGIN | 如果设置为 true,则隐藏邮箱和密码登录,用户只能通过 LDAP、SAML 或 OIDC 登录。仅当 EXTERNAL_AUTH 至少启用了其中一种方式时才生效(Ayakaleaf Pro 6.3.1 中新增)。 |
OVERLEAF_LOGIN_SUPPORT_TEXT | 设置后,可在登录按钮下方显示支持信息。文本会显示在登录界面上,可用于引导用户前往内部支持渠道,或提供与登录、创建账户等相关的指导。 |
ALLOW_MONGO_ADMIN_CHECK_FAILURES | 如果设置为 true,则允许 MongoDB 启动检查失败而不阻止部署启动。如果你使用的 MongoDB 数据库中,数据库用户不具备 clusterParameterReader 角色,则可能需要此设置。
有关创建自定义角色的帮助,请参阅这里。 |
V1_HISTORY_URL_FOR_GIT_BRIDGE | 允许将 history-v1 端点区分为内部流量(web 服务 → history-v1 服务,两者均在 sharelatex 容器中)和外部流量(git-bridge → history-v1,运行在独立容器中)。 |
OVERLEAF_MAINTENANCE_MESSAGE 和 OVERLEAF_MAINTENANCE_MESSAGE_HTML | 用于自定义维护页面的标题和内容。不能与 OVERLEAF_STATUS_PAGE_URL 同时使用。 |