Configuration Reference

中文 | English

配置参考

维护版本：v0.51.2 ｜ 最后更新：2026-07-06

本页是 eneros.toml 配置文件的段落速查。完整配置项与默认值请查阅主仓库 eneros.toml 与 docs/deployment.md §3。

配置文件位置

路径	用途
eneros.toml	项目根默认配置（GitHub 公开）
/etc/eneros/eneros.toml	生产部署配置
eneros.toml.local	本地覆盖（gitignore）
环境变量 ENEROS_<SECTION>__<FIELD>	运行时覆盖

段落速查

段	用途	引入版本	默认启用
[topology]	电网拓扑数据源	v0.15.0	是
[powerflow]	潮流计算参数	v0.16.0	是
[scada]	SCADA 数据采集	v0.26.0	是
[devices]	设备连接列表	v0.25.0	是
[api]	HTTP API 服务	v0.11.0	是
[observability]	日志 / metrics / tracing	v0.11.0	是
[network]	电网网络模型	v0.24.0	是
[emergency]	紧急阈值参数	v0.23.0	是
[security]	JWT 密钥 / API Key	v0.11.0	是
[eventbus]	事件总线容量	v0.19.0	是
[tenant]	多租户	v0.38.0	否
[zero_trust]	零信任 CA / mTLS	v0.39.0	否
[threat_detection]	入侵检测	v0.39.0	否
[audit]	WORM 审计 + HMAC	v0.39.0	否
[ops]	运维自动化	v0.40.0	否
[ha_enhance]	多区域高可用	v0.41.0	否
[i18n]	国际化	v0.47.0	否
[privacy]	数据隐私合规	v0.47.0	否
[quality]	质量门禁参数	v0.51.0	是

关键段配置示例

[topology] 电网拓扑

[topology]
source = "json"           # json / cnpower / pandapower
path = "data/ieee14.json"

[powerflow] 潮流计算

[powerflow]
solver = "newton"         # newton / fast_decoupled / forward_backward / dc
tolerance = 1e-8
max_iterations = 50

[scada] SCADA 数据采集

[scada]
source = "iec104"         # iec104 / modbus / mock
iec104_addr = "192.168.1.100:2404"
fast_interval_ms = 100
normal_interval_ms = 1000

[api] HTTP API

[api]
host = "0.0.0.0"
port = 8080
enable_tls = false
tls_cert_path = ""
tls_key_path = ""

[observability] 可观测性

[observability]
log_level = "info"        # trace / debug / info / warn / error
enable_metrics = true
enable_tracing = true
metrics_port = 9090
jaeger_endpoint = "http://localhost:4317"

[tenant] 多租户（v0.38.0+）

详见本 wiki 多租户 页。

[zero_trust] 零信任（v0.39.0+）

详见本 wiki 零信任安全 页。

[ops] 运维自动化（v0.40.0+）

详见本 wiki 运维与插件 页。

[ha_enhance] 多区域高可用（v0.41.0+）

详见本 wiki 高可用与多区域 页。

[quality] 质量门禁（v0.51.0+）

[quality]
fuzz_targets = ["iec104", "iec103", "dlt698", "pmu_c37118"]
proptest_cases = 256

配置热重载

支持运行时热重载（v0.9.0+），无需重启：

字段	热重载	备注
observability.log_level	✅ 立即生效
observability.enable_metrics	✅
scada.fast_interval_ms	⚠️ 下次 pipeline 重启
scada.normal_interval_ms	⚠️ 下次 pipeline 重启
emergency.*	✅
powerflow.tolerance	✅
powerflow.max_iterations	✅
api.host / api.port	❌ 需重启	绑定地址
api.enable_tls / api.tls_cert_path	❌ 需重启
network.source / network.path	❌ 需重启	电网模型
devices	❌ 需重启	设备连接列表
scada.source / scada.iec104_addr	❌ 需重启
security.jwt_secret	❌ 需重启
eventbus.max_queue_size	❌ 需重启
tenant.enabled / tenant.storage_path	❌ 需重启

手动热重载：

curl -X POST http://localhost:8080/api/config/reload

查看当前配置（敏感字段已脱敏）：

curl http://localhost:8080/api/config

环境变量覆盖

格式：ENEROS_<SECTION>__<FIELD>（双下划线分隔段与字段）

ENEROS_API__PORT=9090 ./target/release/eneros-api run
ENEROS_SCADA__SOURCE=iec104 ENEROS_SCADA__IEC104_ADDR=192.168.1.100:2404 ./target/release/eneros-api run
ENEROS_OBSERVABILITY__LOG_LEVEL=debug ./target/release/eneros-api run
ENEROS_TENANT__ENABLED=true ./target/release/eneros-api run

相关文档

• 主仓库 eneros.toml — 完整配置文件
• 主仓库 docs/deployment.md §3 — 配置管理详解
• 本 wiki 部署指南 — 部署方式与配置文件位置
• 本 wiki 多租户 / 零信任安全 / 运维与插件 / 高可用与多区域 — 各特性段配置