Hyperledger Fabric Orderer 配置解析

Hyperledger Fabric Orderer 配置解析

文中使用的 fabric 版本为 2.4.1

排序节点在Fabric网络中为Peer提供排序服务。与Peer节点类似，排序节点支持从命令行参数、环境变量或配置文件中读取配置信息。环境变量中配置需要以ORDERER_前缀开头，例如，配置文件中的general.ListenAddress项，对应到环境变量ORDERER_GENERAL_LISTENADDRESS。

排序节点默认的配置文件读取路径为 $FABRIC_CFG_PATH 中定义的路径；如果没找到，则尝试查找当前目录；如果还没有找到，则尝试查找默认的 /etc/hyperledger/fabric 路径。

在结构上， orderer.yaml 文件中一般包括 General 、 FileLedger 、 RAMLedger 、 Kafka 、 Debug 、 Operations 、 Metrics 和 Consensus 八大部分.

---

General 部分

这一部分主要是一些通用配置，如账本类型、服务信息、配置路径等。这些配置影响到服务的主要功能，十分重要.

配置项	作用	默认值
ListenAddress	服务绑定的监听地址，一般需要指定为所服务的特定网络接口的地址或全网（0.0.0.0）	127.0.0.1
ListenPort	服务绑定的监听端口	7050
TLS.Enabled	启用TLS时的相关配置	false
TLS.PrivateKey	Orderer 签名私钥	tls/server.key
TLS.Certificate	Orderer 身份证书	tls/server.crt
TLS.RootCAs	信任的根证书	tls/ca.crt
TLS.ClientAuthRequired	是否对客户端也进行认证	false
TLS.ClientRootCAs	信任的客户端根证书列表	N/A
Keepalive.ServerMinInterval	允许其他客户端 ping 消息的最小间隔，超时则断开连接	60s
Keepalive.ServerInterval	到客户端的 ping 消息的间隔	7200s
Keepalive.ServerTimeout	关闭连接前等待响应的时间	20s
MaxRecvMsgSize	GRPC服务器和客户端可以接收的最大消息大小(以字节为单位)	104857600
MaxSendMsgSize	GRPC服务器和客户端可以发送的最大消息大小(以字节为单位)	104857600
Cluster	raft 模式下的集群配置	N/A
Cluster.SendBufferSize	发送缓冲区的最大长度	10
Cluster.ClientCertificate	双向TLS认证时，作为客户端证书的文件路径，如果没设置会使用 TLS.Certificate	N/A
Cluster.ClientPrivateKey	双向TLS认证时，作为客户端私钥的文件路径，如果没设置会使用 TLS.PrivateKey	N/A
Cluster.ListenPort	监听端口默认使用gRPC相同的端口	N/A
Cluster.ListenAddress	监听地址默认使用gRPC相同的地址	N/A
Cluster.ServerCertificate	双向TLS认证时，作为服务端证书的文件路径	N/A
Cluster.ServerPrivateKey	双向TLS认证时，作为服务端私钥的文件路径	N/A
BootstrapMethod	获取引导块的方法,2.x版本中仅支持file或none	file
BootstrapFile	系统通道初始区块或最新配置区块文件路径	N/A
LocalMSPDir	本地 MSP 文件路径	msp
LocalMSPID	MSP ID	SampleOrg
Profile	是否启用 Go profiling ,开启会影响性能	N/A
BCCSP	密码库机制等，可以为 SW（软件实现）或 PKCS11(硬件安全模块)	SW
Authentication.TimeWindow	如果客户端和服务端时钟差异超过窗口指定值，则拒绝消息	15m

---

FileLedger 部分

配置项	作用	默认值
Location	指定存放区块文件的位置，一般为/var/hyperledger/production/orderer。该目录下面包括chains子目录，存放各个chain的区块；index目录，存放索引文件	/var/hyperledger/production/orderer

---

Kafka 部分

因为不推荐使用了，暂时不关注

---

Debug 部分

Debug部分主要用于对排序节点进行调试和差错时的追踪配置。

配置项	作用	默认值
BroadcastTraceDir	广播请求的追踪路径	N/A
DeliverTraceDir	交付请求的追踪路径	N/A

---

Operations 部分

Operations部分与Peer相关配置类似，主要设置运行时对外的RESTful管理服务，包括监听的地址和TLS安全配置.

配置项	作用	默认值
ListenAddress	RESTful 管理服务的监听地址	127.0.0.1:8443
TLS.Enabled	是否启用 TLS 保护	false
TLS.Certificate	服务端使用证书文件路径	N/A
TLS.PrivateKey	服务端使用私钥文件路径	N/A
TLS.ClientAuthRequired	是否开启客户端验证以限定访问的客户端，默认关闭，推荐开启	false
TLS.ClientRootCAs	开启客户端验证时，信任的客户端根证书路径列表	[]

---

Metrics 部分

Metrics部分与Peer相关配置类似，负责配置统计服务

配置项	作用	默认值
provider	统计服务类型，可以为statsd(推送模式)，prometheus(拉取模式)，disabled	disabled
statsd.network	网络协议类型，tcp或udp	udp
statsd.address	修改为外部 statsd 的服务地址	127.0.0.1:8125
statsd.writeInterval	推送统计汇报到 statsd 的时间间隔	10s
statsd.prefix	为所有统计推送添加前缀	N/A

注意 statsd 和 prometheus 都是流行的开源监控数据收集软件。

---

Consensus 部分

共识为Raft模式时的日志存储配置

配置项	作用	默认值
WALDir	预写日志的存储位置，每个通道独占一个同名的子目录	/var/hyperledger/production/orderer/etcdraft/wal
SnapDir	快照文件的存储位置，每个通道独占一个同名的子目录	/var/hyperledger/production/orderer/etcdraft/snapshot
EvictionSuspicion	节点怀疑被从通道移除，触发从其他节点获取区块来确认的等待时间。隐藏参数	10m