QuantDinger 配置参考¶
QuantDinger 同时提供设置中心和根目录 .env。普通业务配置优先在 Settings 中管理；启动端口、基础设施、密钥和无法热更新的参数在宿主机 .env 管理。.env.example 是完整字段的机器可读来源，本页说明如何安全地找到和修改它们。
配置来源与优先级¶
| 来源 | 适用内容 | 修改后动作 |
|---|---|---|
| Settings | 产品功能、AI、数据、通知、品牌等 | 按页面提示保存；必要时重启服务 |
根目录 .env |
端口、数据库、Redis、Kafka、核心密钥、Worker | 重建受影响容器 |
| Compose 文件 | 服务拓扑、卷、网络和健康检查 | 重新执行 docker compose up -d |
| 外部基础设施 | DNS、TLS、数据库、对象存储、邮件和支付商户 | 按提供商流程验证 |
不要在多个安装目录维护互相冲突的 .env。生产加固配置可能以只读方式挂载环境文件，此时必须在宿主机修改。
设置中心信息架构¶
| 分组 | 页面 | 典型用途 |
|---|---|---|
| Core setup | Product features | 计费、市场和公开注册开关 |
| Core setup | Security & Authentication | 登录、会话和认证策略 |
| Core setup | AI / LLM | 模型提供商、密钥、模型和 Base URL |
| Core setup | Live Trading | 执行、同步和安全开关 |
| Core setup | Market Modules | 市场模块启用状态 |
| AI Research | Professional report data | 研究数据能力和专业源 |
| AI Research | News & web search | 新闻、搜索和证据来源 |
| AI Research | AI Agent | Agent 任务边界和限额 |
| AI Research | Data status & sync | 数据状态、同步和新鲜度 |
| Operations | Email/SMS | 通知渠道 |
| Operations | Network & Proxy | 出网代理与网络策略 |
| Operations | Registration & Security | 注册和安全控制 |
| Operations | System runtime | Worker 与运行时参数 |
| Organization | Billing、Brand、Contact、Social、Legal | SaaS 与品牌运营配置 |
必须备份且不得随意重置¶
| 变量 | 风险 |
|---|---|
POSTGRES_PASSWORD |
变更后可能无法连接已有数据库 |
SECRET_KEY |
使现有登录会话和签名失效 |
CREDENTIAL_ENCRYPTION_KEY |
变更后已有交易与外部凭据可能无法解密 |
DATABASE_URL |
指向错误数据库可能造成迁移或数据隔离事故 |
| OAuth、SMTP、支付密钥 | 泄露会导致账号、邮件或资金风险 |
常用配置分组¶
地址与端口¶
FRONTEND_HOST、FRONTEND_PORT、MOBILE_HOST、MOBILE_PORT、BACKEND_PORT 和 FRONTEND_URL。生产环境内部端口绑定回环地址，公网只通过反向代理开放 80/443。
产品与身份¶
QUANTDINGER_DEPLOYMENT_MODE、ENABLE_REGISTRATION、BILLING_ENABLED、MARKETPLACE_ENABLED、管理员账号、OAuth 和 Turnstile。个人部署不要启用不需要的 SaaS 能力。
AI¶
LLM_PROVIDER 以及对应提供商的 API Key、模型和 Base URL。只配置正在使用的提供商；超时、温度和降级参数先保持默认。
数据、交易与 Agent¶
数据源、代理、ALLOW_LOCAL_DESKTOP_BROKERS、仓位同步、执行流以及 AGENT_* 限额。真实交易和 Agent 下单默认保持关闭，经过权限与限额验收后再启用。
基础设施¶
数据库池、Redis 内存、Kafka、Celery、Worker 副本数、日志大小和可观测性端口。增加副本前先看数据库连接、Kafka 分区和主机容量。
安全修改流程¶
- 记录当前版本和变更目的。
- 备份数据库与
.env。 - 一次只修改一个配置组。
- 执行
docker compose config检查渲染结果。 - 用
docker compose up -d --force-recreate <service>重建受影响服务。 - 检查健康、日志和关键业务流程。
- 失败时恢复
.env和固定镜像版本，不盲目删除卷。
完整默认值和注释始终以根目录 .env.example 为准。