# 配置说明

以 `.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 示例：

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

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