consul 命令行

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

摘要

文档详细介绍了Consul命令行的各个选项及其功能，包括数据目录配置、开发服务器模式、配置文件加载、Raft协议版本、服务器模式等。这些选项用于控制Consul代理的行为，确保集群的正确配置与运行，如数据持久化、日志级别、节点识别、网络通信端口、服务器选举等。文档还特别指出了不同版本中各选项的默认值和行为变化。

AI总结

以下是对文档内容的简洁明了的总结，重点突出核心观点和关键信息：

---

### Consul 命令行配置选项总结

Consul 是一个支持多数据中心的一致性和服务发现工具，其命令行选项用于配置代理行为。以下是关键选项的总结：

#### 1. **核心配置**
- **`-data-dir`**：指定代理存储状态的数据目录，必须持久化且支持文件系统锁定。
- **`-datacenter`**：设置代理运行的数据中心，默认为 `dc1`。
- **`-node`** 和 **`-node-id`**：指定节点名称（默认为主机名）和唯一标识符（默认生成并存储在数据目录中）。
- **`-server`**：启用服务器模式，集群必须至少有一个服务器节点。
- **`-bootstrap`** 和 **`-bootstrap-expect`**：控制服务器是否处于引导模式，`-bootstrap-expect` 指定预期的服务器数量。

#### 2. **服务器与集群**
- **`-join`** 和 **`-retry-join`**：指定启动时加入的代理地址，`-retry-join` 允许重试失败的连接。
- **`-serf-lan-port`** 和 **`-serf-wan-port`**：设置 LAN 和 WAN 通信端口，分别默认为 8301 和 8302。
- **`-bind`**、`-serf-lan-bind` 和 **`-serf-wan-bind`**：绑定内部通信地址，默认为 `0.0.0.0`。
- **`-client`**：指定客户端接口绑定地址，默认为 `127.0.0.1`，仅允许本地连接。

#### 3. **运行时优化**
- **`-raft-protocol`** 和 **`-raft-snapshot-threshold`**：控制 Raft 共识协议版本和快照频率。
- **`-raft-snapshot-interval`**：设置服务器检查快照频率，默认为 30 秒（1.1.0 及更高版本）。
- **`-log-level`**：设置日志级别，默认为 `info`。

#### 4. **网络与安全**
- **`-encrypt`**：指定加密密钥，必须是 16 字节 Base64 编码。
- **`-advertise`** 和 **`-advertise-wan`**：配置通告地址，用于更改群集中的节点地址。
- **`-disable-host-node-id`**：禁用基于主机信息生成节点 ID 的功能，默认为 `true`（0.8.5 及更高版本）。
- **`-ui`**：启用内置 Web UI。

#### 5. **配置与选项**
- **`-config-file`** 和 **`-config-dir`**：加载配置文件或目录，支持 `.json` 和 `.hcl` 格式。
- **`-config-format`**：强制指定配置文件格式为 `json` 或 `hcl`。
- **`-hcl`**：在命令行上指定 HCL 配置片段。

#### 6. **高级选项**
- **`-dev`**：启用开发服务器模式，适合快速原型设计，不适合生产环境。
- **`-rejoin`**：允许代理重新加入群集，忽略之前的离开状态。
- **`-syslog`**：记录日志到Syslog（仅在Linux和macOS上支持）。
- **`-non-voting-server`**：使服务器不参与Raft仲裁，仅用于读取扩展。

---

### 总结
Consul 命令行选项提供了丰富的配置可能性，涵盖核心功能、服务器模式、网络通信、安全性及运行时优化等方面。通过合理配置这些选项，可以实现高效的服务发现和一致性管理。