LibreTranslate

Acesso

• Abra http://<SERVER_IP> em um navegador.
• A documentação da API está disponível em /docs.
• Use a chave de API gerada nas requisições à API. Ela fica armazenada em /root/libretranslate/.credentials.

Uso da API

Exemplo de requisição de tradução:

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

Substituir <API_KEY> pela chave de API gerada.

Configuração

As principais variáveis de ambiente ficam armazenadas em /root/libretranslate/.env.

• LT_VERSION: versão da imagem do LibreTranslate
• REQ_LIMIT: máximo de requisições por minuto por cliente
• CHAR_LIMIT: máximo de caracteres permitidos por requisição

Modifique a configuração conforme necessário.

Depois de alterar a configuração, aplique-a com:

cd /root/libretranslate
docker compose up -d

Ficheiros e diretórios importantes

• Caminho de instalação: /root/libretranslate
• Arquivo Compose: /root/libretranslate/docker-compose.yml
• Ambiente: /root/libretranslate/.env
• Credenciais: /root/libretranslate/.credentials
• Modelos: /var/lib/docker/volumes/libretranslate_models
• Banco de chaves: /var/lib/docker/volumes/libretranslate_db
• Configuração do Caddy: /etc/caddy/Caddyfile

Domínio e HTTPS (Caddy)

0. Certificados HTTPS não podem ser emitidos para endereços IP.

1. Aponte um domínio (por exemplo, example.com) para o endereço IP do seu servidor.

2. Atualizar /etc/caddy/Caddyfile:

example.com {
    reverse_proxy localhost:5000
}

3. Recarregue o Caddy:

systemctl reload caddy

4. Acesse o LibreTranslate em example.com.

Notas

• Modifique a configuração de acordo com suas preferências em /root/libretranslate/.env.
• O modo Under Attack vem ativado por padrão para ajudar a proteger a API pública contra requisições abusivas ou automatizadas.
• A limitação de requisições está ativada com um limite padrão de 60 requisições por minuto por cliente.
• As requisições são limitadas a 5000 caracteres por padrão.
• O contêiner do LibreTranslate escuta apenas em 127.0.0.1:5000; o Caddy fornece o acesso público.