PPunk IoT
文档Engine系统配置

Engine / 02

系统配置

YAML 只负责进程启动所需的引导参数；可在线管理的业务配置保存到 SQLite。

引导配置

config.yaml · 开发示例
manager:
  host: 127.0.0.1
  port: 11011
storage:
  driver: sqlite
  dsn: ./data/rules.db
messaging:
  mode: internal
  port: 0
executor:
  plugins_dir: ./plugins

port: 0 让内置 NATS 选择随机可用端口。外部 NATS 模式只应通过 Secret 或环境变量提供凭证。

YAML 与 SQLite 的边界

位置保存内容删除后的行为
YAML监听地址、数据库位置、消息模式、插件目录等启动参数进程无法确定引导参数，除非显式提供默认启动模式
SQLite用户、系统配置、插件状态、Connector、规则与运行记录启动时自动建表；首次管理员需环境变量密码
部署不应携带开发数据库。可以只分发可执行文件、UI 资源和生产 YAML；数据库应在目标环境首次启动时创建，并纳入持久卷和备份。

网络与 CORS

生产环境推荐由同一个反向代理提供 UI 与 /api，浏览器保持同源，Manager API 只监听回环或内网。若必须跨域，SQLite 中白名单为空时不得解释为“允许全部”；应显式填写完整来源。

  • 开发：允许已知本地 UI 来源。
  • 生产：只允许实际 HTTPS 域名。
  • 修改 API 端口时更新同源代理，前端代码无需重编译。

插件目录

plugins_dir 相对于进程工作目录解析。每个插件有独立目录、manifest 和可执行产物；共享能力只能来自 SDK。启动前确保目录不可被非授权用户写入。