wmq
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.
64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
# 配置说明
|
||
|
||
以 `.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 日志。
|