Ever Traduora 项目配置详解：从环境变量到最佳实践

Ever Traduora 项目配置详解：从环境变量到最佳实践

项目概述

Ever Traduora 是一个开源的翻译管理平台，为开发团队提供专业的本地化解决方案。本文将深入解析项目的配置系统，帮助用户根据实际需求进行定制化部署。

核心配置参数

基础服务配置

1. 运行环境设置

   • NODE_ENV：指定运行时环境（dev/prod/test），影响日志输出和调试功能
   • TR_PORT：服务监听端口，默认8080
   • TR_SECRET：应用密钥，用于JWT令牌签名，生产环境必须修改默认值

2. 虚拟主机配置

   • TR_VIRTUAL_HOST：设置实际部署域名，影响邮件中的链接生成

数据库连接

支持多种数据库类型（通过TR_DB_TYPE指定），主要配置项包括：

• 主机地址(TR_DB_HOST)
• 端口号(TR_DB_PORT)
• 数据库名称(TR_DB_DATABASE)
• 认证信息(TR_DB_USER/TR_DB_PASSWORD)

特别说明：TR_DB_AUTOMIGRATE控制是否自动执行数据库迁移，生产环境建议保持开启。

高级功能配置

用户与权限管理

1. 注册控制

   • TR_SIGNUPS_ENABLED：是否开放用户注册功能
   • TR_MAX_PROJECTS_PER_USER：限制单个用户创建的项目数量

2. 认证系统

   • JWT令牌有效期通过TR_AUTH_TOKEN_EXPIRES设置（单位：秒）
   • 支持Google OAuth集成，需配置相关参数：
     • TR_AUTH_GOOGLE_ENABLED
     • TR_AUTH_GOOGLE_CLIENT_ID
     • TR_AUTH_GOOGLE_CLIENT_SECRET
     • TR_AUTH_GOOGLE_REDIRECT_URL

邮件服务

邮件系统配置包含SMTP服务器设置和调试选项：

• 服务器配置(TR_MAIL_HOST/TR_MAIL_PORT)
• 安全连接(TR_MAIL_SECURE)
• 认证信息(TR_MAIL_USER/TR_MAIL_PASSWORD)
• 调试模式(TR_MAIL_DEBUG)

性能与安全配置

1. CORS设置

   • TR_CORS_ENABLED控制跨域请求支持

2. 日志记录

   • TR_ACCESS_LOGS_ENABLED管理请求日志输出

3. 导入限制

   • TR_IMPORT_MAX_NESTED_LEVELS限制导入术语的嵌套层级

最佳实践建议

1. 生产环境配置要点

   • 必须修改默认的TR_SECRET值
   • 关闭调试模式(TR_MAIL_DEBUG=false)
   • 设置正确的虚拟主机地址

2. 性能优化

   • 根据用户规模调整TR_MAX_PROJECTS_PER_USER
   • 合理设置JWT有效期平衡安全性与用户体验

3. 安全建议

   • 使用专用数据库用户而非root账户
   • 启用SSL/TLS加密数据库连接
   • 定期轮换应用密钥

通过合理配置这些参数，可以确保Ever Traduora在不同环境下都能稳定高效地运行，同时满足各类业务场景的需求。