本地化

Overleaf i18 配置

本文档描述了如何为自托管的国际化 (i18n) 配置 Overleaf 实例。

Overleaf 已被翻译成多种语言。通过适当的配置，您可以：

• 以以下方式运行您的 Overleaf 实例 单一固定语言，或

• 启用 多语言，允许用户动态切换语言，类似于 www.overleaf.com.

---

单语言配置

站点语言通过环境变量进行配置 OVERLEAF_SITE_LANGUAGE（或 SHARELATEX_SITE_LANGUAGE ，适用于 Overleaf 版本 4.x 及更早版本).

支持的语言代码包括：

• 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

OVERLEAF_SITE_LANGUAGE=zh-CN

然后应用配置：

bin/up

服务重启后，Web 界面菜单中的界面语言应反映新的设置。

多语言配置

要允许用户 无需注销即可切换语言，您的 Overleaf 实例必须配置为根据域名提供不同的语言。

本节假设：

• 您的主域名为 overleaftest.com

• 您拥有一个 通配符 TLS 证书 （例如 *.overleaftest.com)

• 您 未使用 localhost （因为它无法支持基于子域的语言路由）

对于本地测试，您可以使用诸如 dev-overleaf.com.

1

的域名。

TLS 代理配置（Nginx） 您的 TLS 反向代理必须转发原始 Host

头，以便 Overleaf 能确定用户访问的是哪个语言域。

确保存在以下指令：

proxy_set_header Host $host;

下面是一个示例 Nginx 配置：
    server {
    listen 443 ssl;
    server_name    _; # 捕获所有，参见 http://nginx.org/en/docs/http/server_names.html
    server_name *.overleaftest.com;
    ssl_certificate /etc/nginx/ssl/nginx.crt;
    ssl_certificate_key /etc/nginx/ssl/nginx.key;
    ssl_protocols               TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers   on;
    # 使用了 Cloudflare 的密码套件 https://github.com/cloudflare/sslconfig/blob/master/conf

    ssl_ciphers EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    # 启用 HSTS（HTTP 严格传输安全）的配置 https://developer.mozilla.org/en-US/docs/Security/HTTP_Strict_Transport_Security	
    # 为了避免 SSL 剥离 https://en.wikipedia.org/wiki/SSL_stripping#SSL_stripping
    add_header Strict-Transport-Security "max-age=31536000; includeSubdomains;";
    server_tokens off;
    add_header X-Frame-Options SAMEORIGIN;
    add_header X-Content-Type-Options nosniff;

    client_max_body_size 50M;
        location / {
        proxy_pass http://localhost:5000; # 根据 docker 容器监听的主机/端口进行更改。
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 3m;
        
        proxy_send_timeout 3m;
        确保存在以下指令：
    }
}

2

# 将此添加到您的 nginx 配置中

配置 Cookie 域

为了防止用户在切换语言时被注销，cookie 必须在语言子域之间共享。 config/variables.env:

config/variables.env

将以下行添加到
# 注意前导点

COOKIE_DOMAIN=.overleaftest.com overleaftest.com.

3

这可确保存取认证 cookie 在

语言–域名 映射 接下来，使用以下项定义语言代码到子域的映射.

OVERLEAF_LANG_DOMAIN_MAPPING

config/variables.env

示例配置

OVERLEAF_LANG_DOMAIN_MAPPING='{"www": {"lngCode": "en","url": "https:\/\/www.overleaftest.com"},"cn": {"lngCode": "zh-CN","url": "https:\/\/cn.overleaftest.com"}}'

• 使用此配置： https://www.overleaftest.com

• → 英文界面 https://cn.overleaftest.com

→ 简体中文界面

4

您可以根据需要用其他语言和子域扩展此映射。

重定向根域overleaftest.com最后，将根域（）重定向到默认语言域（).

www.overleaftest.com
    server{
    listen 80;
    server_name overleaftest.com;
}

下面是一个示例 Nginx 配置：
    return 301 https://www.overleaftest.com$request_uri;
    listen 80;
    listen 443 ssl http2;ssl_certificate     /p
    ath/to/fullchain.cer;
    server_name overleaftest.com;
}