Cover photo

Quilibrium 节点搭建教程（更新2024-06-02）

post image

已经在跑的出现上面情况下载

大赌哥, [2024/7/30 星期二 14:42] 更新下release_autorun.sh就行，步骤如下:

cd ~/ceremonyclient/node 然后执行 wget -O release_autorun.sh https://raw.githubusercontent.com/a3165458/Quilibrium/main/release_autorun.sh

关于Quilibrium的介绍，请参阅项目白皮书https://quilibrium.com/quilibrium.pdf

此教程参考原英文教程https://drive.google.com/file/d/1atQ2Gb8vLzqxiS2cqRAp9ojFNDJup3TU/view ，并在此基础上结合日常运行中遇到的问题进行改进，包括 putty连接断开时使节点继续运行、节点异常终止时自动重启节点。

一、准备工作

以下是运行节点的最低配置要求：

  • 8核或更大的 AMD 或 Intel (amd64) CPU

  • 32GB内存

  • 400GB NVMe 存储

  • 50MBps 带宽

  • Ubuntu 22.04系统

1.这里参照原英文教程，推荐使用hostinger的服务器，选择美国云服务器，购买2年套餐，大概每月106.99元，1年套餐，大概每月120.99元，按月购买就要284.99元；这个价格在全网很低了。不推荐大投入，因为项目融资未知、背景未知，热度不够，但是优点就是3月15号可以Claim代币，无需等待太长时间，因此推荐玩玩，另外开通一个月服务器即可，如有需要则继续续费。

服务器购买地址→

https://hostinger.com.hk?REFERRALCODE=1368936

post image

二、登录服务器

用到SSH登陆，推荐用putty工具下载

https://putty.org

post image
post image

三、环境搭建

1、为了提升内存的效率，给自己添加swap space:（推荐内存较小的服务器使用）

sudo mkdir /swap

sudo fallocate -l 24G /swap/swapfile

sudo chmod 600 /swap/swapfile

sudo mkswap /swap/swapfile

sudo swapon /swap/swapfile

echo ‘/swap/swapfile swap swap defaults 0 0’ >> /etc/fstab

2、基础软件安装

sudo apt-get update

sudo apt -q update

sudo apt-get install jq -y

sudo apt install git -y

查看安装情况

git --version

显示 git version 2.34.1 ，安装成功

3、安装1.20.14版本的Golang

sudo rm -rf /usr/local/go;
curl https://dl.google.com/go/go1.20.14.linux-amd64.tar.gz | sudo tar -C/usr/local -zxvf - ;
cat <<'EOF' >>$HOME/.bashrc
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF
source $HOME/.bashrc

查看安装

go version

显示

安装成功
安装成功

再安装

sudo apt-get install libc6-dev

sudo apt-get install libresolv2

sudo apt-get install build-essential

sudo apt-get install g++

4、修改网络缓冲区大小

（1）vim /etc/sysctl.conf

（2）按键盘i键，进入编辑模式，并将光标移动到文档最后一行，输入以下两行信息：

net.core.rmem_max=600000000

net.core.wmem_max=600000000

（3）按键盘esc键退出编辑模式，输入:wq退出当前文档。

（4）输入sudo sysctl -p 回车

（5）输入 reboot 重启VPS主机，此时Putty连接断开，过2分钟后重新打开Putty连接VPS主机。

四、运行节点

1，下载节点文件及安装

git clone https://github.com/QuilibriumNetwork/ceremonyclient.git(被封用git clone https://source.quilibrium.com/quilibrium/ceremonyclient.git)

sudo apt-get install screen

screen -S Quilibrium 

cd ceremonyclient/node

git switch release

chmod +x release_autorun.sh

./release_autorun.sh

等待节点正常运行即可。如下图表示启动正常，此时关闭putty窗口也可以保证节点正常运行。

post image

最后按住Crtl A D 退出Screen

如果下次putty连接VPS主机想查看节点状态，可使用如下命令：

（1）（查看当前在运行的窗口名称）

screen -ls
只要是(Detached)就表示正常运行
只要是(Detached)就表示正常运行

（2）screen -r <窗口名称> （备注：将 “<窗口名称>”替换为1中查看到的名字即可，一般是 数字.node）

screen -x Quilibrium

查看完可直接关闭putty。

post image

输入ls，会看到目录下生成有一个 .config 目录

修改.config目录里的config.yml

cd /root/ceremonyclient/node

vim .config/config.yml

继续使用下键拉到最后，找到listenGrpcMultiaddr配置项并修改

listenGrpcMultiaddr: "/ip4/127.0.0.1/tcp/8337"

listenRESTMultiaddr: "/ip4/127.0.0.1/tcp/8338"

还是上面提到的vim使用方法，:wq保存退出

五、其他问题解答

（一）.如何查看$QUIL余额

putty连接VPS主机，并用screen命令新开一个窗口，避免使用节点在用的窗口。

1、输入命令：

screen -S balance

(新建一个名为 balance的窗口）

2、修改.config目录里的config.yml

cd /root/ceremonyclient/node

vim .config/config.yml

继续使用下键拉到最后，找到listenGrpcMultiaddr配置项并修改

listenGrpcMultiaddr: "/ip4/127.0.0.1/tcp/8337"

listenRESTMultiaddr: "/ip4/127.0.0.1/tcp/8338"

还是上面提到的vim使用方法，:wq保存退出

按键盘esc键，输入:wq退出。

3、依次输入一下命令开放网络端口

sudo ufw enable

sudo ufw allow 22

sudo ufw allow 8336

sudo ufw allow 8337

sudo ufw allow 8338

sudo ufw allow 8317

sudo ufw allow 8316

设置完以上命令后，还需要重启节点才可以查询，建议不要重启了，现在节点需要几天才能拿到一次奖励，保持节点稳定更好。可以在节点异常自动重启后进行查询，查询指令如下：

cd ceremonyclient/node

GOEXPERIMENT=arenas go run ./… -balance

2、查询余额时提示“item not found”？

post image

同步一段时间后重新运行节点，再次查询即可

3、提示refuse

安全端口没开，不是服务器上的，而是在服务器厂商的控制台中开放，一般默认只会开放几个常用端口

4、钱包问题

保存.config目录下的config.yml和keys.yml

这里提供一个简单的保存方式，用下面命令用于启动一个简单的 HTTP 服务器，它可以帮助你在本地快速共享文件或者浏览本地文件系统。这个命令将会在当前目录下启动一个服务器，监听 8080 端口。通过访问 http://localhost:8080 或者你的本地 IP 地址加上端口号，你就可以在浏览器中访问当前目录下的文件了。

sudo ufw allow 8080/tcp

python3 -m http.server 8080

接着在本机浏览器输入

http://改为你服务器的IP地址:8080

进入.config目录，把config.yml和keys.yml两个文件下载下来即可

post image

注意用完一定要Ctrl C关闭！

五、领取

DC群友 yanchensuoqingqiu 整合了QA:看赌哥忙不过来了，简单写了个步骤，集合一些了晚上群友遇到的问题，兄弟们参考 qu领币

1：先查peer-id 执行 source /root/.gvm/scripts/gvm gvm use go1.20.2 cd ~/ceremonyclient/node/ && GOEXPERIMENT=arenas go run ./... -peer-id

2： 去空投网站链接钱包 拿到peer-id后 去空投网站 https://quilibrium.com/rewards/

在左边输入你的peer，找到你对应的peer 链接钱包，小狐狸， okx都行 点击右边 prove 现在出现弹窗后 回到终端

3 mint代币 先加载go 1.2 执行 source /root/.gvm/scripts/gvm gvm use go1.20.2 运行网站弹窗中1、2步命令 命令如下 需要进入你安装节点路径下的ceremonyclient/client文件夹执行，根据实际情况调整

cd ~/ceremonyclient/client GOEXPERIMENT=arenas go build -o /root/go/bin/qclient main.go

不用切换文件夹，再运行 qclient cross-mint 0xXXXXX

如果提示qclient不存在，直接执行 /root/go/bin/qclient cross-mint 0xXXXXX

如果提示cross-mint不支持，说明代码不是最新 回到ceremonyclient 目录下git pull 拉取最新代码，再回到ceremonyclient/client文件夹重新构建 GOEXPERIMENT=arenas go build -o /root/go/bin/qclient main.go

一切顺利的话控制台输出一大串JSON，复制到浏览器弹窗的第三个输入框，稍等一下弹窗消息， 点击右边的claim，领取代币

老节点更新v1.4.19

删除旧的 new-origin 并重新添加：

cd ceremonyclient
git remote remove new-origin
git remote add new-origin https://source.quilibrium.com/quilibrium/ceremonyclient.git

查看新的远程仓库中的分支：确保如下图

git branch -r
post image

拉取所有远程分支

git fetch --all

出现下面需要输入github.com密码直接回车

post image

  • 查看所有远程分支：

    git branch -r

  • 如果 release-cdn 分支存在，切换到该分支：

    git checkout -b release-cdn origin/release-cdn

    重置本地分支到远程分支：

    git reset --hard origin/release-cdn

    如果 release-cdn 分支不存在

    如果确认远程仓库中不存在 release-cdn 分支，可以切换到其他存在的分支，例如 main：

    git checkout -b main origin/main

    然后重置本地分支：

    git reset --hard origin/main

    切换到 new-origin/release-cdn 分支：

    git checkout -b release-cdn new-origin/release-cdn

    最后查看你是否处理该分支上

  • git checkout release-cdn

post image

重新启动节点，启动节点处于V1.4.19

cd ~/ceremonyclient/node

screen -S Quilibrium 

./release_autorun.sh
post image

官方更新直译（特别要注意备份那一部份）

节点更新v1.4.19出来了！

!!以下是非常重要的注意事项：

-那些在Windows上运行的人，请确保您使用的是WSL，否则您将在此版本中遇到困难（许多关于在Windows上安装WSL的在线资源）。

- Quilibrium正在拿回他们的Github回购协议（耶！）但此版本最初只会在自托管的Gitlab（source.quilibrium.com）上，以避免Github再次受到此更新的打击。

-如何更新：此版本位于一个名为release-cdn的新分支上。您需要导航到节点目录并运行git checkout release-cdn，然后重新启动节点。

-此版本也是走向生锈的第一步，因此，如果您从源头构建，则需要生锈。您还需要货物、libgmp、uniffi-go、更新到go 1.22和其他一些好东西。如果这些听起来都不是设置的有趣时机，那么是时候开始使用二进制文件了。

-您可以在Windows上构建，但如果不是通过WSL，这是火的试验，如果是通过WSL，请使用二进制文件。

-如果您想查看您累积的奖励是什么，请在节点目录中的单独终端中（如果运行时没有分离的屏幕），请运行：

./Node-1.4.19-<你的os>-<你的拱门> --node-info

大多数Linux构建的示例：

./Node-1.4.19-linux-amd64 --node-info

只有x.19版本累积的奖励才会显示在这里。上周的奖励将添加到奖励页面，并将与您在2.0中.19+的奖励相结合。

-您可能会注意到，QUIL在节点上的积累很低，甚至可能无法支付您的服务器费用。耐心点。它需要一些时间来提升。节点在线的时间越长，奖励就越大。

-随着奖励对本地商店的累积，您现在需要每天备份您的.configore目录。失去这个意味着失去你的QUIL。将此备份（使用类似rsync的东西）与您的密钥和配置yml文件一起保存。

-现在这个版本的排放量约为每天1-2M，所以继续下降！