摘要：情人節(jié)，項目開放了核心源碼倉庫，并更新了下的諸多核心成果，這意味著，已然度過了最困難的難點(diǎn)攻關(guān)期，進(jìn)入到了全民公測階段。年月日，開源了核心源碼庫，開啟全民公測階段。

2019.2.14 情人節(jié)，F(xiàn)ilecoin項目開放了核心源碼倉庫go-filecoin，并更新了 filecoin-project organization下的諸多核心成果，這意味著，F(xiàn)ilecoin已然度過了最困難的難點(diǎn)攻關(guān)期，進(jìn)入到了全民公測階段。

本系列文章將協(xié)助大家對源碼倉庫進(jìn)行全解析，幫助大家系統(tǒng)地學(xué)習(xí)和了解Filecoin這個項目，發(fā)現(xiàn)新的機(jī)遇和商機(jī)，小編將在這段時間密切關(guān)注Filecoin動態(tài)，和大家一起度過Filecoin全民公測階段。

前言

Filecoin里程碑

第一章：搭建Filecoin測試節(jié)點(diǎn)

第二章：如何創(chuàng)建錢包，獲取FIL Mock代幣

第三章：存儲提供方（礦工）的配置操作

第四章：存儲需求方的配置操作

第五章：如何讓自己的節(jié)點(diǎn)加入測試網(wǎng)絡(luò)

第六章：如何組建多節(jié)點(diǎn)礦工集群（"礦池"）

第七章：如何參與復(fù)制證明游戲測試

第八章：Filecoin Organization介紹

More

（萬事開頭難，一起追溯和回顧一下Filecoin的革命歷程）

2015年7月15日，F(xiàn)ilecoin發(fā)布了第一版白皮書：

《Filecoin: A Cryptocurrency Operated File Storage Network》

2016年，Juan Benet首次對外發(fā)布Filecoin主題演講，向大眾宣告：IPFS準(zhǔn)備添加一個名為Filecoin，基于區(qū)塊鏈的貨幣層，以激勵I(lǐng)PFS網(wǎng)絡(luò)上的數(shù)據(jù)存儲。

2017年7月19號，F(xiàn)ilecoin發(fā)布了第二版白皮書：《Filecoin: A Decentralized Storage Network》。

2017年8月-9月，F(xiàn)ilecoin發(fā)布了SAFT協(xié)議，開始在Coinlist上發(fā)起眾籌，吸引來自50個國家的2100+投資人參與，成功募集2.57億美金，并承諾于2022年之前完成此項目。

2018年8月，F(xiàn)ilecoin在Lab Day技術(shù)日，發(fā)布了Demo和測試網(wǎng)絡(luò)模擬器演示，并向大眾開放Github之上的filecoin-project organization。

2019年2月14日，filecoin-project organization開源了核心源碼庫：go-filecoin，開啟全民公測階段。

未來，更多期待...

本章我們將一步一步，嘗試在自己的macOS和Linux服務(wù)器上搭建Filecoin測試節(jié)點(diǎn)，小編的實(shí)戰(zhàn)操作系統(tǒng)環(huán)境如下：

Darwin daijialedeMBP.lan 17.4.0 Darwin Kernel Version 17.4.0: Sun Dec 17 09:19:54 PST 2017; root:xnu-4570.41.2~1/RELEASE_X86_64 x86_64

在安裝和配置go-filecoin的測試節(jié)點(diǎn)之前，需要做的準(zhǔn)備工作比較繁多，相對復(fù)雜，因為小編機(jī)器采用的是macOS，將使用homebrew包管理器來安裝語言環(huán)境。

為啥安裝就不解釋了...

# 需要安裝大于v1.11.2版本的golang

brew install go

go version 

go1.11.2 darwin/amd64

設(shè)置GOPATH，由于小編采用的是zsh，而非macOS自帶的bash，所以環(huán)境變量設(shè)置在.zshrc中：

vim ~/.zshrc

編輯.zshrc，添加如下圖所示內(nèi)容：

記得重啟終端，新的環(huán)境變量GOPATH才會生效

Filecoin的復(fù)制證明工程實(shí)現(xiàn)，基本都是使用rust編寫的，為此，我們需要安裝rust環(huán)境：

# 需要安裝大于v1.31.0版本的rust/Cargo

brew install rustc

rustc -V
rustc 1.32.0

cargo -V
cargo 1.32.0

處理編譯go-filecoin產(chǎn)生的linker flags

brew install pkg-config

這里，將介紹兩種release安裝包的獲得方式，一種是通過源碼進(jìn)行自編譯，另一種是下載官方發(fā)布的release安裝包，兩種方式各有利弊，小編都實(shí)測了一下。

可以重構(gòu)go-filecoin相關(guān)源碼，定制自己專屬的go-filecoin binary release包，方便大伙們來炫技、PR、以及裝B。

好處：可自定義的源碼編譯環(huán)節(jié)。

壞處：編譯準(zhǔn)備環(huán)節(jié)比較復(fù)雜，需要較強(qiáng)的Debug和運(yùn)維能力，同時編譯耗時長，對機(jī)器CPU性能要求更高。

mkdir -p ${GOPATH}/src/github.com/filecoin-project

git clone [email protected]:filecoin-project/go-filecoin.git ${GOPATH}/src/github.com/filecoin-project/go-filecoin

熟悉go語言的朋友肯定不會陌生，源碼路徑習(xí)慣統(tǒng)一維護(hù)在${GOPATH}的src下，協(xié)議實(shí)驗室也是提倡大家遵守這樣的開發(fā)規(guī)范。

go-filecoin在構(gòu)建時需要引用到cgo-compatible rust-proofs library 證明依賴，因此需要c編譯器支持，比較常見的c編譯器工具有：gcc/clang，下面分別介紹兩個工具的配置：

Clang

macOS用戶如果安裝過xcode，默認(rèn)應(yīng)該是高版本的clang配置，小編機(jī)器的Clang配置如下：

如圖所示，Clang-902.0.39.1版本，是符合接下來的編譯需求的。

gcc

gcc需要v7.4.0的高版本支持，以及指定特殊系統(tǒng)變量$CC

brew install gcc-7

export CC=gcc-7

gx需要多帶帶介紹一下，這是一個很有意思的golang包管理工具，其管理的所有依賴庫都存儲于IPFS網(wǎng)絡(luò)之中，由協(xié)議實(shí)驗室的核心工程師whyrusleeping所創(chuàng)造，并靈活運(yùn)用于協(xié)議實(shí)驗室的各個代碼庫之中，而go-filecoin的依賴安裝也離不開gx：

go get -u github.com/whyrusleeping/gx

gx version

設(shè)置了GOPATH，gx是能被識別為全局環(huán)境變量的，否則無法進(jìn)行后續(xù)依賴安裝。

cd ${GOPATH}/src/github.com/filecoin-project/go-filecoin

FILECOIN_USE_PRECOMPILED_RUST_PROOFS=true go run ./build/*.go deps

提示：此過程比較漫長，小編機(jī)器跑了44分鐘多，且CPU過熱導(dǎo)致風(fēng)扇不停，大家可以看一下自己機(jī)器的情況....

洗了個澡、泡了杯茶，刷了會抖音...

45分鐘過去了：

嗯...終于看到了安裝并編譯好的半成品...

別急，release成品就快了：

# 構(gòu)建release包
go run ./build/*.go build

# 安裝go-filecoin至${GOPATH}/bin目錄下
go run ./build/*.go install

# 單元測試
go run ./build/*.go test

如上圖所示，可以在https://github.com/filecoin-project/go-filecoin/releases中直接下載官方于2019年2月11日發(fā)布的0.0.1版本，將安裝包解壓至{$gopath}/bin目錄下。

好處：繞過了復(fù)雜和漫長的源碼編譯環(huán)節(jié)。

壞處：由于官方代碼倉庫在頻繁更新，無法獲取最新的代碼包，實(shí)時性滯后。

PS：好奇官方為啥不配置個自動化持續(xù)集成...我也是無語了

經(jīng)過1.2節(jié)操作后，全局運(yùn)行go-filecoin -help，出現(xiàn)如下圖菜單欄，說明節(jié)點(diǎn)已經(jīng)成功安裝。

測試網(wǎng)絡(luò)有多種類型：

devnet-user 針對普通用戶

devnet-nightly 針對開發(fā)者用戶

我們在初始化的時候，可以按照需求，指定flag：

go-filecoin init --devnet-user --genesisfile=http://user.kittyhawk.wtf:8020/genesis.car

如下圖所示，完成初始化操作后，即可正式啟動并運(yùn)行我們的Filecoin測試節(jié)點(diǎn)了：

go-filecoin daemon

Filecoin發(fā)現(xiàn)節(jié)點(diǎn)的過程是遵循著gossip協(xié)議，逐漸向外發(fā)散，我們可以通過go-filecoin swarm peers 來查看所連接對等方的信息和過程。

PS: 存在一些網(wǎng)絡(luò)連接的錯誤日志，看來NAT的問題依然存在，測試網(wǎng)并未在libp2p上針對多層NAT進(jìn)行方案解決升級。

與IPFS不一樣，F(xiàn)ilecoin考慮到了以Qm..開頭的冗長NodeID并不好記憶，這里加了一些比較人性化的設(shè)計，即，可以為自己的節(jié)點(diǎn)創(chuàng)建專屬昵稱（nickname），不過僅限字符串：

#設(shè)置
go-filecoin config heartbeat.nickname "jialesoho"

#核對
go-filecoin config heartbeat.nickname

設(shè)置節(jié)點(diǎn)心跳配置，與Filecoin網(wǎng)絡(luò)監(jiān)控建立連接：

go-filecoin config heartbeat.beatTarget "/dns4/stats-infra.kittyhawk.wtf/tcp/8080/ipfs/QmUWmZnpZb6xFryNDeNU7KcJ1Af5oHy7fB9npU67sseEjR"

如下圖所示，登錄可視化控制臺，https://stats.kittyhawk.wtf/，可查看Filecoin測試網(wǎng)（devnet）狀態(tài)以及個人節(jié)點(diǎn)信息：

如圖所示，剛剛我們自定義命名的Filecoin節(jié)點(diǎn)——jialesoho，已經(jīng)被點(diǎn)亮在Filecoin的全網(wǎng)可視化監(jiān)控面板中，除此之外，可視化控制臺還有許多全網(wǎng)的交易數(shù)據(jù)，吞吐量，區(qū)塊信息可供我們查閱和分析...

至此，我們應(yīng)該可以通過《【Filecoin源碼倉庫全解析】第一章：搭建Filecoin測試節(jié)點(diǎn)》的學(xué)習(xí)，順利搭建并測試自己的Filecoin節(jié)點(diǎn)了，期望幫正在電腦前研究Filecoin源碼倉庫的你，少走彎路！

下一章，我們將介紹《【Filecoin源碼倉庫全解析】第二章：如何創(chuàng)建個人錢包，獲取FIL Mock代幣》

go-filecoin | github

本系列文章預(yù)計10+篇，歡迎感興趣的朋友參與，同時將開放贊助渠道，你們的贊助和打賞是支持我業(yè)余時間持續(xù)寫作的動力，我也將盡自己所能，最大化地為閱讀者和相關(guān)創(chuàng)業(yè)公司品牌帶來幫助和權(quán)益， 具體如下：

文尾品牌Logo展示

一條品牌的推薦語

公眾號文章轉(zhuǎn)載權(quán)限

為平衡用戶體驗，每篇僅限1家

個人知乎、公眾號、簡書、頭條號等多渠道投放

私信我即可，聯(lián)系方式已在上方聯(lián)系讀者處給出。

星鑒網(wǎng) 是一家專注于IPFS生態(tài)的垂直媒體，集信息傳播，技術(shù)推廣，應(yīng)用孵化于一身；感謝星鑒網(wǎng)（ipfsfirst.com）對嘉樂SOHO原創(chuàng)內(nèi)容的支持。

深夜寫作，不免有不足之處，歡迎指正和更多討論，可私信微信公眾號：jialesoho，或者加我微信：daijiale6239，如果覺得對您有幫助，可以幫點(diǎn)擊好看推廣和打賞支持噢，感激不盡！