macos 上用 homebrew 安装 consul 需先安装并更新 homebrew，再通过 hashicorp/tap 官方源执行 brew install hashicorp/tap/consul；验证后可用 consul agent -dev 启动开发模式，支持 web ui 和 dns，也可用 brew services 设为常驻服务。
macos 上用 homebrew 安装 consul 很直接，关键是确保 homebrew 本身已正确安装并更新，再执行 consul 的安装与基础配置。整个过程不需要编译，也不依赖额外环境，适合开发和测试场景。
确认并安装 Homebrew（如未安装）
Homebrew 是 macOS 必备的包管理器。若尚未安装，推荐使用国内镜像加速安装，避免因网络问题失败：
- 运行命令：/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"
- 安装完成后，执行 brew doctor 检查环境是否就绪
- 运行 brew update 确保公式库为最新
安装 Consul
Consul 在 Homebrew 中已官方支持，推荐使用 HashiCorp 官方 tap，更稳定且版本及时：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 添加官方源：brew tap hashicorp/tap
- 安装 Consul：brew install hashicorp/tap/consul
- 验证安装：consul --version（输出类似 Consul v1.19.0 即成功）
启动并验证 Consul 服务
开发阶段最常用的是单节点 dev 模式，它自动启用 Web UI、DNS 接口和服务注册能力：
- 启动命令：consul agent -dev -client=0.0.0.0 -ui
- -dev 启用开发模式（内存存储、无持久化，仅用于本地调试）
- -client=0.0.0.0 允许本机所有网卡访问（含 localhost 和局域网 IP）
- -ui 自动启用内置 Web 界面
- 启动后访问 https://www.php.cn/link/becece8212d226d33f0e1302abc22ce8 即可查看服务列表、健康状态和 KV 存储
可选：设为系统服务常驻运行
如果希望 Consul 随系统启动并后台运行（例如本地开发长期使用），可用 brew services 管理：
- 启用服务：brew services start hashicorp/tap/consul
- 停止服务：brew services stop hashicorp/tap/consul
- 查看状态：brew services list | grep consul
- 注意：该方式仍运行在 dev 模式，默认数据不持久，重启后清空；生产环境请改用配置文件+ server 模式
