比特幣(BTC)作為首個去中心化的數(shù)字貨幣,其核心功能離不開強大的客戶端軟件,Bitcoin Core(原 Bitcoin-Qt)是最官方、最功能完備的比特幣節(jié)點客戶端,它不僅管理用戶的錢包,還參與整個比特幣網(wǎng)絡(luò)的共識與數(shù)據(jù)同步,對于希望深入了解比特幣或需要更精細(xì)控制錢包功能的用戶而言,掌握 Bitcoin Core 的命令行接口(CLI)命令至關(guān)重要,本文將詳細(xì)介紹 BTC 客戶端命令的基本概念、常用命令及其應(yīng)用場景。
什么是 Bitcoin Core 命令行接口?
Bitcoin Core 提供了一個圖形化用戶界面(GUI),方便普通用戶進(jìn)行查看余額、發(fā)送接收比特幣等操作,但其背后,更強大、更靈活的功能則通過命令行接口(CLI)實現(xiàn),CLI 允許用戶通過輸入特定的文本命令來與 Bitcoin Core 節(jié)點進(jìn)行交互,執(zhí)行諸如查詢信息、交易管理、網(wǎng)絡(luò)控制等多種操作,這些命令通常通過 bitcoin-cli 可執(zhí)行文件調(diào)用,該文件隨 Bitcoin Core 安裝包一同提供。
準(zhǔn)備工作:運行 bitcoin-cli
在使用 bitcoin-cli 命令之前,確保你的 Bitcoin Core 節(jié)點已經(jīng)完全同步(至少同步到最新的區(qū)塊高度),并且錢包已解鎖(如果需要密碼),基本命令格式如下:
bitcoin-cli [命令] [參數(shù)1] [參數(shù)2] ...
查看幫助信息:
bitcoin-cli help
或者查看特定命令的幫助:
bitcoin-cli help sendtoaddress
常用 BTC 客戶端命令詳解
以下是一些最常用且實用的 Bitcoin Core 命令,涵蓋了錢包管理、交易查詢、網(wǎng)絡(luò)信息等方面:
-
錢包與地址管理:
getnewaddress [標(biāo)簽]:生成一個新的比特幣接收地址,可選的“標(biāo)簽”用于給地址分類。bitcoin-cli getnewaddress "接收地址1"
getaddressesbylabel "標(biāo)簽":獲取指定標(biāo)簽下所有關(guān)聯(lián)的地址。listaddresses:列出錢包中的所有地址。getbalance ["賬戶"] [最小確認(rèn)數(shù)]:查看錢包余額,可以指定賬戶和最小確認(rèn)數(shù)(未確認(rèn)的余額默認(rèn)不計入)。bitcoin-cli getbalance
listtransactions [賬戶] [計數(shù)] [從] [包括 watchonly]:列出錢包中的交易記錄,可以指定賬戶、返回數(shù)量、起始偏移量等。bitcoin-cli listtransactions 10 0
-
交易操作:
sendtoaddress "地址" "金額" [注釋] [注釋_to] [替換費用] [可替代] [鎖定時間]:發(fā)送比特幣到指定地址。"地址":接收方比特幣地址。"金額":發(fā)送的比特幣數(shù)量(以 BTC 為單位)。[注釋]:可選的交易注釋。[替換費用]:是否允許替換交易(用于 RBF)。bitcoin-cli sendtoaddress "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" 0.1 "測試轉(zhuǎn)賬"
createrawtransaction [{"txid":"id","vout":n},...] {"address":amount,...} [locktime]:創(chuàng)建一個原始交易(未簽名的交易),這允許用戶構(gòu)建復(fù)雜的交易,例如多輸入多輸出。signrawtransactionwithwallet "hexstring" [{"txid":"id","vout":n,"scriptPubKey":"hex",redeemScript:"hex"},...] [私鑰] [sighashtype]:使用錢包中的私鑰對原始交易進(jìn)行簽名。sendrawtransaction "hexstring" [允許高費用]:將已簽名的原始交易廣播到比特幣網(wǎng)絡(luò)。gettransaction "txid" [包含_watchonly]:獲取特定交易的詳細(xì)信息,如金額、確認(rèn)數(shù)、區(qū)塊哈希等。
-
區(qū)塊鏈與網(wǎng)絡(luò)信息:
getblockcount:獲取當(dāng)前區(qū)塊鏈的區(qū)塊高度。getblockhash "高度":獲取指定高度的區(qū)塊哈希值。getblock "區(qū)塊哈希" [詳細(xì)]:獲取指定區(qū)塊的詳細(xì)信息。詳細(xì)為 true,則返回完整區(qū)塊信息,否則只返回摘要。getblockchaininfo:獲取區(qū)塊鏈的基本信息,如當(dāng)前區(qū)塊高度、難度、網(wǎng)絡(luò)哈希率、同步進(jìn)度等。getnetworkinfo:獲取比特幣節(jié)點的網(wǎng)絡(luò)連接信息,如節(jié)點數(shù)量、連接狀態(tài)、協(xié)議版本等。getpeerinfo:列出當(dāng)前連接的所有對等節(jié)點信息。
-
錢包與節(jié)點控制:
walletlock:鎖定錢包,需要密碼才能進(jìn)行敏感操作。walletpassphrase "密碼" "超時秒數(shù)":解鎖錢包,指定解鎖時間。stop:安全關(guān)閉 Bitcoin Core 節(jié)點。getmininginfo:獲取挖礦相關(guān)信息(如果節(jié)點開啟了挖礦功能)。
高級應(yīng)用與注意事項
- 批量操作與腳本自動化:
bitcoin-cli命令可以結(jié)合 shell 腳本(如 Bash、PowerShell)實現(xiàn)批量操作和自動化流程,例如定期檢查余額、批量發(fā)送小額款項等。 - 交易構(gòu)造與優(yōu)化:通過
createrawtransaction和signrawtransactionwithwallet,用戶可以精確控制交易的輸入輸出,實現(xiàn)自定義找零、設(shè)置交易費用(通過replace-by-fee或手動設(shè)置手續(xù)費率)、甚至創(chuàng)建多簽交易等高級功能。 - 隱私與安全:使用命令行操作時,務(wù)必注意環(huán)境安全,避免在公共或不安全的計算機上操作,防止私鑰泄露,對于大額交易,建議先在測試網(wǎng)絡(luò)上進(jìn)行演練。

- 性能考慮:部分命令(如涉及大量歷史交易查詢的)可能會對節(jié)點性能產(chǎn)生一定影響,尤其是在資源有限的設(shè)備上。
- 學(xué)習(xí)資源:Bitcoin Core 的官方文檔是學(xué)習(xí)命令最權(quán)威的資料,其中包含了所有命令的詳細(xì)參數(shù)、返回值和示例,GitHub 上的 Bitcoin Core 倉庫也提供了源碼和文檔。
Bitcoin Core 的命令行接口是通往比特幣核心功能的強大橋梁,雖然它不像 GUI 那么直觀,但對于追求更高控制力、自動化能力或進(jìn)行復(fù)雜交易操作的用戶而言,掌握這些命令是必不可少的,通過熟練運用 bitcoin-cli 命令,用戶能夠更深入地理解比特幣的工作原理,更靈活地管理自己的資產(chǎn),并充分發(fā)揮 Bitcoin Core 作為全節(jié)點的強大功能,初學(xué)者可以從簡單的查詢命令開始,逐步探索更復(fù)雜的交易和錢包管理功能,在實踐中不斷提升對比特幣的認(rèn)知和操作技能。