Skip to content

组件与安装模式 ​

组件矩阵 ​

组件key默认模式可选模式说明
Dockerdockernative仅 native容器运行时底座,其他容器模式组件的前提
PostgreSQLpostgresqldockerdocker / native容器或系统包安装
MySQLmysqldockerdocker / native同上
Redisredisdockerdocker / native同上
Elasticsearchelasticsearchdocker仅 docker默认关闭安全认证,公网前必须加固

模式传错服务端明确拒绝(CLI 退出码 2):elasticsearch -m native、docker -m docker 均非法。

模式语义 ​

  • native:系统包管理器/官方脚本直装宿主机,systemd 或原生进程管理;卸载时打印手动清理指引。
  • docker:容器运行,数据落命名卷;重建(--force)与卸载(remove)保留数据卷。
  • 容器模式要求 Docker 已装:多组件安装按依赖序 middleware install docker redis postgresql,或 --missing 自动补缺。

状态模型 ​

middleware get <key> 返回:installed(已安装)、running(在跑)、版本、模式、安装位置、可编辑参数表。 安装/启停/卸载都是 Run:用 middleware get 核对终态,而不是只看命令退出码。

平台与权限 ​

  • 实装仅 Linux;Windows/macOS 服务端只能 --dry-run(预演仍产生运行记录与日志)。
  • 仅 admin;普通用户调用报 403。
  • 安装脚本需要 root 或等价权限(写 /usr、/etc、systemd、docker sock);服务端以 root unit 运行时天然满足。

默认端口与暴露面 ​

默认参数面向内网便利:数据库/Redis 端口直接映射宿主机、Elasticsearch 无认证。 任何公网暴露前:改绑定地址或防火墙/安全组限制来源、设置强密码(middleware set -p *_PASSWORD=…)、必要时反代加鉴权。 清单见 安全加固。

延伸阅读 ​