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

By [pangdong](https://paragraph.com/@pangdong) · 2024-03-02

---

![](https://storage.googleapis.com/papyrus_images/0a3e90aafd1ba926e8f42ae669bdf9ed49df3a7a30483c8940247970930b5b3c.png)

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

大赌哥, \[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](https://raw.githubusercontent.com/a3165458/Quilibrium/main/release_autorun.sh)

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

此教程参考原英文教程[https://drive.google.com/file/d/1atQ2Gb8vLzqxiS2cqRAp9ojFNDJup3TU/view](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](https://hostinger.com.hk?REFERRALCODE=1368936)

![](https://storage.googleapis.com/papyrus_images/981c9e351ba6787e6946e27e30ea5f69c2824ba3e49c94953fef11d2663ad954.png)

**二、登录服务器**
-----------

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

[https://putty.org](https://putty.org)

![](https://storage.googleapis.com/papyrus_images/0718d972751554a3f3a3894f2d958996eaee56cdaf2c08f41fd5064d5f7f203e.png)

![](https://storage.googleapis.com/papyrus_images/837833acc70cb4e4f0c949c7d685e7bcc7c58779ef0638706e10f9dc64f766e9.png)

**三、环境搭建**
----------

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
    

显示

![安装成功](https://storage.googleapis.com/papyrus_images/3b81764df0adb366a454da6516eccf2f019ccf079c072857c943b426da9e8249.png)

安装成功

再安装

    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窗口也可以保证节点正常运行。

![](https://storage.googleapis.com/papyrus_images/672b89d99c5e7a13d325597b5ae7cb10cd8e42c0a93274d5da057171adcc7413.png)

最后按住**Crtl A D** 退出Screen

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

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

    screen -ls 
    

![只要是(Detached)就表示正常运行](https://storage.googleapis.com/papyrus_images/7491ae8531631c4222b04c942b93e024c0e4f17df2e16c88e5bfd44ab0516948.png)

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

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

    screen -x Quilibrium
    

查看完可直接关闭putty。

![](https://storage.googleapis.com/papyrus_images/b1035b9fd58fbc38cce7613637c7dc039f84181acebdc36a169c49fe7f38286b.png)

输入**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”？

![](https://storage.googleapis.com/papyrus_images/437bf2d5f742720cb099ec60f000680356b7b9e369f02094290e3a53cb0cb7c5.png)

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

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**两个文件下载下来即可

![](https://storage.googleapis.com/papyrus_images/e2669245b99d567d5931b282a7cd0c592bade396c6b4ec8a9c7f9bf4760d1e58.png)

**注意用完一定要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/](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
    

![](https://storage.googleapis.com/papyrus_images/1093c7edfec2ffbeaf809a4ca8cb079ec5e27c2f41f6915633fd9751a1f3193d.png)

拉取所有远程分支

    git fetch --all
    

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

![](https://storage.googleapis.com/papyrus_images/a460aee11d3dd42413eda5cf5ac383c1525d100c1b138c8c04b9828430071110.png)

*   查看所有远程分支：
    
        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
    

![](https://storage.googleapis.com/papyrus_images/25de19831d6a1f2ff27ed377bdf0ab8f4daf863e944f1f5115e44f4324a1b71e.png)

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

    cd ~/ceremonyclient/node
    
    screen -S Quilibrium 
    
    ./release_autorun.sh
    

![](https://storage.googleapis.com/papyrus_images/c0f1a842e7bb9a152b0d5dec674047d29981593070f6f48c225c1cb61a1745a6.png)

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

    节点更新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，所以继续下降！

---

*Originally published on [pangdong](https://paragraph.com/@pangdong/quilibrium-2024-06-02)*