比特幣核心配置檔說明，從節點角色與資源限制看懂 bitcoin.conf 設定取捨

bitcoin.conf 檔案路徑與載入邏輯

Bitcoin Core 啟動時會優先定位資料目錄（datadir），並自該目錄下讀取設定檔。各作業系統預設路徑如下：Linux 為 ~/.bitcoin/bitcoin.conf，macOS 為 ~/Library/Application Support/Bitcoin/bitcoin.conf，Windows 則為 %APPDATA%\Bitcoin\bitcoin.conf。若使用 -datadir 重新導向資料儲存路徑，設定檔也需對應存放在新目錄中。

若需指定特定位置的設定檔，可透過命令列參數 -conf=/path/to/file.conf 指定。在容器環境或 systemd 守護行程中，建議一律採用絕對路徑，避免因工作目錄基準不同而造成檔案找不到的狀況。

多環境維運可利用 includeconf= 拆分管理：將通用節點規則放入主設定檔並納入版本控管，將涉及本機路徑與 RPC 憑據的機密項拆至獨立檔案引入，確保安全性。優先順序上，命令列啟動參數永遠覆蓋設定檔中的同名選項。

設定語法為標準鍵值對：一行一項，格式為 名稱=值，選項前方不加短橫線 -，以 # 作為註解開頭。布林值建議明確填寫 1 或 0。完整選項可查閱 bitcoind 官方手冊頁。

依據節點角色確立配置策略

不同業務場景對節點的運算、磁碟與頻寬需求差異極大。在設定前必須先確認節點角色定位：

磁碟取捨：剪裁模式與索引相容性

剪裁模式（Pruning）是緩解磁碟空間壓力的有效手段，透過參數 prune 設定，單位為 MiB：

• prune=0：關閉剪裁，保留完整的全量歷史區塊。
• prune=1：手動剪裁模式。節點不會自動刪除區塊，而是允許管理員後續透過 pruneblockchain RPC 指令手動清理指定高度之前的資料。
• prune=>=550：自動剪裁模式。節點會自動清理舊區塊，將磁碟佔用維持在目標數值附近（最小值為 550 MiB）。

各類輔助索引的功能與成本分析：

• txindex=1：為所有歷史交易建立索引，支援透過 getrawtransaction 隨機查詢任意交易。需要全量區塊資料，無法與剪裁共存，且會增加額外磁碟佔用與同步時間。
• blockfilterindex=1：建立符合 BIP158 的緊湊區塊過濾器索引，供輕量客戶端（如 Neutrino）快速核對交易活動，資源開銷相對輕微。
• coinstatsindex=1：維護 UTXO 集合統計索引，加速 gettxoutsetinfo 查詢，適合頻繁核對總帳的營運節點。
• blocksdir=/path：可將龐大的區塊資料獨立存放於專用硬碟，與放置錢包和設定檔的系統碟分離。

記憶體與快取：dbcache 與交易池管理

dbcache 控制 UTXO 資料庫的記憶體寫入快取大小（單位 MiB，近期版本預設值約 450 MiB）。在區塊鏈初始同步（IBD）階段調高此數值，能將大量資料庫寫入合併於記憶體中處理，顯著降低磁碟 I/O 延遲：

• 8 GB 記憶體主機：建議配置 dbcache=2048 至 3072。
• 16 GB 記憶體主機：初次同步可配置 dbcache=4096 至 8192。
• 32 GB 以上專用伺服器：可拉高至 dbcache=16384。

重要原則：務必為作業系統與其他守護行程預留至少 2 至 3 GB 記憶體空間。若快取設得過高導致系統觸發 Swap 交換甚至遭 OOM Killer 強制終止，同步效能會呈現雪崩式下跌。同步完成後，日常運行的寫入量大幅減少，可將其調回保守值。

maxmempool 控制未確認交易池的記憶體上限（預設約 300 MB）。礦池與廣播節點可視負載調高至 500 以上；一般驗證節點維持預設即可。mempoolexpiry 則決定交易滯留過期時間（預設約 336 小時，即 14 天）。

網絡傳輸與頻寬調節

maxconnections 設定節點同時維持的 P2P 連線總數（預設約 125）。若處於家用寬頻環境，建議調降至 40 至 60 避免排擠其他連線；公網骨幹節點則可適度放大。

maxuploadtarget 限制 24 小時內的歷史區塊對外上傳總量（單位 MiB，預設 0 為不限制）。若伺服器頻寬按流量計費，設定例如 maxuploadtarget=5000 可有效防範帳單超支，超過上限時節點仍可正常接收新區塊與交易，僅暫停對外提供歷史區塊同步。

連通性相關關鍵參數：

• listen=1：允許外部節點連入（主網 P2P 預設連接埠為 8333），對全網分散度貢獻最大。
• blocksonly=1：節點僅接收與中繼已確認區塊，不維護交易池與未確認交易，大幅節省日常頻寬消耗。
• proxy=127.0.0.1:9050 與 listenonion=1：將連線透過 Tor 洋蔥網絡路由，強化網路層匿名性。

RPC 服務配置與多層防禦

設定 server=1 即啟用 JSON-RPC 服務。啟用並不等於直接向外網暴露：Bitcoin Core 預設僅綁定 rpcbind=127.0.0.1 且僅允許本機連入。

生產環境下配置遠端存取的正確防護方式：

• 嚴禁明文憑據： 避免使用已不建議的 rpcpassword。應透過官方提供的 rpcauth-gen.py 腳本生成雜湊授權，以 rpcauth=使用者名稱:鹽值$雜湊值 格式填入設定檔。
• 位址綁定與 IP 白名單： 遠端介接時除設定 rpcbind 於內網 IP 外，必須搭配 rpcallowip=內網IP網段，雙重阻斷未授權來源。
• 隔離與傳輸加密： 主網 RPC 埠（預設 8332）絕不可直接映射於公網。跨主機呼叫應建立 SSH 通道、WireGuard 虛擬專用網或經由具備 TLS 認證的反向代理進行轉發。
• 介面最小授權： 利用 rpcwhitelist 鎖定指定帳號可呼叫的方法清單，避免查詢帳號誤調轉帳或停止節點等高危指令。

即時事件發布參數 zmqpubrawblock 與 zmqpubrawtx 同樣不具備身分認證機制，應綁定於 tcp://127.0.0.1:28332 或 UNIX socket。

錢包模組與日誌診斷技巧

若節點僅用於驗證或資料廣播，建議直接配置 disablewallet=1 關閉錢包功能，徹底縮小系統攻擊面。若需使用內建錢包，需注意：

• avoidpartialspends=1：預設為關閉（0）。手動設為 1 可防止錢包在發送交易時拆開同一來源位址的 UTXO，有助於保護鏈上隱私。
• fallbackfee：近年版本預設為 0。若剛啟動尚未累積足夠費率估算資料即建構交易，需手動給予合理的備用費率（例如 fallbackfee=0.00001）。

日常診斷與排查技巧：

• 日誌檢視： 異常退出時先查看 debug.log 或 systemd 的 journalctl -u bitcoind。拼錯參數或使用衝突選項會直接在啟動時報錯。
• 即時狀態查詢： 透過命令列執行 bitcoin-cli getblockchaininfo 驗證剪裁狀態；透過 bitcoin-cli getnetworkinfo 檢查對外連線數與綁定狀態。

生產環境推薦範本（依角色二選一）

根據前述相容性原則，以下提供兩套不可混用的典型設定範本，可直接作為客製化起點：

範本 A：輕量自用驗證節點（啟用自動剪裁，禁用 txindex）

範本 B：全功能應用後端節點（全量歷史索引，關閉剪裁）

常見問題解答（FAQ）