consul 命令行

• 语言: 中文（简体）
• 格式: .pdf
• 来源: b3logfile.com

摘要

文档详细介绍了Consul命令行工具的各个配置参数和功能选项。主要内容包括数据目录的配置（data-dir），数据中心的设置（datacenter），代理模式的切换（server），节点标识符的生成（node-id），加密通信的实现（encrypt），以及代理程序的运行参数如DNS端口（dns-port）、HTTP端口（http-port）等。文档还涵盖了代理程序的启动选项、网络通信参数、日志记录级别、节点元数据等高级功能，并提供了多个示例帮助用户更好地理解和使用这些配置选项。

AI总结

# Consul 命令行选项总结

Consul 提供了丰富的命令行选项来配置和管理代理程序。以下是核心选项的总结：

## 1. 配置与数据目录
- **config-file**：指定要加载的配置文件，支持 `.json` 和 `.hcl` 格式。
- **config-dir**：指定包含配置文件的目录，Consul 会按字母顺序加载所有 `.json` 或 `.hcl` 文件。
- **config-format**：强制指定配置文件的格式（`json` 或 `hcl`）。
- **data-dir**：指定代理程序存储状态的数据目录，必须持久化且支持文件系统锁定。

## 2. 网络与通信
- **advertise**：指定通告地址，默认使用 `-bind` 地址。
- **advertise-wan**：指定WAN地址，用于跨数据中心通信。
- **bind**：指定内部群集通信的绑定地址，默认为 `0.0.0.0`。
- **join**：启动时加入指定的代理地址，可多次指定。
- **retry-join**：在首次连接失败后重试，支持 IPv4、IPv6 和 DNS 地址。
- **serf-lan-bind** 和 **serf-wan-bind**：分别指定 LAN 和 WAN 端口的绑定地址。

## 3. 服务器与群集
- **bootstrap**：启用自举模式，允许单节点作为初始领导者。
- **bootstrap-expect**：指定数据中心预期的服务器数量。
- **server**：启用服务器模式，参与一致性算法和群集管理。
- **non-voting-server**：（企业版）启用只读服务器，不参与仲裁。

## 4. 安全与加密
- **encrypt**：指定加密密钥，用于加密网络流量，所有节点必须使用相同的密钥。
- **disable-keyring-file**：禁用密钥环文件持久化，适用于开发环境。

## 5. 网络与端口
- **http-port**：指定 HTTP API 端口，默认为 8500。
- **dns-port**：指定 DNS 端口，默认为 8600。
- **serf-lan-port** 和 **serf-wan-port**：分别指定 LAN 和 WAN 端口。
- **server-port**：指定服务器 RPC 端口，默认为 8300。

## 6. 日志与调试
- **log-level**：指定日志级别，可选 `trace`, `debug`, `info`, `warn`, `err`。
- **pid-file**：指定存储代理进程 ID 的文件路径。

## 7. 节点与元数据
- **node**：指定节点名称，默认为 hostname。
- **node-id**：指定节点 ID，需为 36 字符的十六进制字符串。
- **node-meta**：指定节点元数据，最多 64 对键值，键长 1-128 字符。

## 8. 其他
- **dev**：启用开发模式，内存服务器，不持久化数据。
- **disable-host-node-id**：阻止使用主机信息生成节点 ID。
- **recursor**：指定上游 DNS 服务器地址。
- **rejoin**：允许代理重新加入群集。
- **ui**：启用内置 Web UI。
- **protocol**：指定 Consul 协议版本，默认为最新版本。

这些选项可根据具体需求组合使用，灵活配置 Consul 代理程序的行为。