lingxi-web/docs/CONFIGURATION.md

配置说明

以 .env.example 为唯一模板。开发、测试、生产分别保存自己的 .env，不得提交 Git。

基础配置

变量	必填	说明
LX_DB_USER	否	PostgreSQL 用户，默认 lingxi
LX_DB_PASSWORD	是	数据库强密码
LX_DB_NAME	否	数据库名，默认 lingxi_crossborder
LX_JWT_SECRET	是	至少 32 字节随机值
LX_WEB_PORT	否	Web 暴露端口，默认 8088
APP_PUBLIC_URL	是	用户访问的 HTTPS 根地址
PUBLIC_WEBHOOK_BASE_URL	是	外部网关可访问的 Webhook 根地址

AI

变量	必填	说明
DEEPSEEK_API_KEY	是	服务端模型密钥
DEEPSEEK_MODEL	是	当前默认 deepseek-v4-flash

API 基础地址在 Compose 中设置为 https://api.deepseek.com/anthropic。切换模型前应验证 Anthropic 兼容接口、JSON 输出稳定性、延迟和成本。

Telegram

变量	说明
TELEGRAM_GATEWAY_URL	独立 Telegram Gateway API 地址
TELEGRAM_GATEWAY_TOKEN	网关服务令牌
TELEGRAM_GATEWAY_TENANT_ID	网关租户
TELEGRAM_GATEWAY_SERVICE_EMAIL / PASSWORD	服务账号
TELEGRAM_GATEWAY_ACCOUNT_ID	可选默认账号
TELEGRAM_WEBHOOK_SECRET	Telegram Webhook 独立签名密钥

WhatsApp

变量	说明
WHATSAPP_GATEWAY_TOKEN	API 与网关间认证，至少 32 位
WHATSAPP_WEBHOOK_SECRET	Webhook 签名密钥，不能与 Token 相同
WHATSAPP_LOG_LEVEL	info、warn 或 error

WhatsApp 登录态保存在 lingxi_whatsapp_data 卷，不得复制到源码目录或提交 Git。

邮箱与支付

• 团队邀请：SMTP_HOST、SMTP_PORT、SMTP_SECURE、SMTP_USER、SMTP_PASSWORD、SMTP_FROM。
• 企业邮箱渠道使用用户提供的 IMAP/SMTP 信息；EMAIL_CREDENTIAL_KEY 用于加密凭据。
• Stripe：STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 和各套餐 STRIPE_PRICE_*。

生成随机密钥

PowerShell 示例：

$bytes = New-Object byte[] 48
[Security.Cryptography.RandomNumberGenerator]::Fill($bytes)
[Convert]::ToBase64String($bytes)

每个变量单独生成，不复用。生产密钥应放入部署平台的 Secret 管理，不写入 Compose、镜像或 CI 日志。