Consul 在 FlyEnv 中
Consul 是 HashiCorp 的服务发现与服务网格平台：服务可自行注册，健康检查跟踪可用性，内置键值存储用于分发配置。它常用于需要注册表来查找和监控服务的微服务堆栈，例如集成 Spring Cloud Consul 的 Spring Boot 应用，也适合本地开发。FlyEnv 将 Consul 作为托管本地服务器代理运行：安装一个或多个版本，使用生成的单节点服务器配置启动代理，将数据存放在可迁移的按版本目录，并一键在浏览器中打开 Consul 内置 Web UI。配置、日志和服务控制都位于同一模块页面。
版本管理
在 Consul → 版本管理器 中并行安装并保留多个 Consul 版本，然后选择服务要运行的版本。
- **各平台安装来源：**所有平台均可使用静态在线列表中的现成软件包；macOS 还支持 Homebrew 和 MacPorts，Linux 还支持 Homebrew。
- **自定义版本：**将 FlyEnv 指向包含你自己 Consul 安装的任意目录，系统会扫描该目录，并将这些构建与托管版本一起列出。
- **一次运行一个版本：**Consul 以单个本地代理运行；已有版本运行时无法启动其他版本，切换前请先停止当前版本。
服务与配置
FlyEnv 以分离方式启动真实的 consul agent 二进制，无需 root 权限。生成的默认配置描述自包含本地服务器：server: true、bootstrap_expect: 1、client_addr: 127.0.0.1 和 ui_config.enabled: true，代理绑定到你的主局域网地址。
- **可编辑数据目录：**每个版本都有独立的数据目录（默认为 FlyEnv Consul 目录下的
consul-<major>-data），可直接从服务选项卡按版本修改路径。选定目录会通过-data-dir传给代理，因此重启后状态仍会保留；除非手动指定相同路径，否则不同版本不会共享数据。 - 原始 JSON 编辑器：“配置文件”选项卡会在源代码编辑器中打开
consul-<major>.json；没有可视化表单，因此每个 Consul 选项都可直接编辑。FlyEnv 仅在文件缺失时生成配置，不会覆盖你的修改，并在旁边保留.default副本供参考。 - **端口感知：**模块其他位置会从该 JSON 配置读取 HTTP 端口和其他设置，因此你设置的自定义值都会生效。
Web 界面
Consul 自带 Web UI，FlyEnv 会在生成配置中启用它（ui_config.enabled: true）。服务工具栏的打开 UI按钮会在默认浏览器中打开 http://127.0.0.1:8500/ui/；端口读取自 JSON 配置的 ports.http，修改 HTTP 端口后按钮会自动跟随。
在该界面中，你可以浏览已注册的服务和节点、检查健康状态，并针对运行中的本地代理编辑键值存储。
日志
日志选项卡直接在 FlyEnv 中打开代理的 consul.log。FlyEnv 使用 -log-file=consul.log 启动代理，因此启动消息、Raft 事件、加入和同步活动都会写入该文件；版本无法启动或服务未按预期注册时应首先检查此日志。
相关指南、解决方案和演示
继续阅读实用指南、解决方案、演示或社区文章。
兼容性说明
FlyEnv 管理本地 Consul 代理、配置文件和数据目录，但不保证每个操作系统或安装来源都提供所有版本。版本管理器中的版本取决于平台（macOS 使用 Homebrew/MacPorts，Linux 使用 Homebrew，Windows 使用静态软件包）及来源发布内容。Windows 上 FlyEnv 会在生成配置中加入 raft_logstore.backend = boltdb，以规避该平台特有的 Raft 日志 fsync 故障。Consul 模块仅管理代理，不提供项目级版本绑定或网站反向代理集成。相关模块还包括 R-Nacos 和 etcd；无需 Docker 运行 Node.js、Python 和 Go 服务指南介绍其余本地微服务堆栈。可安装版本请查看应用内列表和下载页面，实际演示请参阅demos。