> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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`: ```bash title="config/overleaf.rc" theme={null} 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://:` | | 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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/tls-proxy.md) của Toolkit | `127.0.0.1` | `80` | `https://` | 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`. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/tls-proxy.md). 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. | `no-reply@lilliput.com` | | `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. | `it-services@lilliput.com` | `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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/authentication/public-access.md). 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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/environment-variables.md). 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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention"). Mở `config/variables.env` và cập nhật các biến môi trường sau: ```dotenv title="config/variables.env" wrap theme={null} 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: ```text title="Start the instance" theme={null} 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: ```text title="Start without attaching to logs" theme={null} bin/start ``` > [!NOTE] > > 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/](http://127.0.0.1/) hoặc [http://localhost/](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://: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: ```text title="Show the published port" theme={null} 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ủ. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention") This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.