LibreTranslate

Truy cập

• Mở http://<SERVER_IP> trong trình duyệt.
• Tài liệu API có tại /docs.
• Dùng API key đã được tạo cho các yêu cầu API. Key được lưu tại /root/libretranslate/.credentials.

Sử dụng API

Ví dụ yêu cầu dịch:

curl -X POST http://<SERVER_IP>/translate \
  -d q='Hello' \
  -d source=en \
  -d target=es \
  -d api_key='<API_KEY>'

Thay thế <API_KEY> bằng API key đã được tạo.

Cấu hình

Các biến môi trường chính được lưu tại /root/libretranslate/.env.

• LT_VERSION: phiên bản image LibreTranslate
• REQ_LIMIT: số yêu cầu tối đa mỗi phút cho mỗi client
• CHAR_LIMIT: số ký tự tối đa cho phép trong mỗi yêu cầu

Chỉnh sửa cấu hình theo nhu cầu.

Sau khi thay đổi cấu hình, áp dụng bằng lệnh:

cd /root/libretranslate
docker compose up -d

File và thư mục quan trọng

• Đường dẫn cài đặt: /root/libretranslate
• Tệp Compose: /root/libretranslate/docker-compose.yml
• Môi trường: /root/libretranslate/.env
• Thông tin đăng nhập: /root/libretranslate/.credentials
• Mô hình: /var/lib/docker/volumes/libretranslate_models
• CSDL key: /var/lib/docker/volumes/libretranslate_db
• Cấu hình Caddy: /etc/caddy/Caddyfile

Tên miền và HTTPS (Caddy)

0. Không thể cấp chứng chỉ HTTPS cho địa chỉ IP.

1. Trỏ một tên miền (ví dụ: example.com) đến địa chỉ IP của máy chủ.

2. Cập nhật /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Tải lại Caddy:

systemctl reload caddy

4. Truy cập LibreTranslate tại example.com.

Ghi chú

• Chỉnh sửa cấu hình theo ý bạn trong /root/libretranslate/.env.
• Chế độ Under Attack được bật mặc định để bảo vệ API công khai khỏi các yêu cầu lạm dụng hoặc tự động.
• Giới hạn yêu cầu được bật với mức mặc định là 60 yêu cầu mỗi phút cho mỗi client.
• Mỗi yêu cầu mặc định được giới hạn ở 5000 ký tự.
• Container LibreTranslate chỉ lắng nghe trên 127.0.0.1:5000; Caddy cung cấp truy cập công khai.