1.安装环境准备
| 类型 | 内容 |
|---|---|
| CPU | 建议不低于8核虚机或者服务器，最好在16核以上 |
| 存储 | 存储不少于500GB |
| 内存 | 内存不低于8GB，建议16GB以上 |
检查内容
- 关闭防火墙
- 主机名检查
- /etc/security/limit.conf检查
- 系统参数检查
- 磁盘目录检查
2.配置参数说明
- 确认hostname
执行 hostname 命令- 修改 hosts 文件
vim /etc/hosts 192.168.2.100 <主机名> - 解压安装包
tar -zxvf zcbus.simple_server.docker.v2.0.1.aarch64.v1.plus.mysql.tar.gz tar -zxvf zcbus.simple_server.docker.v2.0.1.aarch64.v2.plus.mysql.tar.gz - zcbus.properties配置说明
- 注意修改ZC_MEMORY_LIMIT参数
若无需要调整的配置，使用默认配置文件即可
####################################################################
## Copyright(c) ZCBUS Corporation 2022. All rights reserved. ##
## ##
## Specify values for the variables listed below to customize ##
## your installation. ##
## ##
## Each variable is associated with a comment. The comment ##
## can help to populate the variables with the appropriate ##
## values. ##
## ##
## IMPORTANT NOTE: This file should be secured to have read ##
## permission only by the zcbus user or an administrator who ##
## own this installation to protect any sensitive input values. ##
## ##
####################################################################
#-------------------------------------------------------------------------------
# Specify the installation option.
# Specify ZCBUS INSTALL home ,for storage docker's cache and images
#-------------------------------------------------------------------------------
ZC_DATA_HOME=/data/docker02
#-------------------------------------------------------------------------------
# Specify the installation option.
# Specify ZCBUS'S docker basic home ,for storage docker's cache and images
#-------------------------------------------------------------------------------
ZC_DOCKER_HOME=/data/docker
#-------------------------------------------------------------------------------
# Specify the installation option.
# Specify docker's username
#-------------------------------------------------------------------------------
ZC_DOCKER_USER=zcbus
#-------------------------------------------------------------------------------
# Specify a location to install ZCBUS'S TYPE ,Only support cloud_client
#-------------------------------------------------------------------------------
ZC_TYPE=server
#-------------------------------------------------------------------------------
# Specify a docker's listener port
#-------------------------------------------------------------------------------
ZC_DOCKER_SERVER_PORT=8899
#-------------------------------------------------------------------------------
# Zcbus client remote location API service URL connection service
#-------------------------------------------------------------------------------
ZC_CUSTOMER_URL=http://v2.zbomc.com
#-------------------------------------------------------------------------------
# Parameter set to zcbus_cache/zcbus_kafka
# zcbus_cache is zcbus's mq for zcbus single mode
# kafka_cache is kafka or zcbus cluster mode
#-------------------------------------------------------------------------------
ZC_CACHE_TYPE=zcbus_cache
#-------------------------------------------------------------------------------
# Remote receiving zcbus data stream port service
#-------------------------------------------------------------------------------
ZC_CACHE_SERVER=zcbuscache:6600
#-------------------------------------------------------------------------------
# Remote receiving zcbus data resource port service
#-------------------------------------------------------------------------------
#ZC_NET_DB_SERVER_TYPE=postgresql
ZC_NET_DB_SERVER_TYPE=mysql
ZC_NET_DB_SERVER_DBNAME=zcbus
ZC_NET_DB_SERVER_HOST=zcbusnet
ZC_NET_DB_SERVER_PORT=33060
ZC_NET_DB_SERVER_USER=QFlYT0k6
ZC_NET_DB_SERVER_PWD=e0twWGp8aVtWfGB8dn9YdTo
ZC_NET_DB_SERVER_ID=2
ZC_INSTALL_MODE=0
#-------------------------------------------------------------------------------
# Remote receiving zcbus data resource port service,include master and slave's ip
#-------------------------------------------------------------------------------
ZC_DB_IPPORT=zcbusdb:3306
#-------------------------------------------------------------------------------
# Remote zcbus'services nodes ip
#-------------------------------------------------------------------------------
ZC_NODE_IPS=zcbusdb
#-------------------------------------------------------------------------------
#-------------------------------------------------------------------------------
# Remote install zcbus type integrate/external
#-------------------------------------------------------------------------------
ZC_METHOD=integrate
#-------------------------------------------------------------------------------
# Remote install zcbus include database docker
# 0 is equal ZC_METHOD's integrate mode,all server include docker,and other is external mode
# 1 is include zcbusvue/zcbusrestapi
# 2 is include zcbusvue/zcbusrestapi,zcbusdb
# 3 is include zcbusvue/zcbusrestapi,zcbuskafka/zcbuszookeeper
#-------------------------------------------------------------------------------
ZC_SERV_LOCALTION=0
#-------------------------------------------------------------------------------
# for ZCBUS COM CODE default 1
#-------------------------------------------------------------------------------
ZC_COM_CODE=1
#-------------------------------------------------------------------------------
# Parameter set to http/https ,default http
#-------------------------------------------------------------------------------
ZC_HTTP_MODE=http
#-------------------------------------------------------------------------------
# Parameter set to 1, Kafka uses Sasl authentication, set to 0, no authentication method
#-------------------------------------------------------------------------------
ZC_CACHE_SASL=0
#-------------------------------------------------------------------------------
# if add zcbus's default container :1 is add container,0 is not add container
#-------------------------------------------------------------------------------
ZC_IF_ADD_DEFAULT_ZCBUS=1
#------------------------------------------------------------------------------
#- for check data file limit
#------------------------------------------------------------------------------
ZC_DATA_DIR_LIMIT=10G
#------------------------------------------------------------------------------
#- for check docker limit
#------------------------------------------------------------------------------
ZC_DOCKER_DIR_LIMIT=5G
#-------------------------------------------------------------------------------
# for ZCBUS use memory min limit set, Suggest setting the minimum value 4GB
#-------------------------------------------------------------------------------
ZC_MEMORY_LIMIT=4G
#-------------------------------------------------------------------------------
# for ZCBUS use proxy connect to zcbusnet,0 is not set
#-------------------------------------------------------------------------------
ZC_NET_PROXY=0
ZC_NET_PROXY_PORT=3311
ZC_NET_PROXY_USER=QFkKCzo
ZC_NET_PROXY_PWD=QFkKC2p6SUlNCkheOg
ZC_NET_PROXY_POOL=128
ZC_NET_PROXY_PROCESS=1
3.安装过程
[root@zc201 simple_server]# ./zcmgr.sh install
[INFO] Installation log: /tmp/zcbus-install-20260813-104513-27796.log
[OK] Memory check passed: require 4G, available 6G
[INFO] Validating /data/soft/simple_server/common/zcbus.properties
[ZC_TYPE] Validating value 'server' against allowed list: cloud_client simple_client server cloud_server
[ZC_CACHE_TYPE] Validating value 'zcbus_cache' against allowed list: zcbus_cache zcbus_kafka
[ZC_NET_DB_SERVER_TYPE] Validating value 'mysql' against allowed list: postgresql mysql
[ZC_METHOD] Validating value 'integrate' against allowed list: integrate external
[ZC_SERV_LOCALTION] Validating value '0' against allowed list: 0 1 2 3
[ZC_HTTP_MODE] Validating value 'http' against allowed list: http https
[ZC_CACHE_SASL] Validating value '0' against allowed list: 0 1
[ZC_IF_ADD_DEFAULT_ZCBUS] Validating value '1' against allowed list: 0 1
[ZC_NET_PROXY] Validating value '0' against allowed list: 0 1
Configuration file validation passed!
===========================================================/data/soft/simple_server/common/auto_config_hosts.sh============================================================================
==Starting SWAP status check...
==Current SWAP details:
NAME TYPE SIZE USED PRIO
/dev/dm-1 partition 2G 306.8M -2
==[Step 1] Auto-detecting physical NIC IP address...
==Scanning non-virtual NICs, excluding loopback/link-local addresses...
==Final selected physical NIC IP address: 192.168.2.201
==========================================
==Starting to check and configure host info
==----------------------------------------
==Physical NIC IP (auto-detected): 192.168.2.201
==Target Hostname (user-specified): zc201
==========================================
==[Check Item 1] System hostname configuration
==Expected hostname: zc201
==Current hostname: zc201
==No modification needed
==[Check Item 2] Forbid 127.0.0.1 mapping to target hostname
==Checking for illegal mapping of 127.0.0.1 to zc201...
==No illegal mapping found, check passed
==
==[Check Item 3] Auto-configure /etc/hosts IP-hostname mapping
==Target mapping: 192.168.2.201 <-> zc201
==Backed up /etc/hosts to: /etc/hosts.backup.20260813104514
==Skipped - mapping already exists in /etc/hosts
==========================================
==Physical IP Address: 192.168.2.201
==Target Hostname: zc201
==----------------------------------------
==All configuration items completed successfully!
==Host configuration check/auto-configuration finished!
==================================================================================================================================================================
Start ZCBUS installation? [y/N]: y
Install language [0=Chinese, 1=English, default 0]:
Database type [mysql/postgresql, default mysql]:
Install method [integrate/external, default integrate]:
[INFO] Available modes: server, serverv2, server_full, server_compute, cloud_server, client, client_full, cloud_client, cloud_push
Install mode [server]:
[1/8] Validate installation configuration
[OK] Pre-flight image check passed: 7 image(s) ready
[2/8] Check operating system requirements
[INFO] Starting SWAP status check...
[WARN] Detected SWAP is enabled!
NAME TYPE SIZE USED PRIO
/dev/dm-1 partition 2G 306.8M -2
[INFO] 192.168.2.201 zc201
[3/8] Prepare data directory and runtime user
Data directory [/data/docker02]:
[INFO] Load Path to /data/docker02 ...
[OK] Disk space check passed for /data/docker02: require 10G, available 90G
[INFO] Used user's pwd for default pwd
[4/8] Check Docker environment
[OK] Disk space check passed for /data/docker: require 5G, available 90G
[5/8] Check and load container images
Load local container images? [Y/n]: y
[WARN] Load images to docker's failed ...
Redirecting to /bin/systemctl restart docker.service
[OK] Docker images loaded: 7/7
c4d19aff7fcafa0e1bad2cbb0c4fde7bd82370cd5f08ac34f9fe1d06df0808f5
[6/8] Generate service configuration
====mode :server,file=docker-compose-server.yml.jinja
====mode :zcbus_cache,file=zcbus-cache-mq-priv.yml.jinja
trusting_hodgkin
[OK] Service configuration generated for server
[OK] Generated compose image check passed: 6 image(s) ready
[INFO] Checking service ports
[7/8] Initialize and start services
[WARN] docker zcbusdb check failed and retry 1 seconds ...
[+] Running 1/1
✔ Container zcbusdb Started 2.2s
[INFO] docker zcbusdb up sucessfull...
[WARN] docker zcbusnet check failed and retry 1 seconds ...
[+] Running 1/1
✔ Container zcbusnet Started 11.0s
[INFO] docker zcbusnet up sucessfull...
[INFO] Check zcbusdb Connect Failed ,wait 30 seconds and retry 1 times ...
[INFO] docker zcbusnet up sucessfull...
zcbus_docker is Stopping ...
kill -9 12172...
kill -9 12199...
kill -9 12923...
zcbus_docker is Finished ...
zcbus_docker is Stopping ...
zcbus_docker is Finished ...
[INFO] Adding default ZCBUS container in /data/docker02
no such service: zcbus
====mode :zcbus_default,file=zcbus-server-zcbus.yml.jinja
elegant_ganguly
[OK] Generated compose image check passed: 6 image(s) ready
[INFO] docker zcbusnet up sucessfull...
====>>>ZCBUS [ Thu Aug 13 10:47:54 CST 2026 ]
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
zcbus reg.zbomc.com/zcbus_server:v2.0.1 "/bin/bash -c ${ZCBU…" zcbus 1 second ago Up Less than a second
zcbusdb reg.zbomc.com/zcbus_mysql:v2.0.1 "docker-entrypoint.s…" zcbusdb About a minute ago Up 45 seconds 3306/tcp, 33060/tcp
zcbusnet reg.zbomc.com/zcbus_server:v2.0.1 "/bin/bash -c ${ZCBU…" zcbusnet About a minute ago Up 52 seconds 0.0.0.0:33060->33060/tcp, :::33060->33060/tcp
root 2767 1 0 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -log_level 2
root 2792 1 0 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -manager -log_level 2
root 3056 1 1 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -listener -log_level 2
[8/8] Verify installation result
====>>>ZCBUS [ Thu Aug 13 10:48:06 CST 2026 ]
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
zcbus reg.zbomc.com/zcbus_server:v2.0.1 "/bin/bash -c ${ZCBU…" zcbus 13 seconds ago Up 12 seconds
zcbuscache reg.zbomc.com/zcbus_server:v2.0.1 "/bin/bash -c ${ZCBU…" zcbuscache 1 second ago Up Less than a second 0.0.0.0:6600-6602->6600-6602/tcp, :::6600-6602->6600-6602/tcp
zcbusdb reg.zbomc.com/zcbus_mysql:v2.0.1 "docker-entrypoint.s…" zcbusdb About a minute ago Up 57 seconds 3306/tcp, 33060/tcp
zcbusjob reg.zbomc.com/zcbus_job:v2.0.1 "sh /run.sh" zcbusjob 1 second ago Up Less than a second 7080/tcp
zcbusnet reg.zbomc.com/zcbus_server:v2.0.1 "/bin/bash -c ${ZCBU…" zcbusnet About a minute ago Up 1 second 0.0.0.0:33060->33060/tcp, :::33060->33060/tcp
zcbusredis reg.zbomc.com/zcbus_redis:v2.0.1 "docker-entrypoint.s…" zcbusredis 1 second ago Up Less than a second 6379/tcp
zcbusrestapi reg.zbomc.com/zcbus_restapi:v2.0.1 "sh /run.sh" zcbusrestapi 1 second ago Up Less than a second 7080/tcp
zcbusvue reg.zbomc.com/zcbus_vue:v2.0.1 "/docker-entrypoint.…" zcbusvue 1 second ago Up Less than a second 0.0.0.0:8890->80/tcp, :::8890->80/tcp
root 2767 1 0 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -log_level 2
root 2792 1 0 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -manager -log_level 2
root 3056 1 0 10:47 pts/0 00:00:00 /data/docker02/bin/zcbus_docker -listener -log_level 2
[OK] ZCBUS installation completed
[INFO] Install mode: server
[INFO] Data directory: /data/docker02
[INFO] Manager console: http://192.168.2.201:8890
[INFO] Default account: admin (change the default password after first login)
[INFO] Installation log: /tmp/zcbus-install-20260813-104513-27796.log4.2 页面验证默认容器添加激活，且生效
文档更新时间: 2026-08-25 23:51 作者：liyue
