Chuyển đến nội dung chính

Cấu hình i18n cho Overleaf

Tài liệu này mô tả cách cấu hình quốc tế hóa (i18n) cho một phiên bản Overleaf tự triển khai.
Overleaf đã được dịch sang nhiều ngôn ngữ. Với cấu hình phù hợp, bạn có thể:
  • Chạy phiên bản Overleaf của mình với một ngôn ngữ cố định duy nhất, hoặc
  • Bật nhiều ngôn ngữ, cho phép người dùng chuyển đổi ngôn ngữ một cách linh hoạt, tương tự như www.overleaf.com.

Cấu hình một ngôn ngữ

Ngôn ngữ của trang được cấu hình bằng biến môi trường OVERLEAF_SITE_LANGUAGE. Các mã ngôn ngữ được hỗ trợ bao gồm:
  • en - Tiếng Anh (mặc định)
  • es - Tiếng Tây Ban Nha
  • pt - Tiếng Bồ Đào Nha
  • de - Tiếng Đức
  • fr - Tiếng Pháp
  • cs - Tiếng Séc
  • nl - Tiếng Hà Lan
  • sv - Tiếng Thụy Điển
  • it - Tiếng Ý
  • tr - Tiếng Thổ Nhĩ Kỳ
  • zh-CN - Tiếng Trung (giản thể)
  • no - Tiếng Na Uy
  • da - Tiếng Đan Mạch
  • ru - Tiếng Nga
  • ko - Tiếng Hàn
  • ja - Tiếng Nhật
  • pl - Tiếng Ba Lan
  • fi - Tiếng Phần Lan
Tiếng Anh là ngôn ngữ mặc định. Để thay đổi ngôn ngữ giao diện (ví dụ: sang tiếng Trung giản thể), hãy thêm dòng sau vào config/variables.env:
config/variables.env
Sau đó áp dụng cấu hình:
Sau khi các dịch vụ khởi động lại, ngôn ngữ giao diện trong các menu của web UI sẽ phản ánh thiết lập mới.

Cấu hình nhiều ngôn ngữ

Để cho phép người dùng chuyển đổi ngôn ngữ mà không cần đăng xuất, phiên bản Overleaf của bạn phải được cấu hình để phục vụ các ngôn ngữ khác nhau dựa trên tên miền. Phần này giả định rằng:
  • Tên miền chính của bạn là overleaftest.com
  • Bạn có một chứng chỉ TLS wildcard (ví dụ: *.overleaftest.com)
  • Bạn không sử dụng localhost (vì nó không hỗ trợ định tuyến ngôn ngữ dựa trên tên miền con)
Để kiểm thử cục bộ, bạn có thể dùng một tên miền như dev-overleaf.com.
1

Cấu hình TLS Proxy (Nginx)

TLS reverse proxy của bạn phải chuyển tiếp header Host gốc để Overleaf có thể xác định người dùng đã truy cập tên miền ngôn ngữ nào.Hãy đảm bảo có chỉ thị sau:
Dưới đây là một ví dụ cấu hình Nginx:
2

Cấu hình Cookie Domain

Để tránh việc người dùng bị đăng xuất khi chuyển đổi ngôn ngữ, cookie phải được chia sẻ giữa các tên miền con ngôn ngữ.Thêm dòng sau vào config/variables.env:
config/variables.env
Điều này đảm bảo rằng cookie xác thực có hiệu lực cho tất cả các tên miền con thuộc overleaftest.com.
3

Ánh xạ ngôn ngữ – tên miền

Tiếp theo, xác định cách các mã ngôn ngữ được ánh xạ tới tên miền con bằng
OVERLEAF_LANG_DOMAIN_MAPPING.

Ví dụ cấu hình

config/variables.env
Với cấu hình này:
  • https://www.overleaftest.com → Giao diện tiếng Anh
  • https://cn.overleaftest.com → Giao diện tiếng Trung giản thể
Bạn có thể mở rộng ánh xạ này với các ngôn ngữ và tên miền con bổ sung khi cần.
Chúng tôi khuyến nghị phục vụ trang chính trên www và luôn bao gồm khóa www: đặt OVERLEAF_SITE_URL thành địa chỉ www (ví dụ https://www.overleaftest.com), trỏ khóa www tới địa chỉ đó và chuyển hướng tên miền gốc (apex) về đó như hướng dẫn bên dưới. Khóa www là trang chính và có thể dùng bất kỳ ngôn ngữ nào. Nếu không có khóa này, mục www mặc định sẽ được giữ lại, và bộ chọn ngôn ngữ sẽ hiển thị thêm một mục tiếng Anh liên kết tới http://127.0.0.1:3000.
4

Chuyển hướng tên miền gốc (apex)

Cuối cùng, chuyển hướng tên miền gốc (overleaftest.com) đến tên miền ngôn ngữ mặc định (www.overleaftest.com).

Hỏi & Đáp

Trả lời: Nút ngôn ngữ (biểu tượng dịch) nằm ở chân trang, ví dụ ở cuối danh sách dự án. Nút này không hiển thị trong trình soạn thảo.Nút chỉ xuất hiện khi OVERLEAF_LANG_DOMAIN_MAPPING ánh xạ từ hai ngôn ngữ trở lên, như mô tả trong Cấu hình nhiều ngôn ngữ. Khi chỉ đặt OVERLEAF_SITE_LANGUAGE, toàn bộ trang dùng một ngôn ngữ đó và không có nút nào.Việc chọn một ngôn ngữ sẽ mở cùng trang đó trên tên miền của ngôn ngữ tương ứng, ví dụ cn.overleaftest.com. Lựa chọn này không được lưu thành cài đặt người dùng.
Trả lời: OVERLEAF_LANG_DOMAIN_MAPPING không có khóa www. Ánh xạ này được hợp nhất vào ánh xạ mặc định, vốn có một mục www cho tiếng Anh với địa chỉ nội bộ http://127.0.0.1:3000. Nếu ánh xạ của bạn chỉ dùng các khóa khác, chẳng hạn cn và en, mục mặc định đó sẽ được giữ lại và xuất hiện trong bộ chọn.Hãy thêm khóa www với địa chỉ của OVERLEAF_SITE_URL, bỏ mục thứ hai cho cùng một ngôn ngữ, rồi chạy bin/up -d:
Lần sửa đổi cuối 2 tháng 11, 2026