跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Pythonjava

WeBASE 一键部署实战:Ubuntu 环境配置与常见问题解决

综述由AI生成WeBASE 在 Ubuntu 20.04 环境下的一键部署涉及依赖安装、环境配置及资源下载等关键步骤。记录了从基础环境搭建(Java、MySQL)到脚本拉取配置的完整流程,重点解决了 GitHub 下载缓慢的网络问题,推荐使用 aria2 加速。通过标准化 common.properties 配置及服务启停操作,可实现快速验证与合约部署准备。

怪力乱神发布于 2026/4/9更新于 2026/4/252 浏览
WeBASE 一键部署实战:Ubuntu 环境配置与常见问题解决

WeBASE 一键部署实战:Ubuntu 环境配置与常见问题解决

在基于 Ubuntu 20.04 部署 WeBASE 的过程中,遇到了一些网络环境和配置细节上的坑。这里整理了一份从零开始的实操记录,重点解决依赖安装、MySQL 初始化以及 GitHub 资源下载慢的问题。

有一定能力的可以直接参考官方文档进行部署。

1. 安装基础依赖

根据系统版本选择相应的命令安装 OpenSSL、Git、Nginx 等工具。

# 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. 检查并配置运行环境

2.1 Java 环境

WeBASE 依赖 Java 8 或以上版本。默认安装 OpenJDK 后需配置环境变量。

# 安装默认 Java 版本
sudo apt install -y default-jdk

# 查询已安装的 Java 路径
ls /usr/lib/jvm/

# 配置 JAVA_HOME (以 java-11-openjdk-amd64 为例)
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

验证配置是否生效:

echo $JAVA_HOME
java -version

2.2 Python 环境

确保系统中存在 Python 3。

python --version
# 或
python3 --version

2.3 MySQL 数据库

安装 MySQL 服务及客户端,并修改 root 密码。

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
 service mysql status
 mysql
sudo
sudo

进入 MySQL 命令行后,执行以下 SQL 修改 root 密码(请替换为你的实际密码):

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你自己的密码';

初始化完成后,建议通过图形化工具或命令行验证登录状态。

2.4 PyMySQL 库

部署脚本需要 PyMySQL 支持。

sudo apt-get install -y python3-pip
sudo pip3 install PyMySQL

3. 拉取部署脚本

从 WeBankBlockchain 仓库获取部署包。

wget https://github.com/WeBankBlockchain/WeBASELargeFiles/releases/download/v1.5.5/webase-deploy.zip
unzip webase-deploy.zip
cd webase-deploy

4. 修改配置文件

使用 vim 编辑 common.properties 文件,根据实际环境调整相关参数。

vim common.properties

操作说明:按 i 进入插入模式,修改内容后按 Esc,输入 :wq 保存退出。

5. 处理网络问题与资源下载

直接运行 python3 deploy.py installAll 时,由于 GitHub 连接不稳定,下载速度可能极慢甚至中断。建议采用以下方式优化:

方案一:使用 aria2 加速

安装 aria2 并手动下载所需资源包,可大幅提升稳定性。

sudo apt update && sudo apt install aria2

常用资源下载地址如下:

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

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

方案二:本地下载

如果服务器无法访问外网,可在 Windows 环境下下载好压缩包,通过 WinSCP 或 FileZilla 传输至 Linux 服务器对应目录。

6. 部署与启动服务

若已通过上述方式预下载了资源,可先停止旧服务,再重新运行安装脚本。

# 停止所有服务
python3 deploy.py stopAll

# 执行安装(此时会检测到已有资源,跳过下载)
python3 deploy.py installAll
# 当提示是否重新下载时,选择 n

# 启动所有服务
python3 deploy.py startAll

7. 验证与后续

部署完成后,可通过浏览器访问管理后台进行校验。

  • 本地访问:http://localhost:5002/WeBASE-Front
  • 远程访问:确认虚拟机 IP 后,在宿主机浏览器中访问对应地址。

如需进一步校验功能,可查阅官方文档。若计划编写合约,建议先在 Remix IDE 上进行测试,确认无误后再部署到 WeBASE 环境中。

目录

  1. WeBASE 一键部署实战:Ubuntu 环境配置与常见问题解决
  2. 1. 安装基础依赖
  3. CentOS 7 / RHEL 7
  4. Ubuntu 16.04+ / Debian 9+
  5. 2. 检查并配置运行环境
  6. 2.1 Java 环境
  7. 安装默认 Java 版本
  8. 查询已安装的 Java 路径
  9. 配置 JAVA_HOME (以 java-11-openjdk-amd64 为例)
  10. 2.2 Python 环境
  11. 或
  12. 2.3 MySQL 数据库
  13. 启动服务
  14. 2.4 PyMySQL 库
  15. 3. 拉取部署脚本
  16. 4. 修改配置文件
  17. 5. 处理网络问题与资源下载
  18. 方案一:使用 aria2 加速
  19. 方案二:本地下载
  20. 6. 部署与启动服务
  21. 停止所有服务
  22. 执行安装(此时会检测到已有资源,跳过下载)
  23. 当提示是否重新下载时,选择 n
  24. 启动所有服务
  25. 7. 验证与后续
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 利用 Anthropic Skill 提升大模型前端设计审美
  • Python FastAPI 入门实战:从零构建生产级 RESTful API
  • 4nm 移动 SoC 三星高能效 NPU 架构解析
  • ToDesk ToClaw 评测:零门槛体验 OpenClaw 级 AI 自动化
  • Redis Hash 数据类型及相关指令详解
  • Stable Diffusion 文生图基础详解与参数配置
  • 学习大语言模型原理必看的 10 篇论文
  • Mockingbird C++ Mocking Framework 轻量级元编程解析
  • 大模型入门指南:从基础原理到进阶应用详解
  • Android Framework 核心源码解析:从系统启动到应用框架详解
  • WebMCP:浏览器 AI 交互新范式
  • AI Coding 深度解析:定义、核心能力与行业价值
  • C++ 在线判题系统(OJ)设计与实现
  • Ψ0 人形全身 VLA:基于人类视频预训练与 MM-DiT 后训练方案
  • 通义万相AI绘画生成电商主图与Prompt模板
  • 使用 LangChain 构建开源大语言模型智能体实践
  • 学 Python 需要安装什么软件?Python 开发工具与运行环境指南
  • C++ 基础实战:从循环控制到算法入门
  • 基于YOLOv8与Lung-CLIP的肺结节智能检测系统
  • Debian 系统 libwebkit2gtk-4.1-0 安装后无法加载排查

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online