搭建WeBase管理平台保姆级教程

目标：在本地快速部署一套完整的 FISCO-BCOS 区块链 + WeBASE 管理平台\ 环境：Mac / Windows / Linux 均可（推荐 Linux 或 macOS）\ 时间：约 30–40 分钟\ 结果：你将能打开浏览器访问 http://localhost:5000 登录 WeBASE 前端界面。

了解 WeBASE 架构

WeBASE（WeBank Blockchain Application Software Extension）是 FISCO BCOS 的配套管理平台，由四个主要组件组成：

官方建议四个模块配合使用。

安装前准备

1️⃣ 安装 Docker 与 docker-compose

# 检查是否已安装
docker -v
docker-compose -v

如果没有：

• macOS/Windows → 安装 Docker Desktop

• Ubuntu：

  sudo apt install docker.io docker-compose -y
  sudo systemctl start docker
  sudo systemctl enable docker

2️⃣ 拉取官方 demo 链（内置 FISCO-BCOS 节点）

git clone https://github.com/WeBankBlockchain/WeBASE-Docker.git
cd WeBASE-Docker

WeBASE 自带一份简易链，你只需执行：

bash build_chain.sh

此命令会自动下载一条 1 群组的 FISCO BCOS 区块链，并生成配置。当然也可以用部署好的Fisco节点。

搭建步骤

这里包含了我个人安装的详细步骤以及踩过所有坑的解决方案。 1）安装mysql数据库

sudo apt install -y mysql-server
service mysql start #启动
mysql -u root -p #测试连接
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';#改密码

2）安装python环境

apt install -y python3 python3-pip python3-venv
apt install -y python3-pymysql python3-requests python3-psutil

apt-get install python3-distutils -y

3）安装webase及其所有依赖

wget https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v3.1.1/webase-deploy.zip
unzip webase-deploy.zip

apt install -y nginx git curl net-tools lsof vim

4）启动 python3 deploy.py installAll

bug：Exception: execute cmd error ,cmd : sudo /usr/sbin/nginx -t , status is 127 ,output is /bin/sh: 1: sudo: not found；

解决：在 Docker 容器里默认就是没有 sudo 的，去修改一下脚本命令即可

cd /root/webase-deploy/comm
vim check.py
将res2 = doCmd("sudo " + res["output"] + " -t ")改为res2 = doCmd(res["output"] + " -t")

bug：error! JAVA_HOME has not been configured!

解决：配置java环境变量

echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Bug：failed to run command '/usr/lib/jvm/java-21-openjdk-amd64/bin/java': No such file or directory

解决：webase官方文档中要求JDK为8-14，我安装的是21，重新下载JDK11

apt install openjdk-11-jdk -y
update-alternatives --config java #切换版本

但还是报这个错，我尝试去start.sh中改一下配置文件，直接用java而不用环境变量

nohup java $JAVA_OPTS -Djava.library.path=$CONF_DIR -cp $CLASSPATH $APP_MAIN >> $LOG_DIR/front.out 2>&1 &

Bug：启动mysql错误-sh: 12: id: not found

解决：由于宿主机重启导致mysql异常，尝试重新安装mysql

apt purge -y mysql-server mysql-client mysql-common mysql-server-core-* mysql-client-core-*

rm -rf /etc/mysql /var/lib/mysql /var/log/mysql

apt autoremove -y
apt autoclean

但是还是启动不了。

重启webase

python3 deploy.py stopAll

python3 deploy.py startAll

netstat -tunlp | grep java #查询一下启动端口
ip addr show eth0 #找到docker内网地址

5）开放端口并重启服务

docker commit fisco_ubuntu fisco_ubuntu1

docker run -itd \
--name fisco_webase1 \
-p 30300-30303:30300-30303 \
-p 20200-20203:20200-20203 \
-p 8545-8548:8545-8548 \
-p 5010:5000 \
-p 5001:5001 \
-p 5002:5002 \
-p 5004:5004 \
-p 3306:3306 \
ubuntu:22.04 \
/bin/bash

# 进入容器，重启服务
docker exec -it fisco_webase1 bash
bash nodes/127.0.0.1/start_all.sh
python3 deploy.py startAll

访问：http://127.0.0.1:6002/WeBASE-Front/#/home 即可看到可视化页面

bug：ERR_UNSAFE_PORT

解决：在终端中输入

open -a 'Google Chrome' --args --explicitly-allowed-ports=6000

访问：http://localhost:5010/

bug：启动Node-Manager进程后，后台日志显示**not found any front**：

这个问题我解决了很久，最后在官方文档附录中查阅到需要在前端配置一下节点，配置如图：