1. 環境準備
- 下載geth https://ethereum.github.io/go-ethereum/downloads/
- 安裝geth,為了方便全局使用
geth
命令,配置安裝目錄到系統環境變量path
, 如 D:\\Program Files\Geth
2. 開始搭建
2.1 準備創世區塊文件
每一條區塊鏈都有一個創世塊。當你第一次用geth的默認參數運行一個節點的時候,ethereum主網的創世塊就會同步到你本地的數據庫。對于私有鏈,我們通常用一個自定義的創世塊,將下面的代碼保存至D:\privatechain\genesis.json文件。
{
"config": {
"chainID": 1024,
"homesteadBlock": 0,
"eip155Block": 0,
"eip158Block": 0
},
"alloc": {},
"coinbase": "0x0000000000000000000000000000000000000000",
"difficulty": "0x0400",
"extraData": "0x00",
"gasLimit": "0x8000000",
"nonce": "0xdeadbeefdeadbeef",
"mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"timestamp": "0x00"
}
2.2 創建創世塊
下面要用上面的genesis.json創建一個創世塊。進入D:\privatechain工作空間,運行下面的命令:
geth --datadir "D:\\privatechain\\book_sharing" init genesis.json
以后就用上面的數據庫文件夾啟動節點。
2.3 啟動bootnode
2.3.1 什么是bootnode?
bootnode簡化了Ethereum客戶端實現,它只參與網絡節點發現協議,但不運行任何高級應用程序協議。它可以用作輕量級的引導節點,以幫助在私有網絡中找到對等點。
總而言之,就是一個用于節點發現或者說節點引導的輕量節點,方便聯盟鏈的搭建~
bootnode的可執行文件和geth處于同一目錄下,前面配置了系統環境變量的話就可以全局用bootnode命令了。
2.3.2 啟動bootnode
先生成一個key,生成之后下次啟動bootnode就不用再特意生成key了,直接用已有的key
bootnode --genkey=boot.key
然后指定nodekey來啟動bootnode:
bootnode --nodekey=boot.key
上面的命令運行完,會打印出類似下面的log:
INFO [03-17|13:40:29] UDP listener up self=enode://b4c360879ca11b222ac910136f3fbd3939a376b346aad1fdf1f825bd35864835f163290957b68aab95888916dcba43cafa74809a56b2373a467cc1ac562f6ff9@0.0.0.0:30301
encode后面的這么一長串東西,就是這個節點的ID信息,下面啟動geth節點的時候要指定連接這個bootnode~
2.4 啟動節點
geth --identity "richard" --rpc --rpcport "8545" --datadir book_sharing --port "30303" --bootnodes "enode://b4c360879ca11b222ac910136f3fbd3939a376b346aad1fdf1f825bd35864835f163290957b68aab95888916dcba43cafa74809a56b2373a467cc1ac562f6ff9@10.222.49.22:30301" --networkid="1024" --rpccorsdomain="*" console 2>>richard.log
注意到,我們把bootnode里面的0.0.0.0改成了bootnode所在機器的IP地址,如果其他機子要起節點的時候才能找到我們起的bootnode。
上面的命令的主體是geth console
,這個命令就啟動了一個節點并進入到它的交互模式,可以調用相應的API查看這條私鏈上的所有信息。輸入exit
命令,退出且節點就不再運行。下面嘗試解釋一下其他參數的含義,具體可以運行geth --help查看。
選項 | 解釋 |
---|---|
identity | 自定義節點的名字,方便節點中互相辨認識別 |
rpc | 啟用HTTP-RPC服務器 |
rpcport | HTTP-RPC服務器監聽端口(默認值:8545) |
datadir | 數據庫目錄 |
port | 網絡監聽端口(默認值:30303) |
bootnodes | 逗號分隔的enode url,用于P2P發現引導 |
networkid | 網絡標識符(整型, 1=Frontier, 2=Morden (棄用), 3=Ropsten, 4=Rinkeby) (默認: 1) |
rpccorsdomain | 允許跨域請求的域名列表(逗號分隔),這里的*允許所有主機連接,不建議這么寫,可以指定具體例如:http://10.222.49.22:3000, http://10.222.49.22:3001 |
2.5 加入已有私鏈(組成聯盟鏈)
如果有已知節點在跑著了,我們想加進去它所在的網絡,那該怎么辦?首先明確一點:
Connections between nodes are valid only if peers have identical protocol version and network ID. 節點間要建立有效連接,當且僅當節點間有著相同版本的協議和網絡ID。
問題來了,怎么查看節點的協議版本和網絡ID?在節點交互模式中, 輸入下面命令:
admin.nodeInfo.protocols
可以看到輸出:
{
eth: {
difficulty: 381952414,
genesis: "0xb240e0678c2a8f87cf350225b528e3d97688aad6d4d84ee84e405c7fc9e37e4e",
head: "0xaef4be11304786d60302570aa2c53bb5b5bea21b6204a6f52d9bcfb618e66811",
network: 1024
}
}
其中networkid是我們啟動節點的時候參數--networkid=1024指定的,那genesis和head怎么指定呢?答案就是:使用相同的genesis.json文件初始化區塊鏈!
所以,要想加入已有私鏈,首先拿到同樣的genesis.json創建創世塊,然后使用相同的networkid啟動節點。
當準備好相同的創世塊,就可以申請加入已有網絡啦。這里列舉兩種方式:
- 通過指定相同的bootnode:
geth --identity "richard1" --rpc --rpcport "8545" --datadir book_sharing --port "30303" --bootnodes "enode://b4c360879ca11b222ac910136f3fbd3939a376b346aad1fdf1f825bd35864835f163290957b68aab95888916dcba43cafa74809a56b2373a467cc1ac562f6ff9@10.222.49.22:30301" --networkid="1024" --rpccorsdomain="*" console 2>>richard1.log
這樣就可以和其他節點建立連接啦。起來之后,可以通過命令net.peerCount
查看已經建立連接的節點數。要查看更具體的節點連接信息,可以輸入:
admin.peers
結果:
[{
caps: ["eth/62", "eth/63"],
id: "c9c20dca4374f3605a2015dd53fbddd1ebacfb13c124870971b767a972b4970342a339818cb5affed25321261126b6936c39437df96978cb3bef3305d8d481e0",
name: "Geth/richard1/v1.7.3-stable-4bb3c89d/windows-amd64/go1.9",
network: {
localAddress: "10.222.49.22:30304",
remoteAddress: "10.222.49.22:49469"
},
protocols: {
eth: {
difficulty: 381952414,
head: "0xaef4be11304786d60302570aa2c53bb5b5bea21b6204a6f52d9bcfb618e66811",
version: 63
}
}
}]
可以看到打印出一個長度為1數組,里面是節點的具體信息。
- 手動添加節點
首先,要得到你準備要握手的節點的信息:
admin.nodeInfo.enode
結果:
enode://d2376964a9e24afec972d9b694dcf3574b171a1517b486532ee7b9e488503f46f97b6c1cc6bf55c9309ceab4fa7bb05427e7a213bb3efa43beeac5dae580ae12@0.0.0.0:30304
把0.0.0.0改成對方的真實IP,然后回到我們自己的節點手動添加:
admin.addPeer("enode://d2376964a9e24afec972d9b694dcf3574b171a1517b486532ee7b9e488503f46f97b6c1cc6bf55c9309ceab4fa7bb05427e7a213bb3efa43beeac5dae580ae12@0.0.0.0:30303");
再輸入admin.peers
確認是否添加成功。
完成后,任意一個節點挖礦miner.start()
,另一個節點都會同步。可以通過eth.blockNumber
查看區塊鏈上的區塊數量。要停止挖礦,miner.stop()
。
至此,搭建完畢!