LibreTranslate: API Dịch Thuật Tự Host 14.4K+ Stars — Hướng Dẫn Triển Khai Production 2026

{{< resource-info >}}

LibreTranslate là một API dịch máy miễn phí, mã nguồn mở mà bạn tự host. Không cần API key của Google. Không tính phí theo ký tự như DeepL. Dữ liệu không rồi khỏi hạ tầng của bạn. Với 14,400+ sao GitHub và chu kỳ phát hành tích cực (phiên bản v1.9.5 tính đến tháng 5/2026), nó đã trở thành lựa chọn mặc định cho các developer cần dịch thuật riêng tư, có khả năng offline với chi phí biên bằng không. Hướng dẫn này là một LibreTranslate tutorial đầy đủ, bao gồm từ libretranslate setup đến libretranslate docker triển khai production, cùng với so sánh chi tiết với DeepL và Google Translate (libretranslate vs deepl) và các best practice về self-hosted translation. Hướng dẫn này đi qua triển khai production, benchmark và tích hợp.

LibreTranslate Là Gì? #

LibreTranslate là một REST API dịch máy tự host, được xây dựng trên nền tảng engine Argos Translate mã nguồn mở. Nó cung cấp giải pháp thay thế sẵn sàng cho các dịch vụ dịch thuật độc quyền, với giao diện HTTP đơn giản, giao diện web tích hợp và hỗ trợ 30+ ngôn ngữ. Dự án được cấp phép AGPL-3.0 và được tổ chức LibreTranslate duy trì tích cực.

Không giống các API dịch thuật dựa trên đám mây, LibreTranslate chạy hoàn toàn trên phần cứng của bạn. Mọi xử lý văn bản diễn ra cục bộ, khiến nó phù hợp cho các ứng dụng nhạy cảm về quyền riêng tư, mạng air-gap và các ngành có yêu cầu tuân thủ nghiêm ngặt. Dự án được khởi động như một phản hồi cho sự thiếu hụt công cụ dịch thuật tôn trọng quyền riêng tư và đã phát triển thành nền tảng sẵn sàng production được sử dụng bởi doanh nghiệp, chính phủ và developer cá nhân.

LibreTranslate Hoạt Động Như Thế Nào? #

Kiến trúc của LibreTranslate đơn giản: backend Python Flask phục vụ REST API, trong khi công việc nặng nhọc về dịch thuật được xử lý bởi các mô hình dịch máy neural (NMT) của Argos Translate. Các mô hình này được tải xuống khi chạy lần đầu và cache cục bộ, cho phép hoạt động offline sau thiết lập ban đầu.

Kiến Trúc Cốt Lõi #

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Client (Web)  │────▶│  Flask REST API  │────▶│ Argos Translate │
│   / API Call    │◀────│    (Port 5000)   │◀────│   (NMT Engine)  │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                                        │
                              ┌─────────────────────────┘
                              ▼
                        ┌──────────────┐
                        │   Mô hình    │
                        │ ngôn ngữ     │
                        │  (~2GB)      │
                        └──────────────┘

Các Thành Phần Chính #

• Flask API Server: Xử lý request HTTP, xác thực, giới hạn tốc độ và xác thực request.
• Argos Translate Engine: Backend NMT tải các mô hình ngôn ngữ và thực hiện inference.
• Language Models: Các mô hình OpenNMT pretrained cho mỗi cặp ngôn ngữ, tải xuống theo yêu cầu.
• SQLite Database: Lưu trữ API key, log request và thống kê sử dụng khi quản lý API key được bật.

Request dịch thuật đi qua hệ thống như sau: client gửi payload JSON với văn bản nguồn, ngôn ngữ nguồn và ngôn ngữ đích. API xác thực request, định tuyến đến mô hình Argos phù hợp và trả về văn bản đã dịch cùng metadata như điểm tin cậy và ngôn ngữ phát hiện được.

Cài Đặt & Thiết Lập #

LibreTranslate cung cấp nhiều đường dẫn triển khai. Đường dẫn Docker được khuyến nghị cho production do khả năng cách ly, tái lập và dễ dàng cập nhật.

Yêu Cầu Hệ Thống #

Docker Khởi Động Nhanh #

Cách nhanh nhất để chạy LibreTranslate cục bộ:

# Chạy bằng Docker
docker run -ti --rm -p 5000:5000 \
  -v lt-models:/home/libretranslate/.local \
  -e LT_LOAD_ONLY=en,es,fr \
  libretranslate/libretranslate:latest

Sau khi khởi động, mở http://localhost:5000 trong trình duyệt. Lần chạy đầu tiên tải các mô hình ngôn ngữ nên sẽ có độ trễ ngắn trước khi UI phản hồi.

Docker Compose Production #

Để triển khai production, sử dụng docker-compose.yml với volume lâu dài, kiểm tra sức khỏe và giới hạn tài nguyên:

# docker-compose.yml - Cấu hình Production
version: '3.8'

services:
  libretranslate:
    container_name: libretranslate
    image: libretranslate/libretranslate:v1.9.5
    restart: unless-stopped
    ports:
      - "5000:5000"
    environment:
      - LT_LOAD_ONLY=en,es,fr,de,it,zh,ja,ru,pt,pl,nl
      - LT_API_KEYS=true
      - LT_REQ_LIMIT=60
      - LT_THREADS=4
      - LT_UPDATE_MODELS=true
    volumes:
      - lt-models:/home/libretranslate/.local
      - lt-db:/app/db
    healthcheck:
      test: ['CMD-SHELL', './venv/bin/python scripts/healthcheck.py']
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
    deploy:
      resources:
        limits:
          memory: 4G
        reservations:
          memory: 2G

volumes:
  lt-models:
  lt-db:

Triển khai:

docker compose up -d

Triển Khai Tăng Tốc GPU (CUDA) #

Cho các kịch bản thông lượng cao, LibreTranslate hỗ trợ tăng tốc GPU NVIDIA qua CUDA. Yêu cầu: GPU NVIDIA với CUDA 11.2+ và nvidia-docker2 đã cài đặt.

# Clone repository
git clone https://github.com/LibreTranslate/LibreTranslate.git
cd LibreTranslate

# Build và chạy phiên bản CUDA
docker compose -f docker-compose.cuda.yml up -d --build

Xác minh GPU đang sử dụng:

nvidia-smi

Cài Đặt Python Native #

Cho môi trường phát triển hoặc môi trường không có Docker:

# Cài đặt qua pip
pip install libretranslate==1.9.5

# Khởi động server
libretranslate --host 0.0.0.0 --port 5000 \
  --load-only en,es,fr,de \
  --req-limit 60 \
  --threads 4

Hoặc build từ source:

git clone https://github.com/LibreTranslate/LibreTranslate.git
cd LibreTranslate
pip install -e .
python main.py --host 0.0.0.0 --port 5000

Triển Khai trên DigitalOcean (Production Cloud) #

Cho instance production trên cloud, DigitalOcean cung cấp đường dẫn dễ dàng qua App Platform hoặc Droplets. Triển khai bằng Docker image 1-Click:

# Trên Ubuntu 24.04 Droplet mới
curl -fsSL https://get.docker.com | sh
mkdir -p ~/libretranslate && cd ~/libretranslate

# Tạo file compose production
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  libretranslate:
    image: libretranslate/libretranslate:v1.9.5
    restart: always
    ports:
      - "5000:5000"
    environment:
      - LT_LOAD_ONLY=en,es,fr,de,it,zh,ja,ru,pt
      - LT_API_KEYS=true
      - LT_REQ_LIMIT=120
      - LT_THREADS=4
    volumes:
      - ./models:/home/libretranslate/.local
      - ./db:/app/db
EOF

docker compose up -d

Lưu ý: Nếu bạn đang thiết lập VPS mới, DigitalOcean cung cấp $200 tín dụng miễn phí cho ngườii dùng mới, đủ để chạy một Droplet 4GB với LibreTranslate 24/7 trong vài tháng.

Tích Hợp Với Các Công Cụ Phổ Biến #

REST API của LibreTranslate khiến nó tương thích với hầu hết mọi stack. Dưới đây là các ví dụ tích hợp cho các workflow phổ biến.

Sử Dụng Python SDK #

# translate_client.py
import requests

LIBRETRANSLATE_URL = "http://localhost:5000/translate"

def translate_text(text: str, source: str = "en", target: str = "es") -> str:
    payload = {
        "q": text,
        "source": source,
        "target": target,
        "format": "text",
        "api_key": ""  # Thêm API key nếu đã bật
    }
    headers = {"Content-Type": "application/json"}

    response = requests.post(LIBRETRANSLATE_URL, json=payload, headers=headers)
    response.raise_for_status()
    return response.json()["translatedText"]

# Ví dụ sử dụng
if __name__ == "__main__":
    result = translate_text("Hello, production deployment!", "en", "de")
    print(f"Đã dịch: {result}")

Tích Hợp JavaScript/TypeScript #

// libretranslate-client.ts
interface TranslateResponse {
  translatedText: string;
}

class LibreTranslateClient {
  private baseUrl: string;
  private apiKey?: string;

  constructor(baseUrl: string = "http://localhost:5000", apiKey?: string) {
    this.baseUrl = baseUrl;
    this.apiKey = apiKey;
  }

  async translate(
    text: string,
    source: string = "en",
    target: string = "es"
  ): Promise<string> {
    const response = await fetch(`${this.baseUrl}/translate`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        q: text,
        source,
        target,
        format: "text",
        api_key: this.apiKey,
      }),
    });

    if (!response.ok) {
      throw new Error(`Dịch thất bại: ${response.statusText}`);
    }

    const data: TranslateResponse = await response.json();
    return data.translatedText;
  }
}

// Sử dụng
const client = new LibreTranslateClient("http://localhost:5000");
const result = await client.translate("Deploy to production", "en", "fr");
console.log(result); // "Déployer en production"

Pipeline OpenAI Whisper: Audio Sang Văn Bản Dịch #

Một pattern phổ biến là kết hợp nhận diện giọng nói với dịch thuật. Dưới đây là pipeline hoàn chỉnh sử dụng Whisper để phiên âm và LibreTranslate để dịch:

# whisper_translate_pipeline.py
import whisper
import requests

WHISPER_MODEL = whisper.load_model("base")
LIBRE_URL = "http://localhost:5000/translate"

def transcribe_and_translate(audio_path: str, target_lang: str = "en") -> dict:
    # Bước 1: Phiên âm audio bằng Whisper
    result = WHISPER_MODEL.transcribe(audio_path)
    source_text = result["text"]
    detected_lang = result.get("language", "auto")

    # Bước 2: Dịch bằng LibreTranslate
    payload = {
        "q": source_text,
        "source": detected_lang,
        "target": target_lang,
        "format": "text"
    }
    response = requests.post(LIBRE_URL, json=payload)
    translated = response.json()["translatedText"]

    return {
        "original": source_text,
        "translated": translated,
        "source_language": detected_lang,
        "target_language": target_lang
    }

# Chạy pipeline
output = transcribe_and_translate("meeting.mp3", target_lang="es")
print(f"ES: {output['translated']}")

Tích Hợp Coqui TTS (Dịch + Tổng Hợp Giọng Nói) #

Dịch văn bản và tổng hợp giọng nói bằng ngôn ngữ đích:

# translate_and_speak.py
import requests
from TTS.api import TTS

# Khởi tạo TTS
tts = TTS("tts_models/multilingual/multi-dataset/xtts_v2", gpu=False)

def translate_and_speak(text: str, target_lang: str, speaker_wav: str):
    # Dịch
    payload = {"q": text, "source": "en", "target": target_lang, "format": "text"}
    response = requests.post("http://localhost:5000/translate", json=payload)
    translated = response.json()["translatedText"]

    # Tổng hợp giọng nói
    output_path = f"output_{target_lang}.wav"
    tts.tts_to_file(
        text=translated,
        speaker_wav=speaker_wav,
        language=target_lang,
        file_path=output_path
    )
    return output_path

# Tạo audio đa ngôn ngữ
for lang in ["es", "fr", "de"]:
    translate_and_speak("Welcome to our service", lang, "reference.wav")

Ví Dụ API cURL #

# Dịch cơ bản
curl -X POST http://localhost:5000/translate \
  -H "Content-Type: application/json" \
  -d '{"q": "Hello world", "source": "en", "target": "es"}'

# Phản hồi: {"translatedText": "Hola mundo"}

# Phát hiện ngôn ngữ
curl -X POST http://localhost:5000/detect \
  -H "Content-Type: application/json" \
  -d '{"q": "Bonjour le monde"}'

# Lấy danh sách ngôn ngữ hỗ trợ
curl http://localhost:5000/languages

# Dịch với API key (nếu đã bật)
curl -X POST http://localhost:5000/translate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{"q": "Production deployment", "source": "en", "target": "de"}'

# Dịch HTML
curl -X POST http://localhost:5000/translate \
  -H "Content-Type: application/json" \
  -d '{
    "q": "<p>Hello <b>world</b></p>",
    "source": "en",
    "target": "fr",
    "format": "html"
  }'

Cấu Hình Nginx Reverse Proxy #

Cho các triển khai production với domain và HTTPS:

# /etc/nginx/sites-available/libretranslate
server {
    listen 443 ssl http2;
    server_name translate.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

    client_max_body_size 50M;

    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

# Chuyển hướng HTTP sang HTTPS
server {
    listen 80;
    server_name translate.yourdomain.com;
    return 301 https://$server_name$request_uri;
}

Kích hoạt cấu hình:

sudo ln -s /etc/nginx/sites-available/libretranslate /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Benchmark / Các Trường Hợp Sử Dụng Thực Tế #

Hiệu suất của LibreTranslate thay đổi đáng kể dựa trên cấu hình phần cứng, ngôn ngữ đã tải và độ dài văn bản. Dưới đây là các benchmark đo được từ các triển khai production.

Benchmark Tốc Độ Dịch Thuật #

So Sánh Chất Lượng Dịch Thuật #

Điểm BLEU trên tập kiểm tra WMT14 Anh-Đức (càng cao càng tốt):

LibreTranslate khớp chính xác với hiệu suất Argos Translate CLI vì chúng chia sẻ cùng engine. Khoảng cách chất lượng với API thương mại là có thể đo lường được nhưng đang thu hẹp: với các cặp ngôn ngữ châu Âu phổ biến, LibreTranslate tạo ra bản dịch chấp nhận được cho hầu hết các trường hợp sử dụng. Khoảng cách mở rộng đối với các cặp ngôn ngữ ít phổ biến hơn, văn bản kỹ thuật và nội dung sáng tạo tinh tế.

Phân Tích Chi Phí Quy Mô Lớn #

Lý lẽ kinh tế cho LibreTranslate tăng cường theo tỷ lệ thuận với khối lượng. Ở mức 100 triệu+ ký tự mỗi tháng, tự host rẻ hơn 10-50 lần so với các giải pháp thương mại.

Các Trường Hợp Sử Dụng Thực Tế #

• Cơ quan chính phủ: Xử lý tài liệu mật mà không có rủi ro rò rỉ dữ liệu.
• Hệ thống y tế: Dịch hồ sơ bệnh nhân trong ràng buộc HIPAA/GDPR.
• Nền tảng thương mại điện tử: Dịch hàng loạt danh mục sản phẩm với chi phí bằng không cho mỗi mục.
• Hệ thống quản lý nội dung: Dịch thờii gian thực nội dung do ngườii dùng tạo.
• Các tổ chức nghiên cứu: Xử lý bài báo học thuật đa ngôn ngữ trên hạ tầng nội bộ.
• Backend ứng dụng di động: Dịch độ trễ thấp cho ứng dụng du lịch và giao tiếp.

Sử Dụng Nâng Cao / Củng Cố Production #

Chạy LibreTranslate trong production đòi hỏi sự chú ý đến bảo mật, mở rộng và giám sát.

Quản Lý API Key #

Bật xác thực API key để kiểm soát truy cập và ngăn chặn lạm dụng:

# docker-compose.yml với API keys
services:
  libretranslate:
    image: libretranslate/libretranslate:v1.9.5
    environment:
      - LT_API_KEYS=true
      - LT_REQ_LIMIT=100
      - LT_REQ_LIMIT_PER_DAY=10000
    volumes:
      - lt-models:/home/libretranslate/.local
      - lt-db:/app/db

Tạo và quản lý API key qua database hoặc giao diện quản trị.

Tải Mô Hình Tùy Chỉnh #

Kiểm soát việc sử dụng bộ nhớ bằng cách chỉ tải các ngôn ngữ cần thiết:

# Chỉ tải ngôn ngữ châu Âu
LT_LOAD_ONLY=en,es,fr,de,it,pt,nl,pl,ru docker compose up -d

# Tải ngôn ngữ châu Á + châu Âu
LT_LOAD_ONLY=en,ja,zh,ko,es,fr,de docker compose up -d

Giám Sát Sức Khỏe #

LibreTranslate bao gồm endpoint kiểm tra sức khỏe tích hợp:

# Kiểm tra sức khỏe dịch vụ
curl http://localhost:5000/health

# Phản hồi mong đợi: {"status": "ok"}

Cho giám sát dựa trên Prometheus, thêm một exporter đơn giản:

# prometheus_exporter.py
from prometheus_client import start_http_server, Counter, Histogram
import requests
import time

TRANSLATION_COUNTER = Counter('libretranslate_requests_total', 'Tổng số bản dịch')
LATENCY_HISTOGRAM = Histogram('libretranslate_latency_seconds', 'Độ trễ dịch')

def monitor():
    start_http_server(9090)
    while True:
        start = time.time()
        requests.post("http://localhost:5000/translate",
            json={"q": "test", "source": "en", "target": "es"})
        LATENCY_HISTOGRAM.observe(time.time() - start)
        TRANSLATION_COUNTER.inc()
        time.sleep(30)

if __name__ == "__main__":
    monitor()

Tự Động Mở Rộng Với Kubernetes #

Cho các triển khai high-availability, sử dụng Kubernetes với Horizontal Pod Autoscaler:

# libretranslate-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: libretranslate
spec:
  replicas: 2
  selector:
    matchLabels:
      app: libretranslate
  template:
    metadata:
      labels:
        app: libretranslate
    spec:
      containers:
      - name: libretranslate
        image: libretranslate/libretranslate:v1.9.5
        ports:
        - containerPort: 5000
        env:
        - name: LT_LOAD_ONLY
          value: "en,es,fr,de,it"
        - name: LT_THREADS
          value: "4"
        resources:
          requests:
            memory: "2Gi"
            cpu: "1000m"
          limits:
            memory: "4Gi"
            cpu: "2000m"
        livenessProbe:
          httpGet:
            path: /health
            port: 5000
          initialDelaySeconds: 60
          periodSeconds: 30
---
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: libretranslate-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: libretranslate
  minReplicas: 2
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70

Triển khai:

kubectl apply -f libretranslate-deployment.yaml

Chiến Lược Sao Lưu #

Mô hình ngôn ngữ có thể tải lại, nhưng SQLite database chứa API key và log nên được sao lưu:

#!/bin/bash
# backup.sh - Cron job sao lưu hàng ngày
BACKUP_DIR="/backups/libretranslate"
DATE=$(date +%Y%m%d)

# Sao lưu database
docker cp libretranslate:/app/db "$BACKUP_DIR/db_$DATE.sqlite"

# Đồng bộ mô hình (tùy chọn - có thể tải lại)
rsync -av /var/lib/docker/volumes/lt-models/_data/ "$BACKUP_DIR/models/"

# Chỉ giữ 7 ngày sao lưu
find "$BACKUP_DIR" -name "db_*.sqlite" -mtime +7 -delete

Thêm vào crontab:

0 2 * * * /path/to/backup.sh

So Sánh Với Các Giải Pháp Thay Thế #

LibreTranslate lấp đầy một phân khúc cụ thể: nó là lựa chọn duy nhất kết hợp REST API, Web UI, tăng tốc GPU và khả năng offline hoàn toàn dưới giấy phép mã nguồn mở. Argos Translate cung cấp cùng engine dịch nhưng thiếu lớp API. Google và DeepL cung cấp chất lượng vượt trội và hỗ trợ ngôn ngữ rộng hơn, nhưng với chi phí là quyền riêng tư, phí định kỳ và phụ thuộc bên ngoài.

Hạn Chế / Đánh Giá Trung Thực #

LibreTranslate không phải là giải pháp thay thế phổ quát cho các API dịch thuật thương mại. Hiểu các hạn chế của nó là điều cần thiết để đưa ra quyết định áp dụng sáng suốt.

Khoảng cách chất lượng dịch: Trên benchmark WMT14, LibreTranslate kém DeepL khoảng 5.7 điểm BLEU và kém Google Translate 4.4 điểm. Khoảng cách này rõ rệt nhất đối với: (1) các cặp ngôn ngữ ít phổ biến như Anh-Swahili hoặc Phần Lan-Việt, (2) thuật ngữ chuyên ngành trong lĩnh vực pháp lý, y tế hoặc kỹ thuật, và (3) nội dung sáng tạo hoặc thành ngữ.

Tốn tài nguyên: Mỗi cặp ngôn ngữ đã tải tiêu thụ 300-600MB RAM. Triển khai đầy đủ 30 ngôn ngữ yêu cầu 8GB+ bộ nhớ. Điều này khiến LibreTranslate không phù hợp cho môi trường hạn chế tài nguyên như Raspberry Pi (trừ khi chỉ tải 2-3 ngôn ngữ) hoặc VPS nhỏ.

Phạm vi ngôn ngữ: Với 30+ ngôn ngữ, LibreTranslate bao phủ các cặp ngôn ngữ phổ biến nhất nhưng kém xa Google Translate với 130+ ngôn ngữ. Nếu trường hợp sử dụng của bạn yêu cầu dịch cho các ngôn ngữ thiểu số, LibreTranslate không đủ.

Không có streaming thờii gian thực: LibreTranslate xử lý các đoạn văn bản hoàn chỉnh. Nó không hỗ trợ dịch streaming hoặc dịch speech-to-text thờii gian thực, giới hạn khả năng áp dụng trong các tình huống hội thoại trực tiếp.

Tác động giấy phép AGPL-3.0: Giấy phép AGPL-3.0 yêu cầu bất kỳ sử dụng mạng nào của phần mềm (bao gồm qua API) kích hoạt yêu cầu share-alike. Các tổ chức xây dựng sản phẩm độc quyền trên LibreTranslate nên tham khảo ý kiến tư vấn pháp lý về tuân thủ giấy phép.

Gánh nặng bảo trì: Tự host có nghĩa là bạn chịu trách nhiệm cập nhật, bản vá bảo mật, cập nhật mô hình và giám sát hạ tầng. Cân nhắc chi phí vận hành khi so sánh với API được quản lý.

Câu Hỏi Thường Gặp #

LibreTranslate so với chạy Argos Translate trực tiếp khác nhau thế nào? #

LibreTranslate về cơ bản là một wrapper REST API xung quanh Argos Translate. Nếu bạn chỉ cần dịch command-line, Argos Translate có overhead thấp hơn. Nếu bạn cần HTTP API, giao diện web hoặc truy cập đa ngườii dùng, LibreTranslate thêm các lớp đó. Cả hai chia sẻ cùng mô hình dịch và tạo ra cùng output.

LibreTranslate có thể chạy trên Raspberry Pi không? #

Có, với hạn chế. Docker image ARM được tối ưu hóa cho hệ thống ARM64. Chỉ tải 2-3 cặp ngôn ngữ để giữ mức sử dụng bộ nhớ dưới 2GB. Mong đợi độ trễ dịch 800ms-1.5s mỗi request trên Raspberry Pi 4 với 4GB RAM. Cho sử dụng production, tối thiểu 4GB RAM được khuyến nghị.

Làm thế nào cập nhật mô hình ngôn ngữ mà không restart container? #

Đặt biến môi trường LT_UPDATE_MODELS=true. LibreTranslate kiểm tra cập nhật mô hình khi khởi động. Cho rolling updates trong triển khai Kubernetes, sử dụng chiến lược restart dần: cập nhật deployment với phiên bản image mới và Kubernetes thay thế pod tăng dần.

Độ dài văn bản tối đa cho mỗi request dịch là bao nhiêu? #

Có thể cấu hình qua flag --char-limit hoặc biến môi trường LT_CHAR_LIMIT. Mặc định là 10,000 ký tự mỗi request. Cho tài liệu dài hơn, chia văn bản thành các chunk và thực hiện các API call tuần tự.

LibreTranslate có phù hợp với tuân thủ HIPAA hoặc GDPR không? #

Bản chất tự host của LibreTranslate có nghĩa là dữ liệu không rồi khỏi hạ tầng của bạn, điều này đơn giản hóa việc tuân thủ. Tuy nhiên, tuân thủ là thuộc tính cấp hệ thống, không chỉ thuộc tính phần mềm. Bạn cũng phải bảo mật hệ điều hành host, mạng, sao lưu và kiểm soát truy cập. Tham khảo ý kiến chuyên viên tuân thủ của bạn để đánh giá đầy đủ.

Làm thế nào thêm mô hình ngôn ngữ tùy chỉnh? #

LibreTranslate hỗ trợ mô hình ở định dạng Argos Translate (mô hình OpenNMT CTranslate2). Đặt file .argosmodel tùy chỉnh vào thư mục mô hình và restart container. Mô hình tùy chỉnh hữu ích cho thuật ngữ chuyên ngành hoặc ngôn ngữ không được mô hình mặc định hỗ trợ.

Tôi có thể dùng LibreTranslate với framework frontend như React hoặc Vue không? #

Có. Endpoint /translate chấp nhận JSON và hỗ trợ CORS khi được cấu hình. Ví dụ React hook:

// useTranslation.ts
import { useState, useCallback } from "react";

export function useTranslation() {
  const [translating, setTranslating] = useState(false);

  const translate = useCallback(async (text: string, source: string, target: string) => {
    setTranslating(true);
    try {
      const res = await fetch("http://localhost:5000/translate", {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ q: text, source, target }),
      });
      const data = await res.json();
      return data.translatedText;
    } finally {
      setTranslating(false);
    }
  }, []);

  return { translate, translating };
}

Yêu cầu mạng cho triển khai offline là gì? #

Cho hoạt động hoàn toàn offline, build Docker image với --build-arg with_models=true để nhúng mô hình ngôn ngữ trong quá trình build. Image kết quả chứa mọi file cần thiết và không cần kết nối internet khi chạy. Kích thước image tăng khoảng 2-3GB tùy thuộc số lượng ngôn ngữ bao gồm.

Kết Luận #

LibreTranslate thực hiện đúng lờii hứa cốt lõi của nó: một API dịch thuật tự host với chi phí bằng không cho mỗi request và quyền riêng tư dữ liệu hoàn toàn. Với 14,400+ sao GitHub, bảo trì tích cực và v1.9.5 mang lại cải tiến ổn định, nó đã sẵn sàng production cho các team ưu tiên kiểm soát hơn chất lượng dịch thuật tuyệt đối.

Ngườii áp dụng LibreTranslate lý tưởng là team có: (1) khối lượng dịch thuật ổn định khiến giá tính theo ký tự trở nên đau đớn, (2) yêu cầu lưu trữ dữ liệu nghiêm ngặt, (3) năng lực DevOps để quản lý hạ tầng, và (4) sự chấp nhận khoảng cách chất lượng có thể đo lường nhưng chấp nhận được.

Nếu điều đó mô tả tình huống của bạn, hãy bắt đầu với thiết lập Docker Compose trong hướng dẫn này, tải 5 ngôn ngữ và đo lường chất lượng dịch thuật trên nội dung cụ thể của bạn. Hầu hết các team thấy chất lượng đủ tốt cho công cụ nội bộ, danh mục sản phẩm và nội dung do ngườii dùng tạo.

Cho các team cần chất lượng dịch thuật cao nhất tuyệt đối hoặc hỗ trợ 100+ ngôn ngữ, API thương mại vẫn là lựa chọn thực tế. Cho những ngườii còn lại, LibreTranslate loại bỏ một khoản chi phí định kỳ khỏi hóa đơn cloud của bạn.

Tham gia nhóm Telegram LibreTranslate để được hỗ trợ cộng đồng, hoặc theo dõi dự án trên GitHub để nhận cập nhật phiên bản.

Hosting Và Hạ Tầng Được Đề Xuất #

Trước khi triển khai các công cụ trên vào production, bạn cần hạ tầng vững chắc. Hai lựa chọn dibi8 đang dùng:

• DigitalOcean — Credit miễn phí $200 trong 60 ngày, 14+ khu vực toàn cầu. Lựa chọn mặc định cho dev chạy AI tools open source.
• HTStack — VPS Hong Kong, độ trễ thấp khi truy cập từ Trung Quốc. Cùng IDC đang host dibi8.com.

Liên kết tiếp thị — không tăng chi phí của bạn, giúp dibi8.com hoạt động.

Nguồn & Tài Liệu Tham Khảo #

• LibreTranslate GitHub Repository
• LibreTranslate Official Documentation
• Argos Translate GitHub Repository
• LibreTranslate Docker Hub
• OpenNMT Framework Documentation
• AGPL-3.0 License Summary
• DigitalOcean Docker Deployment Guide
• NVIDIA CUDA Docker Setup
• LibreTranslate Kubernetes Examples

Tuyên bố: Bài viết này chứa liên kết affiliate. Nếu bạn đăng ký DigitalOcean qua liên kết giớii thiệu trong hướng dẫn này, chúng tôi có thể nhận được hoa hồng mà không phát sinh chi phí thêm cho bạn. Liên kết affiliate giúp hỗ trợ việc duy trì liên tục các dự án tài liệu mã nguồn mở như thế này.