Avalanche CLI

什麼是 Avalanche CLI？

Avalanche CLI 是一款命令列工具，開發者可用來建立、測試、部署、管理及升級 Avalanche L1 區塊鏈。

在加密貨幣領域，CLI 是以終端機為基礎的工具，讓開發者透過指令執行區塊鏈操作，而非使用圖形介面。

官方 Avalanche CLI GitHub 儲存庫將 Avalanche CLI 描述為一款讓開發者使用 Avalanche 的命令列工具，並專門協助開發者開發及測試 L1。

官方建立 Avalanche L1 指南指出，學習 Avalanche L1 開發的第一步是學會使用 Avalanche CLI。

Avalanche CLI 可協助開發者產生鏈設定、將該鏈部署至本機網路或 Fuji Testnet、準備部署至 Mainnet、管理節點、處理金鑰、部署跨鏈訊息工具，以及查看驗證者資訊。

對於打造 Avalanche L1 的團隊而言，這項工具尤其實用。舊版文件與工具曾將 Avalanche L1 稱為 Subnet。

Avalanche L1 可以擁有自己的虛擬機器、驗證者集合、Gas 代幣、權限、手續費規則及應用程式專屬設定。

Avalanche CLI 透過引導式指令流程及可重複使用的設定檔，協助開發者管理這些複雜設定。

對新手而言，Avalanche CLI 通常是了解 Avalanche L1 如何建立與部署的最快方式。

對正式環境團隊而言，Avalanche CLI 可支援重要工作流程，但使用時必須採取嚴格的安全控管並仔細檢視作業流程。

Avalanche CLI 的目前狀態

Avalanche CLI 對 Avalanche 開發者仍然重要，但其維護狀態在 2025 年底有所變動。

官方 Avalanche CLI 版本發布頁面指出，截至 2025 年 12 月，Avalanche CLI 已進入維護模式。

同一則公告表示，Ava Labs 團隊不會再開發新功能，只會處理安全修補程式及重大錯誤修正。

這對 2026 年的開發者很重要，因為不應將 Avalanche CLI 視為會持續快速更新、擴充功能的產品。

應將它視為一款成熟工具：它或許仍適用於既有工作流程，但使用者必須留意版本發布說明、文件更新及較新的工具建議。

進入維護模式不代表這項工具毫無用處。

這代表開發者應對未來支援抱持務實預期，並避免在關鍵正式系統中依賴不受支援的行為。

團隊在正式環境使用 CLI 前，應確認它與目前的 AvalancheGo 版本、現行 L1 部署規則、驗證者管理要求及自身基礎架構相容。

這項狀態也使文件檢視變得更加重要。

開發者在假設舊版教學仍符合現行最佳實務前，應先查看官方 Avalanche Builder Hub 頁面及 GitHub 儲存庫。

Avalanche CLI 為何重要

Avalanche CLI 很重要，因為啟動一條區塊鏈比部署一般智能合約複雜得多。

Avalanche L1 可能需要創世設定、虛擬機器選擇、驗證者管理器設定、驗證者節點、網路參數、Gas 規則、RPC 端點、監控、升級及跨鏈訊息設定。

沒有 CLI 的話，開發者就必須手動建立檔案、執行節點、準備交易、追蹤 ID、設定虛擬機器，並在多個系統間協調驗證者。

Avalanche CLI 透過指令及互動式精靈簡化了許多步驟。

這有助於開發者更快上手，並減少部分手動設定錯誤。

CLI 對本機開發尤其實用，因為開發者可以先建立鏈設定並進行測試，再使用公有測試網或 Mainnet 資源。

它也能協助團隊以更有組織的方式重複部署流程。

就 Avalanche 生態系統的發展而言，Avalanche CLI 等工具降低了嘗試自訂區塊鏈環境的門檻。

對已熟悉 EVM 工具、但需要協助設定 Avalanche 專屬鏈的開發者來說，這些工具讓應用程式專屬 L1 更容易實現。

這項工具不能取代安全工程，但它是 Avalanche 開發者工作流程中的重要一環。

Avalanche CLI 的運作方式

Avalanche CLI 讓開發者執行終端機指令，以產生設定檔、啟動本機網路、部署 Avalanche L1、管理金鑰及與 Avalanche 基礎架構互動。

開發者通常會先在支援的系統上安裝 CLI 二進位檔。

官方儲存庫表示，這項工具已在 Linux 和 Mac 上測試，目前不支援 Windows。

安裝完成後，開發者便可透過 avalanche 指令執行命令。

常見的起始流程是使用 avalanche blockchain create 建立 Avalanche L1 設定。

官方 CLI 指令參考文件指出，blockchain create 指令會建立新的創世檔案，並引導使用者完成建立區塊鏈所需的步驟。

建立設定後，開發者可使用 avalanche blockchain deploy 將其部署至本機，並選擇 Local Network。

官方本機部署指南指出，開發者可以將現有的 Avalanche L1 設定部署至本機 Avalanche 網路。

鏈啟動後，開發者便能連接應用程式、測試交易、查看驗證者並調整設定。

這個流程讓團隊能在轉移至公有網路前找出問題。

安裝 Avalanche CLI

Avalanche CLI 以二進位檔形式安裝，開發者可在終端機中執行。

官方「建立 Avalanche L1」指南指出，安裝最新版 Avalanche CLI 二進位檔最快的方法，是執行 Avalanche CLI 儲存庫提供的官方安裝指令碼。

預設情況下，二進位檔會安裝在使用者家目錄下的 bin 資料夾。

之後，開發者可將該資料夾加入系統路徑，讓 avalanche 指令能從任何終端機位置執行。

安裝時應謹慎處理，因為 CLI 會管理金鑰、部署及鏈設定，是敏感的開發工具。

開發者應使用官方文件及官方儲存庫，不要使用社群媒體、聊天室或轉載教學中的不明指令碼。

執行會下載並安裝軟體的 Shell 指令前，應先確認來源。

這在加密貨幣領域尤其重要，因為惡意安裝指令碼可能竊取私鑰、替換二進位檔、更改錢包地址或竄改部署參數。

在專業環境使用 Avalanche CLI 的團隊，應記錄安裝來源、版本、作業系統及檢查碼驗證流程。

可重現的安裝流程有助於降低供應鏈風險。

Avalanche CLI 的主要用途

第一項主要用途是建立 Avalanche L1 設定。

第二項主要用途是將 L1 部署至本機網路進行測試。

第三項主要用途是在部署至 Mainnet 前，先部署至 Fuji Testnet。

第四項主要用途是準備並執行 Mainnet 部署步驟。

第五項主要用途是管理驗證者節點及查看節點狀態。

第六項主要用途是處理開發金鑰及交易簽署。

第七項主要用途是管理鏈升級及虛擬機器變更。

第八項主要用途是部署及測試 Avalanche Interchain Messaging 工具。

第九項主要用途是在不同機器或團隊間匯出及匯入鏈設定資料。

這些用途使 Avalanche CLI 成為完整的開發者工作流程工具，而不只是建立區塊鏈的精靈。

建立 Avalanche L1

使用 Avalanche CLI 建立 Avalanche L1，通常會從 blockchain create 指令開始。

官方指令參考文件指出，avalanche blockchain create 會建立用來設定區塊鏈的新創世檔案，並預設執行互動式精靈。

精靈可能會要求開發者選擇虛擬機器、驗證者管理類型、控制器地址、Gas 代幣設定、預編譯選項及其他鏈參數。

「建立 Avalanche L1」指南說明，入門教學會使用 Subnet-EVM（Avalanche 的 EVM L1 分支）建立 EVM 型 Avalanche L1。

這一點很重要，因為許多開發者希望擁有與 Ethereum 相容的執行環境，同時又能自訂 Avalanche L1。

鏈設定不等於已上線的區塊鏈。

它是一組描述區塊鏈如何啟動及運作的檔案與參數。

開發者應將這項設定視為關鍵基礎架構。

錯誤的創世設定、控制器地址、Gas 代幣選擇或權限設定，都可能在部署後造成難以修復的問題。

部署至任何公有網路前，都應先在本機測試。

本機部署

建立 Avalanche L1 設定後，本機部署是最安全的第一步。

官方本機部署指南指出，開發者可以將已建立的 Avalanche L1 設定部署至本機 Avalanche 網路。

指南也示範，可在部署指令 avalanche blockchain deploy 後加入區塊鏈名稱及 local 選項。

本機網路讓開發者能測試鏈的運作情況，而不必承擔真實資金風險。

團隊也能快速測試錢包、RPC 端點、合約、Gas 規則、驗證者、預編譯功能及應用程式流程。

本機部署很實用，因為在區塊鏈公開前，修復啟動問題會容易得多。

開發者可以多次刪除並重建本機環境。

但 Mainnet 無法以相同方式任意重來。

本機測試應涵蓋一般交易及失敗情境。

團隊應測試節點重新啟動、Gas 設定錯誤、合約執行失敗、驗證者尚未就緒，以及使用者採用錯誤網路設定時會發生什麼情況。

部署至 Fuji Testnet

Fuji Testnet 是 Avalanche 在部署至 Mainnet 前使用的公有測試網。

Avalanche CLI 支援測試網工作流程，讓開發者能從本機測試轉移到更貼近實際的網路環境。

部署至測試網有助於找出本機部署可能未能發現的問題。

例如網路延遲、公有 RPC 設定、外部錢包設定、驗證者協調、水龍頭資金、監控、部署時機及使用者介面假設等。

本機部署成功並不代表測試網部署也一定成功。

應將 Fuji 測試視為 Mainnet 作業的預演。

開發者應記錄每一項指令、設定檔、所用金鑰、網路 ID、鏈 ID、節點設定及合約地址。

也應測試指令執行到一半失敗時的復原步驟。

官方 Mainnet 部署指南指出，開發者應先在 Fuji Testnet 部署並測試 Avalanche L1，再部署至 Mainnet。

這是務實的原則，因為 Mainnet 上的錯誤可能造成高昂代價，而且會公開發生。

部署至 Avalanche Mainnet

Mainnet 部署是 Avalanche CLI 工作流程中風險最高的一環。

官方Mainnet 部署指南警告，將 Avalanche L1 部署至 Mainnet 涉及許多風險，必須高度重視安全。

Mainnet 部署可能涉及真實 AVAX、真實驗證者、真實節點基礎架構、真實使用者，以及不可逆的設定選擇。

指南也指出，該教學僅供教育用途，並不保證部署安全。

應嚴肅看待這項警告。

Avalanche CLI 可以引導部署流程，但無法判斷驗證者金鑰是否安全、治理機制是否可靠、基礎架構是否具備韌性，或鏈的經濟模式是否合理。

部署至 Mainnet 前，團隊應先在 Fuji 測試、稽核合約、保護金鑰、撰寫作業手冊、監控節點、確認備份並準備事件應變措施。

團隊也應了解驗證者管理器的設計，以及變更驗證者可能造成的影響。

絕不應將 Mainnet 部署視為快速執行的命令列實驗。

Avalanche L1 與 Subnet

Avalanche L1 是目前常用的名稱；早期 Avalanche 文件及工具通常將其稱為 Subnet。

官方 ACP-77 文件探討 Subnet 的重新構想，並說明 L1 驗證者要求及驗證者集合控制方面的變更。

這項術語差異很重要，因為開發者可能仍會在舊指令、舊指南或舊程式碼註解中看到 Subnet 一詞。

使用 Avalanche CLI 時，開發者應了解，許多舊有 Subnet 工作流程的資料，指的就是現今的 Avalanche L1 工作流程。

Avalanche L1 可針對特定應用程式、產業、遊戲、機構、資產類別或社群進行設計。

它可以使用與 EVM 相容的虛擬機器，也可以使用自訂虛擬機器。

它可以採用自訂驗證者規則及自訂營運假設。

這種彈性很有用，但也會增加責任。

每個 Avalanche L1 都應清楚記錄驗證者模型、代幣模型、治理、跨鏈橋假設及升級流程。

Avalanche CLI 能協助建立及部署 L1，但不會讓每個 L1 預設都安全。

Avalanche CLI 中的 Subnet-EVM

Subnet-EVM 是許多 Avalanche L1 開發工作流程所使用、與 EVM 相容的虛擬機器。

「建立 Avalanche L1」指南指出，教學會使用 Subnet-EVM 建立 EVM 型 Avalanche L1，並提及它支援自訂手續費代幣、可設定的 Gas 參數及有狀態預編譯功能等特性。

這一點很重要，因為許多加密貨幣開發者已熟悉 EVM 合約及 Solidity 類型的工具。

Subnet-EVM 讓這些開發者能運用熟悉的智能合約模式，打造自訂 Avalanche L1。

不過，與 EVM 相容的 Avalanche L1 並不會自動等同於 Avalanche C-Chain 或其他 EVM 區塊鏈。

Gas 代幣設定、預編譯功能、鏈 ID、驗證者規則、RPC 端點及跨鏈橋路徑都可能不同。

開發者必須針對所使用的特定 Avalanche L1 設定錢包與應用程式。

也應在該 L1 選用的 Gas 與預編譯設定下測試智能合約。

某個合約即使在一種 EVM 環境中運作正常，仍可能需要在目標 Avalanche L1 上測試。

相容性可以降低使用門檻，但不會免除部署責任。

自訂虛擬機器

Avalanche CLI 也支援自訂虛擬機器工作流程。

CLI 指令參考文件指出，blockchain create 指令支援 Subnet-EVM 及自訂 VM，包括由使用者提供的創世檔案及 VM 二進位檔。

自訂虛擬機器讓團隊能定義不同於一般 EVM 環境的執行規則。

對於需要自訂狀態轉移、自訂交易格式、隱私功能、高效能邏輯或產業專屬規則的特殊應用程式，這可能很有用。

自訂 VM 比 Subnet-EVM 部署更進階。

它需要更深入了解 AvalancheGo、虛擬機器介面、二進位檔散布、節點升級、共識行為及測試。

自訂 VM 中的錯誤可能影響整條鏈，因為 VM 定義了交易的處理方式。

打造自訂 VM 的團隊，在公開部署前應進行嚴格的工程審查及充分測試。

Avalanche CLI 可協助封裝及部署自訂 VM 設定，但不能取代協議層級的安全審查。

自訂 VM 部署應視為進階區塊鏈工程工作。

驗證者管理

驗證者管理是營運 Avalanche L1 最重要的部分之一。

驗證者負責參與共識，並確保 L1 持續運作且正確無誤。

Avalanche CLI 可協助處理驗證者相關工作流程，包括列出驗證者及支援驗證指令。

CLI 指令參考文件指出，blockchain validators 指令會列出某條區塊鏈的驗證者並提供相關統計資料。

node validate 指令系列可協助節點以驗證者身分加入 Primary Network 和 Subnet，不過指令參考文件中有些 node 指令系列標示了 alpha 警告。

開發者應留意這些警告，因為實驗性指令可能變更或只有有限保障。

驗證者管理不只是技術工作。

它同時也是經濟與治理工作。

L1 必須決定誰能成為驗證者、如何新增或移除驗證者、需要多少質押或哪些權限、如何處理停機，以及如何因應不當行為。

Avalanche CLI 可支援營運工作，但必須謹慎設計鏈的驗證者模型。

金鑰與簽署

Avalanche CLI 包含金鑰管理指令，可建立、列出、匯出、匯入及刪除簽署金鑰。

CLI 指令參考文件指出，key create 指令可以產生簽署金鑰，或從檔案匯入現有金鑰。

文件也指出，key export 指令可以匯出已建立的簽署金鑰。

這些功能對開發很方便，但若使用不慎也十分危險。

私鑰可能控制資金、部署權限、驗證者權限或合約管理權限。

開發金鑰不應用於 Mainnet 部署。

Mainnet 金鑰不應以純文字儲存、提交至儲存庫、在聊天室分享，或存放於未妥善保護的機器上。

Mainnet 部署指南將硬體簽署裝置列為前置條件，反映正式環境作業需要更高的安全標準。

團隊應將本機測試金鑰、測試網金鑰、部署金鑰、驗證者金鑰及金庫金鑰分開管理。

妥善保護金鑰，是負責任使用 Avalanche CLI 最重要的一環。

節點管理

Avalanche CLI 提供與節點相關的指令，可用於本機節點、叢集、狀態檢查、更新、升級、SSH 存取及驗證工作流程。

CLI 指令參考文件指出，node local 指令系列提供本機節點指令，包括 start、stop、status、track、destroy 及 validate。

文件也指出，node status 指令可檢查節點及區塊鏈的啟動同步狀態。

這很重要，因為 Avalanche L1 必須仰賴節點持續運作、完成同步並保持連線，才能發揮作用。

要求節點驗證 L1 前，開發者必須確認節點是否已完成啟動同步。

正式環境的節點管理應包含監控、日誌、警示、備份、升級流程、磁碟規劃、網路安全及金鑰隔離。

命令列工具可以協助執行作業，但不應成為唯一的營運控管方式。

團隊應維護作業手冊，說明節點落後、失去連線、無法重新啟動或需要升級版本時的處理方式。

節點可靠性會影響使用者體驗、驗證者效能及網路安全。

Avalanche CLI 有助於管理節點，但仍須維持嚴謹的基礎架構管理。

鏈升級

鏈升級是 Avalanche CLI 能協助開發者的另一個領域。

CLI 指令參考文件指出，blockchain upgrade generate 指令會建立 upgrade.json 檔案，並透過互動式精靈引導使用者。

同一份文件指出，blockchain upgrade vm 指令可升級本機區塊鏈，以及已部署至 Fuji 和 Mainnet 的公有區塊鏈 VM 二進位檔。

升級需要謹慎處理，因為可能改變區塊鏈處理交易的方式。

VM 升級可能修正錯誤、新增功能、改變 Gas 行為或引入新風險。

團隊絕不可未經審查就將升級視為例行指令。

應先在本機及測試網測試升級。

啟用升級前，應先與驗證者協調。

升級後應持續監控區塊鏈。

在可行的情況下，也應準備回復或事件應變計畫。

升級失敗可能中斷應用程式、鎖定使用者資金、造成驗證者行為分歧，或損害外界對 L1 的信心。

Avalanche CLI 與 Interchain Messaging

Avalanche CLI 提供 Interchain Messaging 工作流程的指令支援。

CLI 指令參考文件指出，avalanche icm 指令系列提供與 ICM messenger 合約互動的工具。

官方 Avalanche Interchain Messaging 文件說明，ICM 是一種低階訊息傳遞協議，可讓 Avalanche L1 將資料傳送至其他 Avalanche L1。

同一份文件說明，ICM 使用 BLS 簽章及驗證者集合資訊來驗證訊息真偽。

這很重要，因為 L1 彼此溝通能讓 Avalanche 的 L1 模型發揮更大效用。

ICM 可支援跨鏈訊息、應用程式指令、資產移轉設計及 L1 間協調。

Avalanche CLI 可協助開發者部署或測試 ICM 相關合約及訊息流程。

不過，跨鏈訊息傳遞涉及重要安全風險。

開發者必須了解來源鏈驗證、目的鏈處理、中繼者假設、訊息重放防護及失敗處理方式。

跨鏈訊息錯誤可能同時影響多條鏈。

本機網路、測試網與 Mainnet 的差異

Avalanche CLI 工作流程應依序經過本機網路、測試網及 Mainnet。

本機網路最適合快速迭代及初期除錯。

Fuji Testnet 最適合在更貼近實際的基礎架構中進行公有網路預演與整合測試。

只有在團隊完成測試、文件整理、安全防護及審查後，才適合部署至 Mainnet。

每種環境的風險等級都不同。

本機環境的錯誤通常代價低，也不會公開。

測試網錯誤通常代價低，但可能暴露營運弱點。

Mainnet 錯誤可能造成真實資金損失、影響使用者、損害驗證者聲譽，或需要公開處理事件。

Avalanche CLI 讓開發者更容易在這些環境間切換，但無法判斷專案是否已準備就緒。

是否準備就緒，應根據測試證據、監控、稽核、驗證者準備、金鑰安全及治理清晰度來判斷。

按部就班部署，比從本機展示直接趕往 Mainnet 更安全。

Avalanche CLI 與正式環境基礎架構

正式環境基礎架構不只是成功執行部署指令。

正式環境的 Avalanche L1 需要可靠的驗證者、安全的節點、穩定的 RPC 存取、監控儀表板、警示、備份、日誌、升級流程、事件應變及使用者支援。

Avalanche CLI 可協助處理部分節點及鏈上作業，但應納入更完整的營運系統。

團隊應在適當情況下使用版本控制管理設定，但絕不可提交機密資料。

金鑰及憑證應使用安全的機密管理方式。

應監控節點健康狀況、驗證者上線時間、磁碟使用量、記憶體使用量、對等節點數量、區塊產出、RPC 錯誤及應用程式流量。

在使用者依賴區塊鏈前，也應先測試災難復原流程。

Avalanche CLI 的實用之處，在於能將許多指令標準化。

但單靠它不足以安全地營運正式環境區塊鏈。

正式環境團隊仍需要 DevOps、安全、治理及區塊鏈專屬的營運紀律。

Avalanche CLI 的安全風險

第一項安全風險是安裝到偽造或遭竄改的 CLI 二進位檔。

惡意二進位檔可能竊取金鑰、更改地址、竄改部署檔案或洩露機密資料。

第二項安全風險是未妥善處理私鑰。

若儲存方式不安全，透過 CLI 工作流程建立或匯出的金鑰可能遭到盜用。

第三項安全風險是在錯誤的網路執行指令。

原本要在本機網路或測試網執行的指令，若誤在 Mainnet 執行，可能造成危險。

第四項安全風險是設定錯誤。

錯誤的創世檔案、驗證者管理器地址或 Gas 代幣設定，都可能造成長期問題。

第五項安全風險是過度依賴互動式提示。

開發者可能一路點選提示，卻沒有理解每個選項的後果。

第六項安全風險是工具過時。

由於 Avalanche CLI 已進入維護模式，使用者必須留意相容性及受支援的工作流程。

第七項安全風險是部署後營運控管不足。

即使區塊鏈成功上線，若節點、金鑰、升級或監控管理不當，仍可能發生故障。

使用 Avalanche CLI 的最佳實務

開發者應只從 Avalanche 官方來源安裝 Avalanche CLI。

在重要工作流程中使用前，應先確認已安裝的版本。

開發者應了解，這項工具已於 2025 年 12 月進入維護模式。

建立每一條新鏈的設定時，都應先從本機網路開始。

使用 Mainnet 前，應先在 Fuji Testnet 測試。

開發金鑰應與正式環境金鑰分開。

Mainnet 作業應使用硬體簽署及安全的金鑰儲存方式。

鏈設定檔應妥善整理並備份。

應記錄每一項部署指令及重要輸出值。

絕不可只憑 Avalanche CLI 就認定正式環境區塊鏈安全無虞。

Avalanche CLI 的優點

Avalanche CLI 的第一項優點是讓開發者更快學會 Avalanche L1 開發。

第二項優點是透過互動式流程引導鏈設定。

第三項優點是簡化本機網路部署。

第四項優點是支援測試網及 Mainnet 部署準備。

第五項優點是更容易管理節點及驗證者工作流程。

第六項優點是支援開發工作流程中的金鑰處理。

第七項優點是支援鏈升級及 VM 升級工作流程。

第八項優點是支援 ICM 相關開發者作業。

第九項優點是比手動設定更容易重複執行。

第十項優點是讓開發者能在建置完整正式環境基礎架構前，實際探索 Avalanche L1 設計。

Avalanche CLI 的限制

第一項限制是截至 2025 年 12 月，Avalanche CLI 已進入維護模式。

第二項限制是它不能取代安全稽核。

第三項限制是它無法保證 Mainnet 部署安全。

第四項限制是它無法解決驗證者治理設計問題。

第五項限制是它不會自動保護私鑰。

第六項限制是指令參考文件中的部分節點指令領域標示為實驗性或 alpha 版本。

第七項限制是它未必會將所有未來 Avalanche 功能納入正式支援的工作流程。

第八項限制是使用者必須熟悉終端機操作及區塊鏈設定。

第九項限制是本機測試成功並不能證明已具備正式環境部署條件。

第十項限制是部署後團隊仍必須維護監控、升級、事件應變及文件。

使用 Avalanche CLI 的常見錯誤

常見錯誤之一是使用過時教學，卻未確認現行文件。

另一項常見錯誤是混淆舊版 Subnet 術語與新版 Avalanche L1 術語。

第三項錯誤是未在 Fuji Testnet 完整預演前就部署至 Mainnet。

第四項錯誤是本機測試與正式部署使用同一把金鑰。

第五項錯誤是匯出私鑰時沒有安全儲存控管。

第六項錯誤是忽略實驗性指令的警告標示。

第七項錯誤是未檢查所有參數，就認定產生的鏈設定安全無虞。

第八項錯誤是部署後未記錄鏈 ID、RPC 端點、驗證者地址及合約地址。

第九項錯誤是啟動 L1 時沒有監控及事件應變計畫。

第十項錯誤是假設 CLI 能避免團隊在治理、代幣經濟學、驗證者或應用程式設計上的缺陷。

新手使用 Avalanche CLI

新手應先將 Avalanche CLI 作為學習工具。

最適合新手的流程是：從官方儲存庫安裝工具、建立 EVM 型 Avalanche L1 設定、本機部署，並將錢包或應用程式連接至本機鏈。

這能讓使用者了解鏈設定與實際運作中的網路有何不同。

也能讓使用者了解驗證者、Gas 代幣、創世檔案、鏈 ID 及 RPC 端點的重要性。

在了解本機及測試網工作流程的每個步驟前，新手應避免部署至 Mainnet。

初期練習時也應避免使用真實私鑰或真實資金。

Avalanche CLI 可能讓進階概念看起來簡單，但底層仍是真正的區塊鏈環境。

新手開發者應仔細閱讀指令輸出，不要照抄自己不理解的指令。

目標不只是讓區塊鏈運作起來。

更重要的是了解每項設定選擇為何重要。

團隊使用 Avalanche CLI

團隊應以有條理的開發流程使用 Avalanche CLI。

應明確規定誰可以建立設定、誰負責核准部署、誰控管金鑰、誰監控驗證者，以及誰有權核准升級。

應保存部署日誌及設定紀錄。

可行時，應將開發者、營運人員、安全審查人員及治理參與者的職責分開。

上線前應測試災難復原及驗證者替換流程。

也應準備面向使用者的文件，說明 L1 的鏈 ID、RPC 端點、Gas 代幣、跨鏈橋路徑、驗證者模型及風險假設。

Avalanche CLI 可以加快部署，但團隊仍須負起責任。

如果使用者在正式環境 Avalanche L1 上持有真實資產，這條 L1 就是公開的金融系統。

達到這項標準，不能只靠成功執行終端機指令。

還需要成熟的營運能力。

相關加密貨幣術語

CLI 是命令列介面的縮寫，指透過終端機執行軟體指令的方式。

Avalanche L1 是具有自身規則、驗證者及執行環境的可自訂 Avalanche 區塊鏈。

Subnet 是較舊的術語，常用來指現在通常稱為 Avalanche L1 的網路。

Subnet-EVM 是許多 Avalanche L1 使用的 EVM 相容虛擬機器。

創世檔案是定義區塊鏈初始狀態的設定。

驗證者是參與區塊鏈共識的節點營運者。

Fuji Testnet 是 Avalanche 用於開發及測試的公有測試網。

Mainnet 是涉及真實資產及使用者的正式網路。

ICM 是 Avalanche Interchain Messaging，一種供 Avalanche L1 之間通訊的協議。

AvalancheGo 是用於執行 Avalanche 網路節點的節點軟體。

常見問題

什麼是 Avalanche CLI？

Avalanche CLI 是一款命令列工具，可用來建立、測試、部署、管理及升級 Avalanche L1 區塊鏈。

Avalanche CLI 有哪些用途？

它可用於 Avalanche L1 設定、本機部署、測試網部署、Mainnet 準備、節點管理、驗證者工作流程、金鑰處理、升級及 ICM 相關作業。

Avalanche CLI 仍在積極開發嗎？

官方 GitHub 版本發布公告指出，Avalanche CLI 已於 2025 年 12 月進入維護模式，不再規劃 Ava Labs 新功能，只會處理安全修補程式或重大錯誤修正。

Avalanche CLI 可以建立 Avalanche L1 嗎？

可以，avalanche blockchain create 指令可透過互動式精靈建立新的 Avalanche L1 設定。

Avalanche CLI 可以在本機部署嗎？

可以，Avalanche CLI 可將現有 Avalanche L1 設定部署至本機 Avalanche 網路，以供開發及測試。

Avalanche CLI 可以部署至 Mainnet 嗎？

可以，Avalanche CLI 支援 Mainnet 部署工作流程，但官方文件警告，Mainnet 部署涉及許多風險，必須高度重視安全。

Avalanche CLI 支援哪些作業系統？

官方儲存庫表示，Avalanche CLI 已在 Linux 和 Mac 上測試，目前不支援 Windows。

Avalanche CLI 與 AvalancheGo 有什麼不同？

Avalanche CLI 是供開發者使用的命令列工具；AvalancheGo 則是用來執行 Avalanche 網路節點的軟體。

Avalanche CLI 可以取代稽核嗎？

不可以。Avalanche CLI 可協助處理工作流程，但不能取代程式碼稽核、設定檢查、金鑰安全、驗證者規劃或正式環境監控。

學習 Avalanche CLI 最安全的方法是什麼？

最安全的方式是從官方來源安裝、建立測試 L1、在本機部署，再於考慮 Mainnet 前先在 Fuji Testnet 預演。

Avalanche CLI 支援自訂虛擬機器嗎？

支援。官方指令參考文件指出，blockchain create 工作流程支援 Subnet-EVM 及使用自訂創世檔案與 VM 二進位檔的自訂虛擬機器。

使用 Avalanche CLI 最大的風險是什麼？

最大的風險，是將引導式命令列流程誤當成安全保證。正式環境 L1 部署仍需要安全的金鑰、經過測試的基礎架構、驗證者治理、監控及事件應變。

結論

Avalanche CLI 是建置及管理 Avalanche L1 區塊鏈的重要開發者工具。

它可協助開發者建立鏈設定、部署本機網路、在 Fuji Testnet 預演、準備 Mainnet 部署、管理節點、查看驗證者、處理金鑰、升級虛擬機器及執行 ICM 工作流程。

它最大的優勢，是將複雜的 Avalanche L1 開發步驟轉化為有條理的終端機指令及引導式流程。

因此，它適合用於學習、原型開發、測試及部分營運工作。

不過，使用 Avalanche CLI 時必須對目前狀況抱持正確認知。

截至 2025 年 12 月，官方 GitHub 儲存庫指出，這項工具已進入維護模式。

這代表開發者不應預期會持續新增大量功能；在將它用於正式環境工作流程前，也應仔細確認目前的相容性。

Avalanche CLI 也不是安全保證。

它可以協助部署區塊鏈，但無法保證鏈的驗證者設計、金鑰管理、治理、代幣經濟學、升級、跨鏈橋、合約或基礎架構安全無虞。

最安全的開發流程，是從本機開始、在 Fuji 測試、妥善保護金鑰、記錄所有設定、監控節點，並在經過嚴格審查後才部署至 Mainnet。

對新手而言，Avalanche CLI 是了解 Avalanche L1 實際運作方式的最佳途徑之一。

對團隊而言，它是實用的工作流程工具，但應搭配專業 DevOps、稽核、安全政策及治理控管。

關鍵在於：Avalanche CLI 讓 Avalanche L1 開發更容易，但不會讓區塊鏈營運變得簡單或毫無風險。

謹慎使用時，它可以加快開發並減少手動設定工作。

若使用不慎，它可能讓團隊比自身管理能力所及更快部署不安全的設定。