配置说明

Broker 配置

Broker服务主要有三类配置，Spring Boot进程配置、区块链FISCO-BCOS节点配置、WeEvent服务配置。

  • Spring Boot进程配置

    配置文件./broker/conf/application-prod.properties，这个是Spring Boot标准配置文件，一般不需要修改。细节请参见Spring Boot文档 。

配置项 默认值 配置说明
server.port 7000 spring监听端口
server.servlet.context-path /weevent spring上下文路径

  • 区块链FISCO-BCOS节点配置

    配置文件./broker/conf/fisco.properties。

配置项 默认值 配置说明
version 2.0 FISCO-BCOS版本，支持2.0和1.3
topic-controller.address 1:0x23df89a289312...; WeEvent系统合约地址。
orgid fisco 机构名，按机构实际名称填写即可
nodes 127.0.0.1:30701 区块链节点列表，多个地址以;分割
account bcec428d5205abe0f... WeEvent执行交易的账号，一般不需要修改
web3sdk.timeout 10000 交易执行超时时间，单位毫秒
web3sdk.core-pool-size 10 web3sdk最小线程数
web3sdk.max-pool-size 200 web3sdk最大线程数
web3sdk.queue-capacity 1000 web3sdk队列大小
web3sdk.keep-alive-seconds 60 web3sdk线程空闲时间，单位秒
consumer.idle-time 1000 区块链新增块事件检测周期，单位毫秒
consumer.history_merge_block 8 事件过滤的区块范围

区块链节点详细配置，参见Web3SDK配置文件 。

  • WeEvent服务配置

    配置文件./broker/conf/weevent.properties 。

配置项 默认值 配置说明
ip.check.white-table IP白名单。多个IP地址，以";"分割。
默认为空时表示允许任何客户端访问。
redis.server.ip redis服务IP
redis.server.port 6379 redis服务端口
redis.server.password weevent redis服务访问密码
lru.cache.capacity 65536 缓存大小，使用LRU策略淘汰
restful.subscribe.callback.timeout 5000 事件通知回调的超时时间，单位毫秒
broker.zookeeper.ip zookeeper服务
broker.zookeeper.path /event_broker zookeeper数据路径
broker.zookeeper.timeout 3000 zookeeper链接超时时间，单位毫秒
stomp.user.login stomp访问账号，空为不开启校验
stomp.user.passcode stomp访问密码
stomp.heartbeats 30 stomp心跳间隔，单位秒
mqtt.broker.port 7001 mqtt协议TCP访问端口，默认不开启
mqtt.broker.keepalive 60 mqtt连接空闲时间，单位秒
mqtt.websocket.path /weevent/mqtt mqtt连接目录
mqtt.websocket.port 7002 mqtt协议web socket访问端口，默认不开启
mqtt.user.login mqtt访问账号，空为不开启校验
mqtt.user.passcode mqtt访问密码

Governance

配置文件./governance/conf/application-prod.yml。

配置项 默认值 配置说明
server.port 7009 spring监听端口
spring.datasource.url jdbc:mysql://127.0.0.1:3306/governance?useUnicode=true&characterEncoding=utf-8&useSSL=false 数据源
spring.datasource.driver-class-name org.mariadb.jdbc.Driver 驱动类
spring.datasource.username xxxx 数据库账号用户名
spring.datasource.password yyyy 数据库账号密码
spring.datasource.type org.apache.commons.dbcp2.BasicDataSource 数据源类型
spring.datasource.dbcp2.max-wait-millis 10000 数据库连接池最长等待时间ms
spring.datasource.dbcp2.min-idle 5 数据库连接池最小空闲
spring.datasource.dbcp2.initial-size 5 数据库连接池初始大小
spring.datasource.dbcp2.validation-query SELECT 'x' 数据库连接池验证查询
spring.mail.default-encoding UTF-8 编码类型
spring.mail.host smtp.163.com 邮件服务器主机
spring.mail.username mailusername@163.com 邮箱用户名
spring.mail.password mailpwd 邮箱密码
http.client.max-total 200 http最大请求数
http.client.max-per-route 500 http最大请求路由数
http.client.connection-request-timeout 3000 http请求读取超时时间ms
http.client.connection-timeout 3000 http请求连接超时时间ms
http.client.socket-timeout 5000 http请求socket超时时间ms
https.client.read-timeout 3000 服务器内部读取其它服务的超时时间ms
https.client.connect-timeout 3000 服务器内部连接其它服务的超时时间ms

Nginx 配置说明

  • 修改后端子模块路由

    通过配置文件nginx/conf/conf.d/http_rs.conf里的upstream来增加和移除后端的业务机器。

    upstream broker_backend{
    server localhost:7000 weight=100 max_fails=3;

    ip_hash;
    keepalive 1024;
}

upstream broker_mqtt_websocket_backend {
    server localhost:7002 weight=100 max_fails=3;

    ip_hash;
    keepalive 1024;
}

upstream governance_backend{
    server localhost:7009 weight=100 max_fails=3;

    ip_hash;
    keepalive 1024;
}

    特别的，如果使用了基于TCP的MQTT协议。配置文件为nginx/conf/conf.d/tcp_rs.conf。

  • 使用TLS加密传输

    WeEvent通过Nginx实现TLS加密传输。如下./nginx/conf/nginx.conf的默认配置不支持TLS。

    worker_processes  10;
pid         logs/nginx.pid;

events {
	  use epoll;
    worker_connections  10000;
}
worker_rlimit_nofile 10000;

#support web/restful/jsonrpc/stomp
http {
    include       mime.types;
    default_type  application/octet-stream;
    keepalive_timeout  65;

    #custom config
    server_tokens           off;
    client_body_temp_path   ./nginx_temp/client_body;
    proxy_temp_path         ./nginx_temp/proxy;
    fastcgi_temp_path       ./nginx_temp/fastcgi;
    uwsgi_temp_path         ./nginx_temp/uwsgi;
    scgi_temp_path          ./nginx_temp/scgi;

    #http conf
    include                 ./conf.d/http_rs.conf;

    #include ./conf.d/https.conf
    include                 ./conf.d/http.conf;
}

# support mqtt over tcp
stream {
    include                 ./conf.d/tcp_rs.conf;

    #include ./conf.d/tcp_tls.conf
    include                 ./conf.d/tcp.conf;
}

    通过对应替换include ./conf.d/https.conf和include ./conf.d/tcp_tls.conf来支持TLS。

更多Nginx配置文件说明，请参见Nginx配置 。