5. Cá nhân hóa phiên bản của bạn

​

Cá nhân hóa phiên bản của bạn

Trước khi khởi động phiên bản Overleaf của bạn lần đầu tiên, hãy cập nhật hai tệp cấu hình với thông tin tùy chỉnh của bạn:

Tệp	Được đọc bởi	Thiết lập tại đây
config/overleaf.rc	các script của Toolkit, chẳng hạn bin/up	cách các container chạy: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, đường dẫn dữ liệu
config/variables.env	ứng dụng bên trong container	cách Overleaf hoạt động: OVERLEAF_SITE_URL, email, TeX Live image

1. Chỉnh sửa tệp biến

   Mở config/variables.env bằng trình soạn thảo văn bản yêu thích và cập nhật các biến môi trường dưới đây với các giá trị cần thiết.

2. Địa chỉ và cổng lắng nghe

   Theo mặc định, Toolkit công bố giao diện web trên 127.0.0.1:80, vì vậy chỉ có thể mở nó từ trình duyệt trên chính máy chủ. Các máy tính khác sẽ gặp lỗi “connection refused” hoặc “server not found”. Để thay đổi điều này, hãy chỉnh sửa config/overleaf.rc:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP là địa chỉ IP của máy chủ host mà container bind vào, và OVERLEAF_PORT là cổng của máy chủ host. Kết hợp lại, chúng tạo thành ánh xạ cổng Docker OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80. Hãy chọn các giá trị phù hợp với thiết lập của bạn:

   Thiết lập	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Mở trong trình duyệt
   Chỉ trên máy này (mặc định)	127.0.0.1	80	http://localhost
   Các máy tính khác trong mạng LAN hoặc internet kết nối trực tiếp	0.0.0.0, hoặc một IP của máy chủ	80, hoặc bất kỳ cổng trống nào	http://<server-ip>:<port>
   Phía sau reverse proxy của riêng bạn (NGINX, Caddy, Cloudflare Tunnel) trên cùng máy chủ host	127.0.0.1	bất kỳ cổng trống nào	URL của proxy
   Phía sau TLS proxy của Toolkit	127.0.0.1	80	https://<your-domain>

   Nếu cổng 80 đã được sử dụng trên máy chủ host, ví dụ bởi một web server khác, hãy đặt OVERLEAF_PORT thành một cổng trống như 8080. Nếu không, bin/up sẽ thất bại với lỗi bind: address already in use.

   Các cổng được Docker công bố sẽ bỏ qua tường lửa của máy chủ host như ufw và firewalld. Với 0.0.0.0, phiên bản có thể được truy cập từ mọi mạng mà máy chủ kết nối tới. Trên máy chủ đám mây, bạn cũng cần cho phép cổng trong security group của nhà cung cấp. Hãy dùng HTTPS trước khi công khai phiên bản ra internet, xem TLS proxy.

   Bạn có thể bắt đầu với giá trị mặc định và mở phiên bản trên localhost trước. Để cho phép truy cập từ các máy tính khác sau này, hãy thay đổi hai biến này trong config/overleaf.rc và OVERLEAF_SITE_URL trong config/variables.env, rồi chạy lại bin/up để tạo lại các container.

3. Các biến môi trường bắt buộc

   Cập nhật các biến sau trong config/variables.env:

   Tên	Mô tả	Ví dụ
   OVERLEAF_SITE_URL	Địa chỉ công khai của phiên bản Overleaf của bạn. Giá trị này được dùng trong các liên kết công khai và khi kết nối qua websocket, vì vậy phải được cấu hình chính xác!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Địa chỉ email này sẽ được dùng làm địa chỉ from cho tất cả email gửi đi.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Địa chỉ email mà người dùng có thể liên hệ với người vận hành trang.	[e-mail]

   OVERLEAF_SITE_URL là địa chỉ người dùng nhập vào trình duyệt, không phải địa chỉ lắng nghe. Hãy bao gồm cổng khi cổng không phải là 80 (HTTP) hoặc 443 (HTTPS), ví dụ http://192.168.1.20:8080. Không dùng http://0.0.0.0. Nếu OVERLEAF_SITE_URL không khớp với địa chỉ trong trình duyệt, trình soạn thảo sẽ không kết nối được, và các liên kết trong email cũng như các OAuth callback sẽ trỏ tới sai địa chỉ.

   Nếu không có máy chủ thư, hãy để trống OVERLEAF_EMAIL_FROM_ADDRESS: khi đó Overleaf sẽ không gửi email nào, và bạn có thể tự cung cấp liên kết kích hoạt cho người dùng mới, xem phần Hỏi & Đáp trong Truy cập công khai.

   Ngoài ra, hãy đặt OVERLEAF_SESSION_SECRET thành một giá trị được tạo bằng openssl rand -hex 32. Khi không có biến này, mỗi lần bin/up tạo lại container, và mỗi lần nâng cấp, sẽ đăng xuất tất cả người dùng. Xem phần Hỏi & Đáp trong Biến môi trường.

   Sau khi cập nhật các biến môi trường này, hãy lưu và thoát.

4. Thiết lập Sandbox Compile

   Tiếp theo, cấu hình TeX Live Full cho sandboxed-compiles.md. Mở config/variables.env và cập nhật các biến môi trường sau:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
5. Khởi động phiên bản của bạn

   Để khởi động phiên bản, hãy chạy:

   Start the instance

   bin/up
   

   Lệnh này sẽ tải xuống các image cần thiết bao gồm texlive, tạo các container (sử dụng các tùy chỉnh của bạn) và khởi động phiên bản. Bạn sẽ thấy đầu ra log từ các Docker container khác nhau.

   Để khởi động lại chúng sau này (không gắn vào đầu ra log), hãy chạy:

   Start without attaching to logs

   bin/start
   

Toolkit sử dụng docker compose để quản lý các Docker container của Overleaf. Toolkit cung cấp một bộ script bao bọc docker compose và xử lý hầu hết các chi tiết thay cho bạn.

Nếu mọi thứ suôn sẻ, bạn sẽ có thể xem trang đăng nhập của phiên bản Overleaf mới bằng cách truy cập http://127.0.0.1/ hoặc http://localhost/ trong trình duyệt. Nếu bạn đã thay đổi OVERLEAF_LISTEN_IP hoặc OVERLEAF_PORT, hãy mở địa chỉ từ bảng trong bước Địa chỉ và cổng lắng nghe, ví dụ http://<server-ip>:8080.

Để kiểm tra giao diện web được công bố trên địa chỉ và cổng nào, hãy chạy:

Show the published port

bin/docker-compose port sharelatex 80

Kết quả, ví dụ 0.0.0.0:8080, cho biết địa chỉ IP và cổng của máy chủ host đang được sử dụng. Nếu kết quả hiển thị 127.0.0.1, phiên bản chỉ có thể được truy cập từ chính máy chủ.

Tùy thuộc vào cấu hình mạng và nơi lưu trữ phiên bản Overleaf của bạn, bạn có thể cần thực hiện thêm các thay đổi cấu hình. Xem thiết lập Toolkit để biết thêm chi tiết: toolkit-settings.md