Tolgee平台自托管部署中的用户认证与机器翻译配置指南

概述

Tolgee作为一款优秀的开源本地化平台，在自托管部署时需要进行一些必要的配置才能使所有功能正常运作。本文将详细介绍如何配置用户认证系统和机器翻译服务，这是Tolgee自托管环境中两个关键但容易被忽视的配置项。

用户认证系统配置

在标准Tolgee自托管部署后，用户可能会发现系统没有用户登录界面，管理侧边栏也缺少用户管理功能。这是因为默认情况下Tolgee没有启用任何认证机制。

要启用用户认证，需要在部署时配置以下关键参数：

1. 基本认证配置：必须设置认证类型，支持多种认证方式
2. 管理员账户：首次部署时需要创建至少一个管理员账户
3. 会话管理：配置会话过期时间和安全策略

这些配置通常通过环境变量或配置文件完成，具体取决于您的部署方式（Docker、Kubernetes或直接运行）。

机器翻译服务集成

Tolgee平台支持集成多种机器翻译服务，但在自托管环境中默认不启用任何机器翻译提供商。要启用此功能，需要：

1. 选择机器翻译提供商：Tolgee支持包括Google Translate、DeepL、AWS Translate等主流服务
2. 配置API密钥：为选定的服务配置有效的API凭证
3. 设置配额限制：合理配置翻译配额以防止意外超额使用

特别值得注意的是，Tolgee Translator（Tolgee自有的机器翻译引擎）需要团队订阅或更高级别的许可证才能在自托管环境中使用。

最佳实践建议

1. 生产环境部署时，建议同时配置用户认证和至少一种机器翻译服务
2. 对于小型团队，可以考虑使用免费的机器翻译API配额
3. 定期检查机器翻译API的使用情况，避免意外费用
4. 为不同团队成员配置适当的权限级别

总结

Tolgee平台的自托管部署虽然简单，但要充分发挥其全部功能，特别是用户管理和机器翻译这两个核心功能，需要进行正确的配置。通过本文介绍的配置方法，用户可以轻松启用这些功能，获得完整的本地化管理体验。