跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Pythonjava

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

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

怪力乱神发布于 2026/4/9更新于 2026/7/2336 浏览
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

# 启动服务
 service mysql start
 service mysql status
 mysql
sudo
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. 验证与后续
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Java Web 开发入门:基础概念与静态资源解析
  • 基于 Leaflet-Trackplayer 实现高速轨迹 WebGIS 可视化实战
  • 基于 OpenClaw 和 Ollama 搭建本地 AI 智能体教程
  • Ollama 支持 Llama 3.2 Vision 及视觉 RAG 系统搭建指南
  • 基于 Leaflet Trackplayer 的 WebGIS 高速公路轨迹可视化
  • Java 多线程与并发核心机制详解
  • C++ string 类模拟实现详解
  • MC.JS WEBMC1.8 实战:构建在线多人沙盒游戏
  • GCC 编译系列:静态库工具 AR 详解
  • GitHub Copilot Pro 使用指南与模型配额解析
  • CSP 信奥赛 C++ 摩尔投票算法详解
  • SpringBoot 集成 RabbitMQ 常见消息模式示例
  • Android DL 插件化开发步骤与核心注意事项
  • 2026 年求职指南:纯 LLM、多模态大模型与 AIGC 赛道对比
  • C++ 高精度时间库 chrono 详解
  • AI 中的 Skills 详解:核心机制与应用场景
  • Web 前端基础:HTML 核心语法与常用标签
  • 网络安全从业人员必备认证证书指南
  • 进程概念详解:命令行参数、环境变量与地址空间
  • 万方 AIGC 检测未通过?多款降 AI 工具实测效果分析

相关免费在线工具

  • 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