使用 Homebrew 安装

下一个版本是 0.4，其 GitHub 发行尚未发布。以下命令描述计划中的产物。发布前请从源码构建，发布后也应在使用前验证每个产物。观测到的发布状态记录在 docs/releases/0.4-install-surfaces.json。

这是 INSTALL.md 称为推荐的 macOS 路径。它通过 Homebrew cask 安装已签名的 olivares 二进制文件，并清除 Gatekeeper 隔离。它不是 Linux 软件包路径 （从软件包安装），也不是 Docker （用 Docker 部署）。

测试版 — 26.10 cask 已发布

tap 的 Casks/olivares.rb 已于 2026-10-01 为 26.10 更新：它标明版本 26.10.1，以及四个平台归档， 其 SHA-256 与该发布签名的 checksums.txt 一致。生产者是 .goreleaser.yaml homebrew_casks:；tap 的 cask 由发布作业提升。下面的命令是 INSTALL.md 命名的坐标（brew install olivaresai/tap/olivares）。

1. 安装 cask

brew install olivaresai/tap/olivares

Homebrew 用记录的 SHA-256 核验每次 cask 下载（INSTALL.md）。cask 安装已 签名的二进制文件并清除 Gatekeeper 隔离。

Darwin 二进制文件由 cosign 签名（供应链信任），尚未经 Apple 公证。手动 下载归档会被隔离；cask 会处理，或按 INSTALL.md 的手动路径用 xattr -d com.apple.quarantine olivares 清除。

2. 首次运行

olivares quickstart

安全默认：TLS 开启、监听所有接口、无默认凭据。引擎打印控制台 URL 和一次性安装 令牌。继续见 第一个小时。

临时合成 estate（loopback、明文）仅供查看：

olivares serve --seed-demo --insecure --listen 127.0.0.1:8443 --grpc-listen 127.0.0.1:8444 \
  --data-dir "$(mktemp -d)"

--seed-demo 不是产品导览。见 第一个小时。

相关

• 自行托管控制平面 — 其他安装形状。
• 验证一次发布 — cosign、SBOM、来源。
• 从软件包安装 — Linux .deb / .rpm / .apk。