您的位置: 首页  >  文章  >  如何搭建Filecoin测试网挖矿节点 | 开发者专区系列01

如何搭建Filecoin测试网挖矿节点 | 开发者专区系列01

分类: 文章 • 2025-05-08 22:00:16

此前，Filecoin开发团队公布了Filecoin开发者测试网源码，意味着专业开发者可以基于源码，参与测试网挖矿。

星际鑫航开发团队经过亲自编译、测试，将整个测试网挖矿节点搭建过程跑通。已经在测试网搭建名称为“xjxhHongKong”、“wwwXJXHio”、“xjxhNick“、“xjxhRock“、在内的的多个节点。

由于项目测试网源码仍不够完善，搭建过程多次入坑，为方便大家其他开发者少走弯路，星际鑫航开发团队推出此搭建教程，介绍如何在计算机上安装和运行 Filecoin 节点。

后续教程也将介绍如何使用您的节点进行 Filecoin 挖矿或存储数据。

搭建节点整个过程分为以下几个步骤：

1、安装 Filecoin
2、运行 Filecoin 守护进程
3、给你的节点命名
4、**节点，加入网络统计
5、获取 Filecoin 测试代币
6、创建矿工，开始挖矿

安装 Filecoin
Filecoin 目前有两种安装方式，一种是直接下载编译好的可执行文件，另一种是通过编译源码安装。

下载可执行文件
官网有直接编译好的 release 版本 v0.0.1 下载地址为: https://github.com/filecoin-project/go-filecoin/releases

不过遗憾的是，官方编译的0.0.1(写本文时的最新版本)无法正常运行(本人是用 linux 测试)。我自己手动编译了一个版本，基于 commit94b2894473e57c44d60164f89f417694ea3911db。 下载地址为: 百度云盘（如有需要，可后台私聊获取）

手动编译
手动编译需要比较长的时间(本人花了大概一个半小时)，根据网络的而定。

安装依赖：go-filecoin 的编译依赖 Go 语言，Rust, cargo, jq 所以在编译之前需要先安装这些依赖.

第一步你需要搭建 Go 语言编译环境
去 Go 官网下载二进制安装包， https://dl.google.com/go/go1.11.5.linux-amd64.tar.gz，然后解压：tar xvf go1.11.5.linux-amd64.tar.gz -C /usr/local/
然后配置环境变量 sudo vim /etc/profile, 在文件末尾加上

golang environment configure

export GOROOT=/usr/local/go
export GOBIN=GOROOT/binexportGOPKG=GOROOT/bin export GOPKG=GOROOT/pkg/tool/linux_amd64
export GOARCH=amd64
export GOOS=linux
export GOPATH=/golang/
PATH=PATH:PATH:GOBIN:$GOPKG

这里需要注意的是：假如你没有设置 GOBIN 环境变量，那么你需要把 $GOPATH/bin 加入 PATH 环境路径， 否则可能在待会编译的过程中出现找不到可执行文件的问题。，因为 Go 默认会把第三方工具安装在 $GOBIN 下面， 如果没有配置的话，默认会安装在 $GOPATH/bin 下面。 GOPATH 是你所有 Go 项目的根目录，保存之后重启或者执行 source /ect/profile 使配置生效。

安装 Rust, cargo, 这个非常简单，一条简单的命令就可以

sudo agt-get install curl # 如果你的操作系统已经安装了 curl 了，那么这一步可以跳过
curl https://sh.rustup.rs -sSf | sh

安装 jq, gcc(官方要求是 v7.4.0 以上，但是我用 v7.3.0 也编译成功了)
sudo apt-get install jq
sudo apt-get install gcc

下载 go-filecoin 源码并安装 Go 依赖包

由于 Filecoin 项目用来很多第三方的开发包，而这些包通常国内的网络是无法访问的，所以你得保证你的终端是能够翻墙的。

不知道配置终端翻墙的同学请移步 linux 配置终端代理

# 创建项目目录
mkdir -p ${GOPATH}/src/github.com/filecoin-project
# clone 代码
git clone https://github.com/filecoin-project/go-filecoin.git ${GOPATH}/src/github.com/filecoin-project/go-filecoin
cd ${GOPATH}/src/github.com/filecoin-project/go-filecoin
# 切换到测试网络分之
git checkout devnet-user
# 下载并安装 Go 依赖包
FILECOIN_USE_PRECOMPILED_RUST_PROOFS=true go run ./build/*.go deps

第一次执行这个脚本的时间会比较长，因为需要生成一个 1.6GB 的参数文件，文件路径为 /tmp/filecoin-proof-parameters。该参数文件主要用于生成复制证明。

开始编译构建，运行测试和安装

# 首先编译成二进制文件
go run ./build/*.go build

# 安装 go-filecoin 到 ${GOPATH}/bin (在测试之前必须先安装)
go run ./build/*.go install

# 然后运行测试程序.
go run ./build/*.go test

# 当然你也可以编译跟测试一起用一条命名运行
go run ./build/*.go best

还有一些其他便捷的构建命令：

# 检查代码的格式的正确性
go run ./build/.go lint
# 使用覆盖率报告进行测试
go run ./build/.go test -cover
# 使用Go的竞争条件检测和警告进行测试（请参阅https://blog.golang.org/race-detector）
go run ./build/*.go test -race

# Deps，Lint，Build，Test 所有命名打包执行
go run ./build/*.go all

执行完 go run ./build/*.go install ，说明已经完成安装。

如果你已经安装了 Filecoin, 只是想更新的话，那就非常简单了：

cd $GOPATH/src/github.com/filecoin-project/go-filecoin
git fetch origin devnet-user -f
git checkout devnet-user
FILECOIN_USE_PRECOMPILED_RUST_PROOFS=true go run ./build/.go deps
go run ./build/.go build
go run ./build/*.go install

本人亲测，更新的时间需要15-20分钟左右。因为更新的时候虽说不需要下载依赖, 也不需要生成 filecoin-proof-parameters 文件，但是它还是需要去检查一下每个依赖包是否有更新，加上“科学上网”的网速实在不算快，所以这个过程没有自己想象的那么短。

开始运行 Filecoin
1.如果你之前有运行过 go-filecoin，那你需要先删除现有 Filecoin 初始化数据：
rm -f ~/.filecoin

2.初始化 Filecoin, 使用 –devnet-user 参数连接到测试主网，–genesisfile 指定获取初始化数据的地址go-filecoin init --devnet-user --genesisfile=http://user.kittyhawk.wtf:8020/genesis.car

3.启动 go-filecoin 守护进程go-filecoin daemon

运行之后当前终端是阻塞的，你不能在运行其他命令，你可以使用 Ctrl + C 命令结束进程。当然你可以可以选择在后台运行 Filecoin：go-filecoin daemon > filecoin.log &

然后你可以使用 tail 命令去输出实时日志tail -f filecoin.log启动成功之后应该会返回类似 “My peer ID is {peerID}”, 其中 {peerID} 是以 “Qm” 开头的长 CID 字符串.

注意：第一次启动守护进程的时候可能会慢，filecoin 节点需要于 /tmp/filecoin-proof-parameters 参数文件进行校验。这个文件就是我们在执行 deps 的时候 生成的，如果这些文件丢失或者不下心被删除的话，下次启动 Filecoin 的时候将会被重新创建。重建将会花费接近一个小时的时间，当然，开发人员正在寻找更好的 解决方案。

另外：如果你是开发人员并且希望连接到 nightly devnet (轻节点网络) 而不是 user devnet，则必须将节点配置为使用 small sectors(小扇区)， 并使用devnet-nightly tag 进行构建。

构建并安装完成之后使用下面的命令启动守护进程：env FIL_USE_SMALL_SECTORS=true go-filecoin daemon

4.检查你的连接
go-filecoin swarm peers # 列出跟你连接的所有节点

输出结果

/ip4/104.36.201.250/tcp/6000/ipfs/QmbHGymRX9HbDXksYpZVaeqUzKBWVdsu92VkLLe4fBQ4sA
/ip4/106.39.105.178/tcp/6000/ipfs/QmZVyRnEkB4z9S9pZh1hXf2DXEARHd88ZsUJfyW873432B
/ip4/110.182.86.161/tcp/6000/ipfs/Qma3F4jxaYk7ghgx1sL32HxFn29vAQEEkSYMTXJ3nLjwHe
/ip4/111.19.129.161/tcp/6000/ipfs/QmfT6pr6pGLmPZ1GpiWoH9ryDRu9J5H8H9eWJgTsRfDAwa
/ip4/111.19.129.164/tcp/6000/ipfs/QmRLPgNBfPqJUDTGGUfYriueE5WT976oxnm1X3XTQchZAX
/ip4/111.19.129.165/tcp/6000/ipfs/QmUkH9Co3sWnUMAYRky3HH561bb23uGirw8ZpYcmqCxRqy
/ip4/111.19.129.166/tcp/6000/ipfs/QmRMFT5q5bptCiqjeeg8AGNNNhZ5VCUv2FTQEnB9A4ES44
/ip4/113.118.45.103/tcp/2288/ipfs/QmRPVM97zVGWXt5ewvSWvEnXQEKE7PA9dCCS79QVbem4ZF
/ip4/113.118.45.103/tcp/2292/ipfs/QmfGUgVv9cNs2QiAwgAgmQb6LPg8ugLZfeFTMW74LBVBUn
/ip4/113.118.45.103/tcp/2293/ipfs/QmXZbw4vcFJSZp1hRgPeoyf8zgyDsVx9y2NNfw5enD35Wt
/ip4/113.118.45.103/tcp/2297/ipfs/QmRgkfCVi8r2p16JKF3afZpEjdpQwxiMzA3vPqz66dB5Gb
/ip4/113.118.45.103/tcp/2299/ipfs/QmReHLjniggoW8kCh2qk79o1uPzpeGFShaMBpUrAf2EY1d

每一行的最后面一项是节点的 ID，你可以使用 go-filecoin ping 命令直接测试你跟某个节点的连接情况go-filecoin ping QmbHGymRX9HbDXksYpZVaeqUzKBWVdsu92VkLLe4fBQ4sA

上图显示了节点的返回，这其实与你直接用系统的 ping 命令去测试某个 IP 地址与你的通信状况类似。

至此，恭喜你，你已经成功的运行了一个 Filecoin 节点。下面是一个节点的基本结构：
节点运行之后会自动创建一个账号和一个钱包，并立刻验证并同步测试网络上已经生成的区块， 这个时候你会发现你的 CPU 正在满负荷工作(使用 top 命令查看)

给你的节点自定义名称

默认情况下，节点昵称跟节点 ID 相同，是一个 46 的长字符串，Filecoin 允许你给它配置一个人性化的可读的名字。

你打开一个新终端执行：go-filecoin config heartbeat.nickname “xjxhRock”

新名称立即生效，无需重启。你可以使用以下命令检查配置的名称：
go-filecoin config heartbeat.nickname

不过需要注意的是: 昵称只能包含字母字符（没有数字，空格或其他特殊字符）
**节点，加入网络统计。Filecoin 官方提供了一些可视化工具来让你更直观的了解 Filecoin 网络上发生的事情： 网络统计 和 区块浏览器。
如何搭建Filecoin测试网挖矿节点 | 开发者专区系列01
要在网络统计信息中查看到你的节点，你需要选择流式传输节点的日志。通过执行以下脚本实现:go-filecoin config heartbeat.beatTarget “/dns4/stats-infra.kittyhawk.wtf/tcp/8080/ipfs/QmUWmZnpZb6xFryNDeNU7KcJ1Af5oHy7fB9npU67sseEjR”

重新启动当前运行的 go-filecoin 守护进程，然后就可以在 Network Stats 观察你的节点与网络的其他节点达成共识。

获取 Filecoin 测试代币(Mock FIL)

在 Filecoin 节点可以参与市场之前，他们需要一些初始的 filecoin token (FIL)，矿工需要拿这些 FIL 去抵押，客户需要使用 FIL 发布 ask order.

在早期测试期间，您可以从 Filecoin faucet 免费获取 Mock(虚拟) FIL，我们把 faucet 称之为 “水龙头”。 使用 Mock FIL 可以对市场动态进行初步测试，而无需你付出任何的实际资金。

你可以通过以下步骤轻松获得 Mock FIL (以下所有操作请确保你的 go-filecoin 守护进程是一直运行的):

1.获取你的钱包地址go-filecoin wallet addrs ls
正常情况下应该返回你的钱包地址，如果你有多个钱包的话，会返回多个地址。钱包地址是一个 41 位的字符串。

2.拿到钱包地址之后你可以到官方提供的 http://user.kittyhawk.wtf:9797 去提交你的钱包地址，提交成功之后会返回一个 {MESSAGE_CID}，类似业务回执单编号的东西。凭证可以查到你的处理进度。
Success! Message CID:zDPWYqFD7zqaPvnfmYy2Zr6xnwXrF4QLusdbmCnBTbyFjKJFBtrz

或者你也可以通过命令行去手动提交：export WALLET_ADDR=go-filecoin wallet addrs ls # 获取钱包地址
MESSAGE_CID=curl -X POST -F "target=${WALLET_ADDR}" "http://user.kittyhawk.wtf:9797/tap" | cut -d" " -f4
echo $MESSAGE_CID=

通常情况下，系统会在 30 秒内向你的钱包转入一笔(一般为 1000 枚) FIL。
或者你也可以运行以下命令以等待确认：go-filecoin message wait ${MESSAGE_CID}

此命令在收到回复之前会一直阻塞，这里有个坑，笔者本来以为 30 秒内能收到 FIL 结果等了大半天， 原因是需要等你的 Filecoin 同步完所有区块之后你才能查询到这笔转账。

3.验证是否到账，只需要查询一下你钱包的余额.
go-filecoin wallet balance ${WALLET_ADDR}

恭喜！你现在已连接到 Filecoin 并且可以开始在 Filecoin 网络上下载或存储数据！
以上即为创建Filecoin测试网节点的过程，参照上述步骤，即可完成。

在创建节点过程，针对一些明显bug，出于程序员的执着，我们向开发团队提交了bug修复建议，并很快得到Filecoin开发团队的回复。
如何搭建Filecoin测试网挖矿节点 | 开发者专区系列01

关于Filecoin项目，星际鑫航技术团队将持续深度研究，后面将推出“如何开始挖矿的教程文章”。
欢迎大家持续关注。

参考文献

Filecoin install

Geting Started

相关推荐