> For the complete documentation index, see [llms.txt](https://loopring-org.gitbook.io/loopring-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://loopring-org.gitbook.io/loopring-doc/article/hummingbot-create-cn.md).

# Hummingbot流动性挖矿搭建教程

## 环境配置

1.一台服务器，对CPU/内存没有太多要求，海外网速快的机器下载镜像速度能快一些，但和运行无关。

2.系统可以是Linux的某个流行的发行版，如Ubuntu/CentOS都ok。

> Linux相关教程：[Ubuntu](https://www.w3cschool.cn/ubuntu17/ubuntu17-mq7k2civ.html)

3.安装docker容器，基本上这几条命令成功就可以了，不同发行版本有⼀些区别， Ubuntu 命令如下：

```
# 如果用的是国内的网络的话，在执行以上操作时建议先将下载源改为国内的下载源，下载速度会更快
sudo gedit /etc/apt/sources.list
# 将打开的文件中的文本全部删除，换上以下网站中的源：
# https://blog.csdn.net/u011483658/article/details/95012034

sudo apt upgrade
sudo apt update

# 自动安装Docker：
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

apt-cache policy docker-ce
sudo apt install docker-ce
sudo systemctl status docker
#把⾃⼰加⼊docker组，免输⼊sudo，需要重新登陆
sudo usermod -aG docker ${USER}
```

完成之后在命令行输入sudo docker --version 看是否安装成功。

```
estrella@ubuntu:~/Desktop/hummingbot$ sudo docker --version
Docker version 20.10.7, build f0df350
```

## 运行设置

安装Docker之后，离运行hummingbot就不远了。

```
#首先在Ubuntu系统上安装git
sudo apt install git
#安装完毕后检查是否安装成功
sudo git --help
#从GitHub上拉取hummingbot代码
git clone https://github.com/Loopring/hummingbot
#进入hummingbot目录
cd hummingbot
```

接下来需要做的几件事情：

1.命令行运行： docker build --pull --rm -f "Dockerfile" -t loopring:latest "." 该命令从0开始建一个包含流动性挖矿程序（即hummingbot）的Docker镜像，如果服务器网络不好 可能会慢点，基本上等着就可以了，第一次建立镜像大概30～40分钟，取决于网络，以后更新hummingbot代码，需要重新创建镜像的时候就很快了。输出大概是下面这个样子：

```
(base) hummingbot$ sudo docker build --pull --rm -f "Dockerfile" -t loopring:latest "." 
Sending build context to Docker daemon 38.53MB 
Step 1/45 : FROM ubuntu:20.04 AS builder 
20.04: Pulling from library/ubuntu 
Digest: 
sha256:31dfb10d52ce76c5ca0aa19d10b3e6424b830729e32a89a7c6eee2cda2be67a5 
Status: Image is up to date for ubuntu:20.04 
 ---> 4e2eef94cd6b
```

需要注意的是有没有错误，不过⼀般来说都没什么问题。大部分问题也都是网络问题，连不上镜像服务器，下载不下来等等，网络不好的情况下多重试几次。

成功以后的画面是这样的：

```
Step 44/45 : SHELL [ "/bin/bash", "-lc" ]
---> Running in 0d8403d98165
Removing intermediate container 0d8403d98165
---> 3711656da4b9
Step 45/45 : CMD /home/hummingbot/miniconda3/envs/$(head -1
setup/environment-linux.yml | cut -d' ' -f2)/bin/python3
bin/hummingbot_quickstart.py --auto-set-permissions $(id -nu):$(id -
ng)
---> Running in 30fcf6fc3c41
Removing intermediate container 30fcf6fc3c41
---> a2fce72efc82
Successfully built a2fce72efc82
Successfully tagged loopring:latest
```

2\. 运行 docker run -it loopring:latest bash 进入刚刚建立好的包含hummingbot的镜像的命令行模式，如下：

```
(base) ubuntu@hummingbot$ sudo docker run -it loopring:latest bash
(hummingbot) hummingbot@15ecd994fe2e:~$
```

看到 (hummingbot) hummingbot\@15ecd994fe2e:\~$ 表示已经进⼊到了镜像命令行。

3\. 在镜像命令行运行 hummingbot ：

```
(hummingbot) hummingbot@15ecd994fe2e:~$ python3 bin/hummingbot_quickstart.py
```

进入该界面即为创建成功

![](/files/-Me9BeWulQv64Bh7oaZa)

## 报错

{% hint style="danger" %}
**1.显示raw\.githubusercontent.com port 443 错误**
{% endhint %}

![](/files/-MjCtzSYzoAUn83SPTVd)

该错误原因为翻墙导致的DNS污染，解决方法为修改电脑host文件，在文件末尾添加如下代码，直接访问网站对应IP。

以下解决方式针对在Ubuntu环境下修改Ubuntu文件，其它环境请自行搜索如何修改host文件。

```
# 打开ubuntu系统下的host文件
sudo vim /etc/hosts

#在文件末尾添加如下：（不会用vim指令的请自行搜索）

185.199.108.133 raw.githubusercontent.com
185.199.108.133 user-images.githubusercontent.com
185.199.108.133 avatars2.githubusercontent.com
185.199.108.133 avatars1.githubusercontent.com

199.232.68.133 raw.githubusercontent.com
199.232.68.133 user-images.githubusercontent.com
199.232.68.133 avatars22.githubusercontent.com
199.232.68.133 avatars11.githubusercontent.com
```

后续请参照：

{% file src="/files/-Me97uBLQv0xfTcpUPV3" %}
Hummingbot流动性挖矿教程
{% endfile %}

Hummingbot 算法相关请参照[官方文档](https://docs.hummingbot.io/strategies/pure-market-making/)

> 作者：@yue