Ubuntu下运行Swarm Bee节点
1. 安装
基本安装步骤比较简单，可以直接[Swarm Bee参考官方文档](Quick Start | Swarm Bee Client (ethswarm.org))。
1.1 Bee Clef安装
在安装Bee之前，建议首先[安装Bee Clef软件包](Clef External Signer | Swarm Bee Client (ethswarm.org))。[Clef](go-ethereum/cmd/clef at master · ethereum/go-ethereum (github.com))是Go以太坊客户端使用的独立签名器（单独的一个对以太坊交易进行签名认证的服务），能够管理基于key-file的账户和硬钱包账户。[Bee-Clef](ethersphere/bee-clef: bee-clef is official ethereum clef binary wrapped and preconfigured for bee as a service (github.com))则在clef基础上针对bee做了定制化配置。Bee节点可以通过bee-clef来访问Swarm测试网或以太坊主网。当然，你也可以直接在本地运行原生的[clef](go-ethereum/cmd/clef at master · ethereum/go-ethereum (github.com))，然后增加自己的配置在运行Bee。如果确定要使用Bee-clef，必须在Bee之前先安装Bee Clef。
选择最新版本
- 打开[Bee-clef下载页面](Releases · ethersphere/bee-clef (github.com))，查看最新版本。写当前文档时的最新版本为v0.4.12。
安装Bee-Clef
下载Bee-clef
1
2wget https://github.com/ethersphere/bee-clef/releases/download/v0.4.12/bee-clef_0.4.12_arm64.deb
sudo dpkg -i bee-clef_0.4.12_arm64.deb
配置Bee-clef
安装以后的默认配置文件在/etc/bee-clef目录下，包含4byte.json和rules.s两个文件，已经针对Bee做了基本配置，这里不需要特别修改。
1 | ll /etc/bee-clef/ |
启动Bee-Clef
在使用后台启动之前，建议先通过手工启动查看bee-clef是否正确安装。正常启动后会有一下的日志打印，其中会出现三个文件路径
/etc/bee-clef/4byte.json4byte数据库文件，包含了默认的Bee需要的一些方法。
/etc/bee-clef/rules.js签名器规则文件，定义了最基本的签名规则。比如一般来说，我们的很多交易或操作需要用户手工确认才能进行。但是也有一些操作，可以在不提示用户的情况下直接允许，比如规则文件里提到的启动、列出账户等。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15function OnSignerStartup() {
return "Approve"
}
function OnApprovedTx() {
return "Approve"
}
function ApproveListing() {
return "Approve"
}
function ApproveTx() {
return "Approve"
}
function ApproveSignData() {
return "Approve"
}/var/lib/bee-clef/clef.ipc这个是bee-clef签名器与Bee节点之间进行通信的IPC通信管道，bee的所有请求都是通过这个管道发送到bee-clef。在接下来Bee的配置文件中也会用到。
bee-clef正常启动后，一旦
bee节点开始跟bee-clef交互，日志中每隔几秒或几分钟就会打印INFO [05-11|23:41:53.365] Op approved.
1 | bee-clef-service start |
Bee-Clef数据存储
bee-clef的密钥及其它数据默认存储在/var/lib/bee-clef/.
1e4b791d7af0cf7a42a8/- bee-clef账户保险库，里边的config.json文件中会保存加密过的key/value配置文件。clef.ipc- 刚才提到的IPC通信管道。keystore/- bee-clef的账户地址。bee通过这个地址接入测试网或主网。masterseed.json- 存放bee-clef密码password账户的密钥文件
1 | ll /var/lib/bee-clef/ |
1.2 Bee安装
安装完bee-clef并确保其正常启动后，我们来安装Bee。
查看最新版本
先到[Bee版本下载](Releases · ethersphere/bee (github.com))查看最新版本，当前最新版本为v0.5.3.
下载并安装Bee
1 | wget https://github.com/ethersphere/bee/releases/download/v0.5.3/bee_0.5.3_amd64.deb |
配置Bee
安装完毕以后默认配置文件在/etc/bee/bee.yaml。也可以运行bee printconfig &> bee-default.yaml打印当前的Bee配置作为模板来自己修改。其中几个地方需要注意。
clef配置 - 需要根据Bee-Clef的配置设置对应的IPC路径。
1
2
3
4## enable clef signer
clef-signer-enable: true
## clef signer endpoint
clef-signer-endpoint: /var/lib/bee-clef/clef.ipcdebug API地址 - 如果需要运行bee-dashboard，必须设置。默认为本机的1635端口，也可以自己修改。
1
2
3
4## debug HTTP API listen address (default ":1635")
debug-api-addr: 127.0.0.1:1635
## enable debug HTTP API
debug-api-enable: trueSwap节点 - 以太坊交换节点，也就是接入以太坊的入口节点。必须设置，默认为本机的:8545端口，如果你在本机运行geth （go的以太坊客户端）。否则，推荐使用Warm官方公共节点
https://rpc.slock.it/goerli。也可以自己到Ethereum API | IPFS API & Gateway | ETH Nodes as a Service | Infura 注册一个，使用自己注册的节点来减少拥堵。1
## enable swap (default true)swap-enable: true## swap ethereum blockchain endpoint (default "http://localhost:8545")swap-endpoint: https://rpc.slock.it/goerli
其它配置请参考配置文件 – MoDocs (lovpia.com)。
启动运行Bee
更新完配置文件以后，可以直接通过命令行启动来检测配置是否正确。第一次启动会需要输入密码，同时需要账户有至少10gBZZ作为启动资金。
领取启动资金
先通过bee-clef-keys命令获取节点的ethernum地址（在产生的bee-clef-jey-xxxx.json文件中address字段）。
- faucet-request (discord.com) - 通过faucet机器人领取，是好是坏，碰运气。
- Goerli: Authenticated Faucet (mudit.blog) 需要先在Twitter上发布条信息，然后把twitter链接粘贴到页面里领取，可以一次领取37.5gETH，然后到Bzzaar (ethswarm.org)兑换即可，成功率很高，而且可以兑换不止10个gBZZ.
运行Bee
可以直接执行bee start来启动，然后查看运行日志是否正常。如果使用自定义配置文件，就加上--config <path to bee.yaml>。
Bee正常启动以后，会默认监听:1633端口，当日志中出现api address: xxxx时，Bee已经启动。如果打开了debug api，也会在日志中看到debug api address: xxx:1633.
1 | bee start --config bee.yaml Welcome to the Swarm.... Bzzz Bzzzz Bzzzz \ / \ o ^ o / \ ( ) / ____________(%%%%%%%)____________ ( / / )%%%%%%%( \ \ ) (___/___/__/ \__\___\___) ( / /(%%%%%%%)\ \ ) (__/___/ (%%%%%%%) \___\__) /( )\ / (%%%%%) \ (%%%) ! INFO[2021-05-18T13:55:09+08:00] version: 0.5.3-acbd0e2 INFO[2021-05-18T13:55:09+08:00] using swarm network address through clef: <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx> INFO[2021-05-18T13:55:09+08:00] swarm public key <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx> INFO[2021-05-18T13:55:09+08:00] pss public key <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx> INFO[2021-05-18T13:55:09+08:00] using ethereum address <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx>INFO[2021-05-18T13:55:09+08:00] debug api address: 127.0.0.1:1635 INFO[2021-05-18T13:55:11+08:00] using default factory address for chain id 5: <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx> INFO[2021-05-18T13:55:12+08:00] using existing chequebook <xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx> INFO[2021-05-18T13:55:25+08:00] database capacity: 2000000 chunks (approximately 7.8GB) INFO[2021-05-18T13:55:33+08:00] name resolver: no name resolution service provided INFO[2021-05-18T13:55:33+08:00] api address: [::]:1633...# 注意：其中的xxx为你的Bee节点对应的key和地址信息. |
确保Bee可以正常启动并运行以后，就可以把Bee加入到系统服务后台运行就可以了。
查看Bee基本信息
最基本的就是在浏览器直接查看localhost:1633, 也可以在命令行用curl命令查看，如果显示Ethereum Swarm Bee就说明已经在运行了。
1 | # curl -s localhost:1633Ethereum Swarm Bee |
其它信息可以通过[bee debug api](Bee Debug API (ethswarm.org))查看。
比如自己做一个简单的bee_health_check.sh脚本，可以快速输出当前Bee节点的基本信息。
1 | !/usr/bin/env bash# get addresses of current nodeecho '====> 获取Bee节点地址...'echo '> curl -s localhost:1635/addresses'curl -s localhost:1635/addresses | jq# check connected peersecho '====> 获取已经建立连接的节点列表...'echo '> curl -s localhost:1635/peers'curl -s localhost:1635/peers | jq# check balance# echo '====> 获取账户基本信息...'# echo 'curl -s localhost:1635/balances'# curl -s localhost:1635/balances | jq# get chequebook balanceecho '====> 获取支票账户信息...'echo '> curl -s localhost:1635/chequebook/balance'curl -s localhost:1635/chequebook/balance | jqecho '====> 获取支票信息...'echo '> curl -s localhost:1635/chequebook/cheque'curl -s localhost:1635/chequebook/cheque | jq |
另外一种方式是直接使用bee-dashboard查看，就是把bee debug api获取的状态通过图形界面可视化。需要提前打开debug api，具体参考[bee-dashboard教程](ethersphere/bee-dashboard: An app which helps users to setup their Bee node and do actions like cash out cheques (github.com))。
2. 其它注意事项
问题1：could not connect to backend at xxx
1 | could not connect to backend at https://rpc.slock.it/goerli. In a swap-enabled network a working blockchain node (for goerli network in production) is required. Check your node or specify another node using --swap-endpoint. Error: get chain id: Post "https://rpc.slock.it/goerli": dial tcp 185.20.210.132:443: i/o timeout |
因为Swap节点不可用，或者节点拥堵，建议到Ethereum API | IPFS API & Gateway | ETH Nodes as a Service | Infura 注册一个自己的节点，避免官方节点拥堵。