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

wget 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做了基本配置，这里不需要特别修改。

# ll /etc/bee-clef/
-rw-r--r--  1 root root  163 Feb 25 01:48 4byte.json
-rw-r--r--  1 root root  249 Feb 25 01:48 rules.js

启动Bee-Clef

在使用后台启动之前，建议先通过手工启动查看bee-clef是否正确安装。正常启动后会有一下的日志打印，其中会出现三个文件路径

/etc/bee-clef/4byte.json

4byte数据库文件，包含了默认的Bee需要的一些方法。
/etc/bee-clef/rules.js

签名器规则文件，定义了最基本的签名规则。比如一般来说，我们的很多交易或操作需要用户手工确认才能进行。但是也有一些操作，可以在不提示用户的情况下直接允许，比如规则文件里提到的启动、列出账户等。
```
function 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.

# bee-clef-service start
bee-clef-service /var/lib/bee-clef /var/lib/bee-clef/password /etc/bee-clef
Waiting for the clef.ipc file to show up at /var/lib/bee-clef/clef.ipcWARNING!Clef is an account management tool. It may, like any software, contain bugs.Please take care to
- backup your keystore files,
- verify that the keystore(s) can be opened with your password.Clef is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.
INFO [05-11|23:35:49.197] Using stdin/stdout as UI-channel
INFO [05-11|23:35:49.925] Loaded 4byte database                    embeds=146841 locals=4 local=/etc/bee-clef/4byte.json
{"jsonrpc":"2.0","id":1,"method":"ui_onInputRequired","params":[{"title":"Master Password","prompt":"Please enter the password to decrypt the master seed","isPassword":true}]}
Waiting for the clef.ipc file to show up at /var/lib/bee-clef/clef.ipc
INFO [05-11|23:35:51.134] Rule engine configured                   file=/etc/bee-clef/rules.js
INFO [05-11|23:35:51.134] Starting signer                          chainid=5 keystore=/var/lib/bee-clef/keystore light-kdf=true advanced=false
INFO [05-11|23:35:51.135] IPC endpoint opened                      url=/var/lib/bee-clef/clef.ipc
{"jsonrpc":"2.0","method":"ui_onSignerStartup","params":[{"info":{"extapi_http":"n/a","extapi_ipc":"/var/lib/bee-clef/clef.ipc","extapi_version":"6.1.0","intapi_version":"7.0.1"}}]}
INFO [05-11|23:36:12.193] Op approved
INFO [05-11|23:36:12.203] Op approved
INFO [05-11|23:41:53.365] Op approved
INFO [05-11|23:45:04.948] Op approved
INFO [05-11|23:45:08.734] Op approved

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账户的密钥文件

# ll /var/lib/bee-clef/
total 24
drwxr-x---  4 bee-clef bee-clef 4096 May 11 19:07 ./
drwxr-xr-x 50 root     root     4096 May 11 00:26 ../
drwx------  2 bee-clef bee-clef 4096 May 11 00:24 1e4b791d7af0cf7a42a8/
srw-rw----  1 root     root        0 May 11 19:07 clef.ipc=
drwx------  2 bee-clef bee-clef 4096 May 11 00:24 keystore/
-r--------  1 bee-clef bee-clef  868 May 11 00:24 masterseed.json
-rw-------  1 bee-clef bee-clef   32 May 11 00:24 password

1.2 Bee安装

安装完bee-clef并确保其正常启动后，我们来安装Bee。

查看最新版本

先到[Bee版本下载](Releases · ethersphere/bee (github.com))查看最新版本，当前最新版本为v0.5.3.

下载并安装Bee

wget https://github.com/ethersphere/bee/releases/download/v0.5.3/bee_0.5.3_amd64.deb
sudo dpkg -i bee_0.5.3_amd64.deb

配置Bee

安装完毕以后默认配置文件在/etc/bee/bee.yaml。也可以运行bee printconfig &> bee-default.yaml打印当前的Bee配置作为模板来自己修改。其中几个地方需要注意。

clef配置 - 需要根据Bee-Clef的配置设置对应的IPC路径。

## enable clef signer
clef-signer-enable: true
## clef signer endpoint
clef-signer-endpoint: /var/lib/bee-clef/clef.ipc

debug API地址 - 如果需要运行bee-dashboard，必须设置。默认为本机的1635端口，也可以自己修改。

## debug HTTP API listen address (default ":1635")
debug-api-addr: 127.0.0.1:1635
## enable debug HTTP API
debug-api-enable: true

Swap节点 - 以太坊交换节点，也就是接入以太坊的入口节点。必须设置，默认为本机的:8545端口，如果你在本机运行geth （go的以太坊客户端）。否则，推荐使用Warm官方公共节点https://rpc.slock.it/goerli。也可以自己到Ethereum API | IPFS API & Gateway | ETH Nodes as a Service | Infura 注册一个，使用自己注册的节点来减少拥堵。
```
## 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.

# 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就说明已经在运行了。

# curl -s localhost:1633Ethereum Swarm Bee

其它信息可以通过[bee debug api](Bee Debug API (ethswarm.org))查看。

比如自己做一个简单的bee_health_check.sh脚本，可以快速输出当前Bee节点的基本信息。

#!/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`

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 注册一个自己的节点，避免官方节点拥堵。