访问
- 打开
http://<SERVER_IP>并在浏览器中访问。 - API 文档位于
/docs. - API 请求请使用生成的 API 密钥。密钥保存在
/root/libretranslate/.credentials.
API 用法
翻译请求示例:
curl -X POST http://<SERVER_IP>/translate \
-d q='Hello' \
-d source=en \
-d target=es \
-d api_key='<API_KEY>'
替换 <API_KEY> 替换为生成的 API 密钥。
配置
主要环境变量保存在 /root/libretranslate/.env.
LT_VERSION:LibreTranslate 镜像版本REQ_LIMIT:每个客户端每分钟的最大请求数CHAR_LIMIT:每次请求允许的最大字符数
按需修改配置。
修改配置后,运行以下命令使其生效:
cd /root/libretranslate
docker compose up -d
重要文件与目录
- 安装路径:
/root/libretranslate - Compose 文件:
/root/libretranslate/docker-compose.yml - 环境:
/root/libretranslate/.env - 凭据:
/root/libretranslate/.credentials - 模型:
/var/lib/docker/volumes/libretranslate_models - 密钥数据库:
/var/lib/docker/volumes/libretranslate_db - Caddy 配置:
/etc/caddy/Caddyfile
域名与 HTTPS(Caddy)
0. HTTPS 证书无法为 IP 地址签发。
1. 将域名(例如 example.com) 指向您服务器的 IP 地址。
2. 更新 /etc/caddy/Caddyfile:
example.com {
reverse_proxy localhost:5000
}
3. 重新加载 Caddy:
systemctl reload caddy
4. 通过以下地址访问 LibreTranslate: example.com.
注意事项
- 可根据你的偏好在以下文件中修改配置:
/root/libretranslate/.env. - Under Attack 模式默认开启,用于保护公开 API 免受滥用或自动化请求的影响。
- 请求限制默认开启,默认上限为每个客户端每分钟
60次请求。 - 每次请求默认最多
5000个字符。 - LibreTranslate 容器仅监听
127.0.0.1:5000;公开访问由 Caddy 提供。