# 安装 TOPIO
您可按照以下步骤，下载安装 TOPIO：
# 1. 配置服务器
配置一台用于运行 TOPIO 的服务器。建议您租用云服务器，然后在您个人计算机上通过 SSH 终端远程访问。
# 操作系统要求
| 操作系统 | 版本 |
|---|---|
| Linux | CentOS 7，64 位，内核 3.10 及以上版本（含 CentOS 8） |
| Ubuntu 16.04，64 位，内核 4.4 及以上版本 |
# 服务器最低配置
不同的类型矿工对服务器的配置要求不同，最低配置请参见下表。
| 矿工类型 | 最低硬件配置 |
|---|---|
| 边缘矿工（edge） | 1CPU/1GB mem 40GB SSD 100Mb/s |
| 验证矿工（validator） | 2CPU/2GB mem 60GB SSD 100Mb/s |
| 高级矿工（advance） | 2CPU/4GB mem 100GB SSD 200Mb/s |
# 配置流入端口
对以下端口流入公网放行，否则节点将无法加入 TOP Network 网络：
TCP：19081、19082、19085、8080
UDP：9000、9001
# 安装"wget"下载工具
连接服务器，在 SSH 终端页面执行以下命令安装"wget"下载工具。
CentOS 和 Ubuntu 安装命令分别如下，根据您的服务器操作系统使用相应的命令。
- CentOS
sudo yum install wget -y
- Ubuntu
sudo apt install wget -y
# 2. 下载并安装 TOPIO
执行以下命令下载并安装 TOPIO。
root 用户可直接执行以下命令，而非 root 用户需要管理员权限才可执行，您可 点击此处 查看如何对 非 root 用户添加管理员权限。
wget https://github.com/telosprotocol/TOP-chain/releases/download/v1.14.0/topio-1.14.0-release.tar.gz -O topio-1.14.0-release.tar.gz && tar zxvf topio-1.14.0-release.tar.gz && cd topio-1.14.0-release && sudo bash install.sh && source /etc/profile && bash set_topio.sh && source ~/.bashrc && ulimit -n 65535
# 验证安装结果
验证安装是否成功。
# 安装成功
当安装页面打印以下信息时：
install topio done
now run command to check md5: topio -v
now run command for help info: topio -h
执行 topio -v 验证 TOPIO 是否安装成功，如果输出以下信息，证明安装成功。
topio version: 1.14.0
git commit info: d42d833c2
git submodule: xbase:4b3b8a4|xdepends/GSL:8e6d4e2|xdepends/boringssl:10fef972e|xdepends/googletest:ec44c6c1|xdepends/gperftools:bf8b714|xdepends/jemalloc:46c0af68|xdepends/libevent:5df3037d|xdepends/xquic:53a8708|
build date: Nov 17 2023 14:35:36
build options: release
MD5:47491e1e1e7d65b5335699b0ffda1121
注意
如 MD5 码与官网展示的对应安装包 MD5 码不一致，您虽然安装成功，但是安装文件存在被篡改的可能性！
# 安装失败
在任一目录下执行 topio -v 验证安装是否成功，如果输出以下信息，证明安装失败。
-bash: topio: 未找到命令
以上示例基于支持中文的 Linux 操作系统。
如安装失败，请重新执行安装命令。
# 下载数据库（推荐）
对于新服务器，推荐您在安装 TOPIO 后下载数据库，这样可以减少数据同步时间，尽早开始产生收益。
对于高级矿工，则必须下载数据库。
在 SSH 终端中运行以下命令：
topio db download https://nyc3.digitaloceanspaces.com/top-mainnet-space/db_20220906_adv_5391f0d4430ed1e7c5b2505cfb5e2e0a.tar.gz
在返回信息中，如果下载进度为 100%，且包含以下内容，则证明数据库下载成功：
download database ok.
md5sum check ok.
# 3. 配置环境变量（可选）
TOPIO 安装完成后，您可以执行以下命令配置环境变量，将以下命令中的 /opt/topnetwork 设置成您的权限目录。
echo "export TOPIO_HOME=/opt/topnetwork" >> ~/.bashrc && source ~/.bashrc
如不配置环境变量，您将使用系统默认目录作为 TOPIO 的工作目录：
root 用户，默认目录为
/root/topnetwork。非 root 用户，默认目录为
/home/user/topnetwork，其中user是您登录服务器的用户名。