微众联盟链 WeBASE的基本使用

本文详细介绍了如何使用官方文档中的docker一键安装WeBASE,并分享了解决过程中遇到的一些问题,包括环境配置、网络配置及登录管理系统时可能遇到的情况。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近元宇宙,NFT什么的比较火,补充一下区块链开发相关的知识,算是充电了吧。

同时测试过百度超级链和微众联盟链,可能是由于我电脑环境的问题,百度超级链那个XuperIDE一直运行不正常,暂时先不管了,先搞定微众联盟链的基本使用。

一.安装WeBASE

学习阶段建议直接使用官方文档中的docker一键安装,我是直接在VMware中的一个ubuntu 20的虚拟机上搭建的。

官方文档地址:一键Docker部署 — WeBASE v1.5.3 文档

【注意要点】

官方文档的说明已经很全了,基本上不会有大的问题,但是有一些细节还是要注意一下

1.数据库

虽然区块链相关操作本质上是不需要数据库的,但是我们安装的这个不仅包含了FISCO-BCOS节点,还包含WeBASE这个区块链管理系统,方便查看节点的运行情况和执行一些基本操作,这个系统是需要数据库的,后期熟悉以后应该可以不使用该系统,基于该区块链开发应用,只启动链节点就可以,那样也就不需要启动数据库了,修改配置文件可以支持连接外部数据库或者在docker中启动一个。

2.环境配置

这一套系统全部运行起来还是比较消耗服务器资源的,如果访问WeBASE管理页面出现各种请求异常,可以查看一下运行的服务器或者虚拟机资源消耗,主要是硬盘空间和内存占用会比较高,建议硬盘20GB,内存4GB以上的配置运行该系统。

3.网络配置

如果是在虚拟机上安装,一定要先确定虚拟机能够连接外网,而且本机也能通过IP地址访问虚拟机。

4.Docker-Compose安装

该文档中介绍的Docker-Compose安装命令,使用的是1.29.2版本,我一直无法正常下载,提示无法连接,把版本号换成最新版的v2.2.3就可以正常下载了,有同样问题的兄弟可以试一下。

二.访问WeBASE管理系统

当按照文档完整安装,全部组件成功运行以后(一键Docker部署 — WeBASE v1.5.3 文档),使用docker ps命令应该显示以下容器正在运行

打开浏览器,输入该服务器IP:5000,就可以访问管理系统登录页面

 默认登录账号:admin 

 初始密码:Abcd1234

第一次登录会要求指定一个监听链节点,如果安装部署文档的默认配置,只需要输入127.0.0.1 和5002端口就能正常连接刚刚部署的节点。

 到这里WeBASE整个系统就算完全部署运行成功了,接下来就可以尝试基于这个平台做一些智能合约的开发了

【注意要点】

1.登录WeBASE管理系统,验证码刷新不了

刚刚启动整个系统后,访问WeBASE登录页面,会发现验证码刷不出来,也就无法登录,这时候只需要等一下,大概2-3分钟吧,再刷新就出来了,目前还不清楚是什么原因导致的,可能是启动比较慢吧。

<think>好的,用户现在的问题是如何让WeBASE使用已有的FISCO链。之前用户提到在application文件里找不到链的信息,现在可能已经解决了配置的问题,或者需要更进一步的指导。 首先,我需要确认用户是否已经正确配置了application.yml中的chain和group信息。之前的问题是关于找不到链的信息,所以可能用户已经检查了配置文件的位置和内容,现在需要将已有的FISCO链整合到WeBASE中。 接下来,用户的需求是让WeBASE使用已有的FISCO链,而不是新建一个链。这可能涉及到几个关键步骤:检查节点配置、配置WeBASE的application.yml文件、同步数据、以及验证是否成功。 我需要考虑用户可能的操作步骤是否正确。例如,用户是否确认了FISCO节点的网络可达性,是否正确填写了节点的IP和端口,特别是channelPort和frontPort是否正确。这些端口在FISCO节点的config.ini中有配置,用户需要确保这些端口开放且没有被防火墙拦截。 另外,用户可能没有正确配置群组ID和链ID,导致WeBASE无法连接到已有的链。需要强调chain.id和group.id必须与FISCO链中的配置完全一致,否则无法识别。 还要考虑用户是否重启了WeBASE服务,因为修改配置文件后必须重启才能生效。此外,日志的检查也很重要,用户需要查看日志确认是否有错误信息,比如连接失败或者配置错误。 可能用户遇到的常见问题包括:配置文件路径错误、配置项被注释、缩进错误、节点信息填写不正确、端口未开放、版本不兼容等。需要逐一排除这些可能性。 最后,需要给出清晰的步骤,包括验证步骤和常见问题解决方法,帮助用户一步步完成配置。同时提醒用户参考官方文档,确保版本兼容性,特别是在使用较新或较旧版本时可能需要调整配置格式。</think>--- ### **配置WeBASE使用已有FISCO-BCOS链的完整流程** --- ### **一、前提条件** 1. **确认FISCO-BCOS链状态** - 链已正常启动,节点间可通信 - 检查节点的`config.ini`配置: ```ini [rpc] channel_listen_port=20200 # channel_port,用于WeBASE连接 jsonrpc_listen_port=8545 # front_port(若使用WeBASE-Front) ``` - 确保防火墙开放`channel_port`(默认20200)和`front_port`(默认5003) 2. **获取链基础信息** - **链ID(chainId)**:通过控制台执行`getNodeVersion`查看 ```bash [group:1]> getNodeVersion Node Version: 3.0.0 Chain ID: 1 # ← 链ID ``` - **群组ID(groupId)**:通过`cat nodes/127.0.0.1/node0/conf/group.1.genesis`查看 --- ### **二、WeBASE-Front配置步骤** #### **1. 修改`application.yml`** ```yaml # 文件路径:webase-front/conf/application.yml chain: id: 1 # 必须与FISCO链的chainId一致 group: id: 1 # 必须与FISCO链的群组ID一致 nodes: - nodeId: 1 # 节点标识(自定义唯一ID) ip: 192.168.1.100 # FISCO节点IP channelPort: 20200 # FISCO节点的channel_port frontPort: 5003 # FISCO节点的front_port ``` #### **2. 关键配置项说明** | 配置项 | 示例值 | 来源验证方法 | |-----------------|-------------|--------------------------------------| | `chain.id` | 1 | FISCO控制台执行`getNodeVersion` | | `group.id` | 1 | FISCO节点的`group.[id].genesis`文件 | | `nodes.ip` | 192.168.1.100 | FISCO节点服务器的实际IP | | `channelPort` | 20200 | FISCO节点`config.ini`中的`channel_listen_port` | | `frontPort` | 5003 | FISCO节点`config.ini`中的`jsonrpc_listen_port` | --- ### **三、WeBASE-Node-Manager配置(可选)** 若需管理多链或多群组,需同步修改Node-Manager配置: ```yaml # 文件路径:webase-node-mgr/conf/application.yml groupData: syncInterval: 30000 # 数据同步间隔(毫秒) chain: enableExternal: true # 启用外部链 ``` --- ### **四、重启服务并验证** #### **1. 重启服务** ```bash # 重启WeBASE-Front cd /data/app/webase-front && bash stop.sh && bash start.sh # 重启WeBASE-Node-Manager(如配置) cd /data/app/webase-node-mgr && bash stop.sh && bash start.sh ``` #### **2. 验证连接状态** - **查看日志**: ```bash tail -f webase-front/log/Webase-Front.log ``` 出现以下日志表示成功: ``` [INFO] Node 192.168.1.100:20200 connected [INFO] Load chainId=1, groupId=1 ``` - **API验证**: ```bash curl http://localhost:5003/WeBASE-Front/1/web3/blockNumber ``` 正常响应示例: ```json {"code":0,"message":"success","data":12345} ``` --- ### **五、常见问题与解决** | 问题现象 | 解决方案 | |------------------------------|--------------------------------------------------------------------------| | **连接超时** | 检查防火墙规则,确认`telnet 192.168.1.100 20200`是否通 | | **返回`group not exist`** | 检查`group.id`是否与FISCO链的群组ID一致 | | **日志报`invalid chainId`** | 确认`chain.id`与FISCO链的`chainId`一致(需**完全匹配**,包括大小写) | | **节点数据未同步** | 在WeBASE管理页面手动触发数据同步,或检查`groupData.syncInterval`配置 | --- ### **六、高级配置(多节点/多群组)** 若需连接多个节点或群组,扩展`nodes`配置: ```yaml nodes: - nodeId: 1 ip: 192.168.1.100 channelPort: 20200 frontPort: 5003 - nodeId: 2 # 新增节点 ip: 192.168.1.101 channelPort: 20200 frontPort: 5003 ``` --- ### **七、注意事项** 1. **版本兼容性** - WeBASE v1.5.3+ 支持 FISCO-BCOS 3.x - WeBASE v1.4.x 仅支持 FISCO-BCOS 2.x 2. **数据一致性** - 首次接入已有链时,需等待区块同步完成(通过`getBlockNumber`确认) 3. **密钥对匹配** - 若链上已有合约,需将私钥文件(如`0x...`) 导入WeBASE的`conf/accounts`目录 --- 通过以上步骤,可确保WeBASE正确接入已有FISCO-BCOS链。若仍遇到问题,建议提供`application.yml`配置片段及节点日志进行深度排查。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值