af49d22ca7
Add Telegram, WhatsApp and email account management, realtime messaging, contextual multilingual AI, customer intelligence, knowledge workflows, enterprise controls, a unified design system and complete repository documentation.
2.3 KiB
2.3 KiB
配置说明
以 .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_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 日志。