概述
本文基于 Ubuntu 20.04 系统，记录 WeBASE 一键部署过程中的环境配置及常见问题解决方法。
1. 安装依赖
# CentOS 7 / RHEL 7
sudo yum -y install epel-release && sudo yum -y install openssl curl wget git nginx dos2unix
# Ubuntu 16.04+ / Debian 9+
sudo apt update && sudo apt -y install openssl curl wget git nginx dos2unix
2. 检查环境
检查 Java
# 安装默认 Java 版本 (Java 8 或以上)
sudo apt install -y default-jdk
# 查询 Java 版本
java -version
配置 JAVA_HOME
ls /usr/lib/jvm/
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
注意：JAVA_HOME 路径需根据实际安装的 JDK 版本进行调整。
验证
echo $JAVA_HOME
java -version
检查 Python
python --version
# 或
python3 --version
确保系统中存在 Python 2 或 Python 3 任一版本即可。
安装 MySQL
sudo apt update
sudo apt upgrade
sudo apt-get install mysql-server
sudo apt install mysql-client
sudo apt install libmysqlclient-dev
sudo service mysql start
sudo service mysql status
sudo mysql
更改密码
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
初始化
按提示完成初始化设置。
验证登录
使用 root 账号登录 MySQL 确认成功。
PyMySQL 部署
sudo apt-get install -y python3-pip
sudo pip3 install PyMySQL
3. 拉取部署脚本
获取部署安装包：
wget https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-deploy.zip
解压并进入目录：
unzip webase-deploy.zip
cd webase-deploy
修改配置
使用 vim 编辑配置文件：
vim common.properties
按 i 进入插入模式，修改完成后按 Esc，输入 :wq 保存退出。
部署与下载问题处理
执行部署命令：
python3 deploy.py installAll
注意： 若遇到 GitHub 连接不稳定或下载速度慢的情况，建议采用以下方案：
- 使用
aria2加速下载。 - 手动下载所需文件后放入对应目录。
方案一：使用 aria2 预下载
sudo apt update && sudo apt install aria2
# 下载 FISCO-BCOS
aria2c -x16 -s16 -c -o fisco-bcos.tar.gz \
https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.11.0/fisco-bcos.tar.gz
# 下载 WeBASE 相关组件
aria2c -x16 -s16 -c -o webase-node-mgr.zip \
https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-node-mgr.zip
aria2c -x16 -s16 -c -o webase-web.zip \
https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-web.zip
aria2c -x16 -s16 -c -o webase-web-mobile.zip \
https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-web-mobile.zip
aria2c -x16 -s16 -c -o webase-sign.zip \
https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-sign.zip
下载完成后，先停止服务再重新运行部署脚本：
python3 deploy.py stopAll
python3 deploy.py installAll
当脚本询问是否重新下载时，选择 n。
最后启动服务：
python3 deploy.py stopAll
python3 deploy.py startAll
4. 验证与后续
在浏览器访问：
http://localhost:5002/WeBASE-Front
如需校验，可参考 WeBASE 官方文档。如需编写合约，可先在 Remix 上尝试，随后部署至 WeBASE。
