跳转到主要内容

Overleaf i18n 配置

本文档介绍如何为自托管的 Overleaf 实例配置国际化(i18n)。
Overleaf 已被翻译成多种语言。通过适当的配置,你可以:
  • 让 Overleaf 实例以单一固定语言运行,或者
  • 启用多语言,允许用户动态切换语言,类似于 www.overleaf.com。

单语言配置

站点语言通过环境变量 OVERLEAF_SITE_LANGUAGE 进行配置。 支持的语言代码包括:
  • en - 英语(默认)
  • es - 西班牙语
  • pt - 葡萄牙语
  • de - 德语
  • fr - 法语
  • cs - 捷克语
  • nl - 荷兰语
  • sv - 瑞典语
  • it - 意大利语
  • tr - 土耳其语
  • zh-CN - 中文(简体)
  • no - 挪威语
  • da - 丹麦语
  • ru - 俄语
  • ko - 韩语
  • ja - 日语
  • pl - 波兰语
  • fi - 芬兰语
英语是默认语言。要更改界面语言(例如改为简体中文),请在 config/variables.env 中添加以下行:
config/variables.env
然后应用配置:
服务重启后,Web 界面菜单中的语言应会反映新的设置。

多语言配置

要让用户能够在不退出登录的情况下切换语言,你的 Overleaf 实例必须配置为根据域名提供不同的语言。 本节假设:
  • 你的主域名是 overleaftest.com
  • 你拥有一个通配符 TLS 证书(例如 *.overleaftest.com)
  • 你没有使用 localhost(因为它无法支持基于子域名的语言路由)
在本地测试时,你可以使用 dev-overleaf.com 之类的域名。
1

TLS 代理配置(Nginx)

你的 TLS 反向代理必须转发原始的 Host 请求头,以便 Overleaf 判断用户访问的是哪个语言域名。请确保存在以下指令:
以下是一个 Nginx 配置示例:
2

配置 Cookie 域

为防止用户在切换语言时被登出,Cookie 必须在各个语言子域名之间共享。在 config/variables.env 中添加以下行:
config/variables.env
这可确保认证 Cookie 对 overleaftest.com 下的所有子域名都有效。
3

语言与域名映射

接下来,使用
OVERLEAF_LANG_DOMAIN_MAPPING 定义语言代码与子域名之间的映射关系。

配置示例

config/variables.env
使用此配置后:
  • https://www.overleaftest.com → 英文界面
  • https://cn.overleaftest.com → 简体中文界面
你可以根据需要为此映射添加更多语言和子域名。
我们建议在 www 上提供主站点,并始终包含 www 键:将 OVERLEAF_SITE_URL 设置为 www 地址(例如 https://www.overleaftest.com),让 www 键指向该地址,并按下文所示将顶级域名重定向到该地址。www 键代表主站点,可以使用任何语言。如果没有该键,默认的 www 条目会保留,语言选择器中会多出一个链接到 http://127.0.0.1:3000 的英文选项。
4

重定向顶级域名

最后,将顶级域名(overleaftest.com)重定向到默认语言域名(www.overleaftest.com)。

Q&A

回答:语言按钮(翻译图标)位于页面底部,例如项目列表的底部。编辑器中不显示该按钮。只有当 OVERLEAF_LANG_DOMAIN_MAPPING 映射了两种或更多语言时,该按钮才会出现,详见多语言配置。如果只设置了 OVERLEAF_SITE_LANGUAGE,整个站点将使用这一种语言,也不会显示该按钮。选择某种语言会在该语言的域名上打开同一页面,例如 cn.overleaftest.com。该选择不会保存为用户设置。
回答:OVERLEAF_LANG_DOMAIN_MAPPING 中没有 www 键。该映射会与默认映射合并,而默认映射中有一个英文的 www 条目,其内部地址为 http://127.0.0.1:3000。如果你的映射只使用了其他键(例如 cn 和 en),该默认条目会被保留并出现在选择器中。请添加一个指向 OVERLEAF_SITE_URL 地址的 www 键,删除同一语言的第二个条目,然后运行 bin/up -d:
最后修改于 2026年11月2日