在「如何獲取最新版的 Forge」中我們介紹了如何進行Forge鏈的硬升級（需要重置本地鏈的狀態），硬升級的做法在開發環境下比較方便，相當于清空數據庫的記錄。

而有些時候，可能你的測試鏈跑了一段時間，上面產生了不少測試數據，重新產生這些測試數據可能費時費力，你既希望升級到最新版的 Forge，又希望保留之前啟動過的鏈的狀態，魚與熊掌可以兼得么？答案是肯定的，接下來我們來討論具體的操作步驟。

在介紹升級步驟之前，我們有必要再次強調下鏈的升級在不同上下文的區別：

?在開發環境我們可以毫無顧慮的進行鏈的重置、升級、啟停，因為你不會影響到其他人或者用戶

?在生產環境，因為整個區塊鏈是分布式的網絡，升級的動作需要由鏈的運營者來決定，而升級的結果需要在整條鏈的所有節點間同步

本文探討的是前面一種情況，即開發環境下的具體做法。

準備工作

Forge CLI 是 ArcBlock 官方開發和維護的管理本地 Forge 鏈、節點的命令行工具，建議定期升級 Forge CLI［1］ 到最新版本：npm install -g @arcblock/forge-cli。

了解 Forge 最新版本

你讀到這篇文章時，已經發布的最新的 Forge 版本是：

了解 Forge 本地版本

如果你想知道本地 Forge 鏈的版本，直接運行：forge status，得到如下執行結果：

其中紅色圈圈中的版本就是當前鏈所使用的版本，我本地鏈的版本是 v0.36.5。

當然，你也可以執行：forge ls，得到如下執行結果：

其中紅框圈出的版本也是當前鏈使用的版本，forge ls 會列出本地已經下載過的所有可使用的 Forge 版本，并把當前使用的版本高亮出來。

升級的前提是我們本地使用的版本比遠程的最新版本低，如果兩個版本相同的話，你可以到此打住啦，哈哈！

下載 Forge 最新版

如果要把本地 Forge 鏈從 v0.36.5 升級到 v0.37.0，需要先下載 Forge v0.37.0 的全部組件，執行如下命令：

forge download latest

# 中國用戶

forge download latest --mirror http://arcblock.oss-cn-beijing.aliyuncs.com

可能有人會問，forge download 和 forge install 有啥區別？兩者都會從我們的鏡像下載指定版本（或最新版）的 Forge，不同點在于 forge download 只會下載，而 forge install 下載完之后會把本地使用的 Forge 版本切換到剛下載的版本，硬升級的時候用的就是 forge install。

怎么確定有沒有切換本地當前使用的 Forge 版本？再次執行 forge ls：

可以看到，被高亮的還是 v0.36.5。

配置鏈管理員

對于區塊鏈來說，所使用軟件的版本其實相當于安裝在電腦硬件上的操作系統，如果要升級操作系統的版本，我們要輸入管理員密碼、把操作系統停下來、重新啟動完成升級，如果你經歷過操作系統的升級，Forge 鏈的升級就很好理解。

首先，我們需要給鏈配置 1 個管理員（moderator，本意是協調員，因為區塊鏈本身需要在多節點，在多節點間達成共識需要協調員），而任何能夠修改鏈狀態的實體本質都是一個錢包，即公私鑰對，對于沒有配置過鏈管理員的同學，需要先用 forge wallet:create --defaults 來生成一個管理員錢包，并且保存好錢包私鑰。

為了后續方便，我們先把鏈管理員私鑰配置到環境變量里面，把下面這行加到你的 ~/.bashrc 或者 ~/.zshrc 里面（記得把私鑰換成你生成的那個）：

export FORGE_MODERATOR_SK=“qDWzV5cv8wSa-I2CKiLHm3msM9GeYyjOo4yo3iNicT8xlZqcdY_o0REVnffjD_wq85sCjoka6B7D-BLPxcXUcA”

如何確保你正確把管理員私鑰導出到了環境變量里面？直接執行 echo $FORGE_MODERATOR_SK，如果有結果輸出并且和你生成的私鑰相同，說明配置正確。

接下來我們需要把鏈管理員信息添加到 Forge 的配置里面：

?如果你使用的是 Forge CLI v0.36.0 以下的版本，并且按本文操作時沒有升級到最新版，你的配置文件在：~/.forge_release/forge_release.toml

?如果你使用的是 Forge CLI v0.36.0 及以上版本，你的配置文件在：~/.forge_chains/forge_default/forge_release.toml

當然，我們有更簡單的方式，直接獲取 Forge 鏈配置文件的路徑：forge config | grep file

需要把什么內容添加到 Forge 的配置文件里呢？我們不妨直接運行 forge upgrade 試試：

可以看到，Forge CLI 提示我們配置文件里面沒有管理員相關的配置，并且提示我們要把什么內容添加進去：

［forge.moderator］

address = “z1ScT4nkbA8b6cQBKQoyWTnnQnXAsmPsdhk”

publicKey = “MZWanHWP6NERFZ334w_8KvObAo6JGugew_gSz8XF1HA”

打開 Forge CLI 給出的配置文件路徑，把上面的配置追加到文件的末尾，保存后退出。

重新啟動

因為我們添加管理員的操作修改了鏈的配置，為了是配置生效，需要重新啟動 Forge 鏈，依次執行如下兩條命令：

forge stop

forge start

重新啟動之后，包含了管理員的配置被加載到 Forge 的運行配置中，接下來我們就可以以管理員的身份往鏈上發送升級的指令。

開始升級

萬事俱備，接下來再次運行：forge upgrade，如下圖需要做出幾個升級的配置：

?要升級到的版本，選擇 v0.37.0

?在哪個塊高升級，可以根據當前的塊高加上適當的增量，比如當前塊高 33，我們就在 53 塊高出升級，如果出塊時間配置的是 3 秒，意味著 1 分鐘之后會發生升級

?確認升級操作，因為這個操作是不可逆的，如果到這里后悔了，輸入 N 或者 Ctrl + C 即可中止

回車確認之后，Forge CLI 會用管理員的身份往 Forge 鏈發送 1 個 UpgradeNode 的交易，交易被成功打包之后，Forge 鏈會在預設的高度停下來，然后 Forge CLI 檢測到 Forge 鏈完全停止之后會再次把鏈啟動起來，這樣就完成了整個升級的過程。

驗證升級

如何驗證升級是成功的呢？再次執行 forge status，

檢查當前鏈狀態里面的版本號，已經變成了升級后的版本。