技術參考
Eden 金鑰缺失、韌體安裝失敗怎麼辦？「Encryption keys are missing」「Firmware installation failed」報錯解決
要點
- Android「Encryption keys are missing」（金鑰缺失）和電腦版「Decryption keys are missing」（缺少解密金鑰）都是還沒裝 prod.keys：裝上 prod.keys，電腦版裝完要重啟 Eden。
- Android「Firmware installation failed」（韌體安裝失敗）：韌體 ZIP 裡只要有一個不是 .nca 的檔案（包括多套一層資料夾）就判失敗。ZIP 打開後要直接就是 nca 檔案。
- 「Keys failed to initialize」（金鑰初始化失敗）是 keys 檔案無效、不完整或太舊，要重新匯出；「Verify your keys file has a .keys extension」是檔名不對，改回 prod.keys。
- 電腦版要先裝 keys、重啟 Eden，再裝韌體；keys 不能比韌體舊，否則開 Home Menu 會報「Firmware Corrupted」。
- Android裝韌體時閃出「Fatal Error」（致命錯誤），社群經驗多是儲存許可權問題；驅動管理器的「Error during Fetch」（獲取過程中出錯）是連不上 GitHub。
目錄
Eden 裝 keys、韌體時報錯，最常見的是三件事：還沒裝 prod.keys（Encryption keys are missing / Decryption keys are missing，中文介面是「金鑰缺失」「缺少解密金鑰」），keys 檔名或內容不對（Keys failed to initialize、Verify your keys file has a .keys extension），以及Android版韌體 ZIP 的結構不對（Firmware installation failed，韌體安裝失敗）。 修法分別是：裝上 prod.keys 並重啟 Eden；把檔名改回 prod.keys，內容有問題就重新匯出；重新打包韌體 ZIP，讓它打開後直接就是 .nca 檔案。下面按電腦版、Android版逐條列出原文，截至 2026 年 11 月 1 日（Eden master 原始碼）。
報錯速查表
| 報錯原文（英文介面） | 中文介面 | 意思 | 怎麼修 |
|---|---|---|---|
Encryption keys are missing | 金鑰缺失 | Android版還沒裝 prod.keys | 嚮導或設定裡「安裝 prod.keys 檔案」 |
Decryption keys are missing. Install them now? | 缺少解密金鑰。現在安裝嗎？ | 電腦版還沒裝 prod.keys | 點 Yes 選 prod.keys，重啟 Eden |
Keys failed to initialize / Decryption Keys failed to initialize | 金鑰初始化失敗 | keys 檔案無效、不完整或太舊 | 重新匯出 prod.keys |
Verify your keys file has a .keys extension and try again. | 請確保金鑰檔案具有.keys副檔名後重試。 | 檔名不對 | 改回 prod.keys |
Firmware installation failed | 韌體安裝失敗 | Android：ZIP 裡有不是 .nca 的檔案 | ZIP 裡只放 nca 檔案 |
Install decryption keys and restart Eden before attempting to install firmware. | 在嘗試安裝韌體之前先安裝解密金鑰並重啟 Eden。 | 電腦版先裝了韌體 | 先裝 keys，重啟，再裝韌體 |
Firmware Corrupted | 韌體已損壞 | keys 比韌體舊，或韌體壞了 | keys 換新；必要時重新匯出韌體 |
Fatal Error（裝檔案時） | 致命錯誤 | Android：解壓或複製出錯 | 社群經驗：打開儲存許可權 |
Error installing file(s) to NAND | 向 NAND 安裝檔案時失敗 | 裝更新 / DLC 時沒 keys 或檔案無效 | 先裝 keys；檔案重新匯出 |
Error during Fetch | 獲取過程中出錯 | 驅動管理器連不上 GitHub | 換網路、稍後再試，或手動匯入驅動 zip |
裝好以後開遊戲才報的錯是另外幾類：Android的「Your ROM is encrypted」見 Your ROM is encrypted 報錯解決，電腦版的「Error while loading ROM! (0007-XXXX)」見 0007 錯誤碼對照表。
Eden 電腦版（Windows / Linux / Mac / Steam Deck）
Eden 電腦版每次啟動都會檢查 keys，所以缺 keys 時一打開就會彈窗，不用等到開遊戲。
| 原文 | 什麼時候出現 | 原因 | 怎麼修 |
|---|---|---|---|
Derivation Components Missing / Decryption keys are missing. Install them now?（缺少派生元件 / 缺少解密金鑰。現在安裝嗎？） | 每次啟動 | 沒裝 keys | 點 Yes，選 prod.keys（只能選這一個檔案）；之後也可以用 Tools → Install Decryption Keys |
Install decryption keys and restart Eden before attempting to install firmware. | 裝韌體時 | 還沒裝 keys，或裝了沒重啟 | 先裝 keys，關掉 Eden 重新打開，再 Tools → Install Firmware |
Verify your keys file has a .keys extension and try again. | 裝 keys 時 | 副檔名不對，例如 prod.keys.txt | 打開副檔名顯示，改回 prod.keys |
Decryption Keys failed to initialize. Check that your dumping tools are up to date and re-dump keys.（金鑰初始化失敗。請檢查您的轉儲工具是否為最新版本並重新轉儲金鑰。） | 裝 keys 時 | 檔案讀得到，但內容無效、不完整或太舊 | 重新匯出一份新的 prod.keys |
Unable to read key directory, aborting / One or more keys failed to copy. | 裝 keys 時 | 讀不了所在資料夾，或複製失敗，通常是許可權或路徑問題 | 把 prod.keys 放到一個普通資料夾（比如文件）再選 |
Unable to locate potential firmware NCA files | 裝韌體時 | 選的資料夾或 ZIP 裡找不到韌體的 nca 檔案 | 確認選的是韌體本身；Tools → Install Firmware 有 From Folder 和 From ZIP 兩種，別選反 |
Firmware installation cancelled, firmware may be in a bad state or corrupted. Restart Eden or re-install firmware. | 裝韌體中途 | 取消了或中斷了 | 重啟 Eden，重新裝一遍 |
Firmware Corrupted / Firmware reported as present, but was unable to be read. Check for decryption keys and redump firmware if necessary.（韌體已損壞 / 韌體已報告存在，但無法讀取。如有必要請檢查解密金鑰並重新轉儲韌體。） | 開 Home Menu、小程式時 | keys 和韌體不配套（keys 比韌體舊），或韌體檔案壞了 | keys 換成不比韌體舊的版本；還不行重新匯出韌體 |
No firmware available / Firmware missing. Firmware is required to run certain games and use the Home Menu. | 開 Home Menu、小程式時 | 沒裝韌體 | 裝韌體 |
Game Requires Firmware / This game may require firmware to function properly, and you don't have any installed. Please install firmware before launching, or press "OK" to launch anyways.（遊戲需要韌體） | 開遊戲前 | 沒裝韌體 | 裝韌體；也可以按 OK 直接開，但很多遊戲會崩 |
Firmware integrity verification failed! | 校驗韌體時 | 韌體檔案損壞 | 重新匯出韌體 |
Eden 電腦版的 keys 存在數據目錄的 keys 資料夾（Windows 是 %AppData%\eden\keys）。報錯原因看不出來時，到 File → Open Eden Folders → Log Folder 打開日誌 eden_log.txt，求助時附上它。
Eden Android版
Android版的報錯有官方中文翻譯，下面同時列出英文和簡體中文介面的原文。
| 英文原文 | 中文介面 | 原因 | 怎麼修 |
|---|---|---|---|
Encryption keys are missing / Firmware and retail games cannot be decrypted | 金鑰缺失 / 無法解密韌體和商業遊戲 | 沒裝 keys | 首次嚮導，或設定 → 管理 Eden 數據 → 安裝 prod.keys 檔案 |
Skip adding keys? / Valid keys are required to emulate retail games. Only homebrew apps will function if you continue. | 跳過新增金鑰檔案？ | 首次嚮導裡跳過了 keys | 回去裝 keys，否則只能執行自製軟體 |
Failed to Install Keys / Keys failed to initialize. Check that your dumping tools are up to date and re-dump keys. | 金鑰安裝失敗 / 金鑰初始化失敗。請檢查您的轉儲工具是否為最新版本並重新轉儲金鑰。 | keys 檔案無效、不完整或太舊 | 重新匯出 prod.keys |
Verify your keys file has a .keys extension and try again. | 請確保金鑰檔案具有.keys副檔名後重試。 | 檔名被改成 prod.keys(1)、prod (1).keys 之類 | 改回 prod.keys；同一個資料夾裡有多個 keys 檔案時容易選錯 |
Firmware installation failed / Make sure the firmware nca files are at the root of the zip and try again. | 韌體安裝失敗 / 請確保韌體 nca 檔案位於 zip 壓縮包的根目錄，然後重試。 | ZIP 裡有不是 .nca 的檔案（見下一節） | 重新打包 ZIP |
| Fatal Error（裝韌體、裝 keys 時閃出） | 致命錯誤 | 解壓或複製時出錯 | 見下面「Fatal Error」一節 |
Error installing file(s) to NAND / Please ensure content(s) are valid and that the prod.keys file is installed. | 向 NAND 安裝檔案時失敗 / 請確保附加內容的有效性，並且 prod.keys 金鑰檔案已安裝。 | 裝更新 / DLC 時還沒裝 keys，或檔案無效 | 先裝 keys；還不行重新匯出這個檔案 |
Installation of base games isn't permitted in order to avoid possible conflicts. | 為避免產生衝突，此功能不能用於安裝遊戲本體。 | 用「安裝到 NAND」裝了遊戲本體 | 本體用「新增遊戲資料夾」，NAND 安裝只裝更新和 DLC |
System Archive Not Found / %s is missing. Please dump your system archives. Continuing emulation may result in crashes. | 未找到系統檔案 / %s 已丟失。請重新轉儲您的系統檔案。繼續模擬可能會導致崩潰。 | 遊戲要用的韌體元件不存在：沒裝韌體或韌體太舊 | 裝或更新韌體，keys 一起換新 |
| Game Requires Firmware | 遊戲需要韌體 | 沒裝韌體 | 裝韌體 |
Fatal Error / A fatal error occurred. Check the log for details. Continuing emulation may result in crashes. | 發生致命錯誤。請查閱日誌獲取詳細資訊。繼續模擬可能會導致崩潰。 | 遊戲執行中出了未知錯誤 | 設定 → Share Debug Logs 匯出日誌排查 |
本頁的Android原文以 Eden 為準；Citron Neo Android版同屬 yuzu 系，個別文字可能有出入。
韌體 ZIP 為什麼總是「Firmware installation failed」
根據 Eden 原始碼（InstallableActions.kt），Android版裝韌體時會先把 ZIP 解壓到快取資料夾，再數一遍第一層：解壓出來的條目總數和其中 .nca 檔案的數量不一樣，就直接判失敗，子資料夾也算一個條目。所以下面這些都會失敗：
- ZIP 裡多套了一層資料夾（例如
Firmware 21.2.0/xxxx.nca）； - ZIP 裡夾了說明文字、
.txt、.url或其他檔案； - 一個 ZIP 裡又套了一個 ZIP。
修法：把所有 nca 檔案直接選中打包成一個 ZIP，打開 ZIP 第一層就是 nca 檔案。在 Eden 裡選這個 ZIP 檔案本身，不要先解壓。裝成功後，Eden 會用新韌體整個替換掉舊韌體。
Android裝韌體 / keys 時閃出「Fatal Error」
Eden 在解壓或複製檔案時丟擲異常，就會彈「Fatal Error」（致命錯誤），提示裡沒有具體原因。
社群經驗（三星 S22、Galaxy Tab S9 等機型的使用者報告，不保證所有機型都適用）：這是儲存許可權問題。到系統設定的許可權管理裡找到「所有檔案訪問許可權」（不同手機的選單名不同），顯示系統應用，給名為 External storage（外部儲存）的系統元件打開許可權，再回 Eden 重灌。
「Error installing file(s) to NAND」和「不能安裝本體」
Eden 官方文件說明，「安裝到 NAND」（電腦版是 File → Install Files to NAND）是給單獨的更新和 DLC 檔案用的；遊戲本體直接加進遊戲列表就行。用它裝本體會被拒絕，提示 Installation of base games isn't permitted in order to avoid possible conflicts.。
裝更新或 DLC 時報 Error installing file(s) to NAND，先確認 prod.keys 已經裝好；keys 裝好了還報，多半是這個更新 / DLC 檔案不完整，重新匯出一份。
Citron Neo 電腦版
Citron Neo 電腦版用的是舊 yuzu 的寫法，缺 keys 時彈：
Derivation Components Missing
Encryption keys are missing.
For support, please visit Help > Get Support (Discord) in the main emulation window.
所以英文搜「encryption keys are missing」會同時搜到 yuzu、Citron Neo 和 Eden Android版的結果，意思都一樣：還沒裝 prod.keys。裝法和 Eden 電腦版基本相同，裝完重啟。
版本要配套：keys 不能比韌體舊
- keys 至少要和韌體一樣新。 keys 比韌體舊時，韌體能裝進去，但讀不出來，Eden 會報「Firmware Corrupted」，開遊戲還會出現各種解密錯誤。主機升級系統後，keys 和韌體要一起換。
- 韌體也不是越新越好。 截至 2026 年 11 月 1 日，Citron Neo 官網寫的是支援到 21.2.0；沒有模擬器官方宣佈完整支援 23.x 韌體，Eden 關於 23.x 韌體問題的 issue #4414 還沒有關閉。
- 概念和各模擬器的存放位置見 prod.keys、title.keys 和韌體是什麼。
Android驅動管理器：「Error during Fetch」和驅動安裝失敗
Eden Android版設定裡的「GPU 驅動管理器」（GPU driver manager）也常報錯。它和 keys、韌體無關，但都是第一次設定時會碰到的，一併列出：
| 英文原文 | 中文介面 | 原因 | 怎麼修 |
|---|---|---|---|
Error during Fetch / Failed to fetch | 獲取過程中出錯 / 獲取失敗 | Fetch 直接訪問 api.github.com 拉驅動列表；網路連不上 GitHub，或短時間請求太多被限流（GitHub 未登入介面每小時 60 次） | 換個網路，或過一小時再試；也可以從驅動作者的 GitHub 發布頁拿到驅動 zip，用 Install 匯入（不要解壓） |
Downloaded driver is empty, check your internet | 下載的驅動為空，請檢查網路連線 | 下載中斷 | 換網路重試 |
Driver installation failed / Failed to install %1$s driver, does your system support it? | 驅動安裝失敗 / 無法安裝%1$s驅動，您的系統支援嗎? | 不是驍龍手機（Mali、Xclipse 裝不了 Turnip），或者選的 zip 不對 | 天璣、Exynos 手機只能用系統驅動；驍龍手機確認選的是驅動 zip 本身 |
Unsupported GPU / Your GPU does not support driver injection. Attempting to set custom drivers is not recommended. | GPU不支援 / 您的GPU不支援驅動注入。不建議設定自訂驅動。 | 同上，GPU 不支援換驅動 | 用 System Driver |
驅動怎麼選、怎麼換，見 Android Turnip 驅動說明。驅動換完開遊戲報「初始化影片核心時發生錯誤」，見 Vulkan 和影片核心報錯。
常見問題
Eden 提示 Encryption keys are missing（金鑰缺失）怎麼辦？
這是 Eden Android版檢測到還沒裝 prod.keys。在首次設定嚮導，或設定裡的「管理 Eden 數據」（Manage Eden data）中點「安裝 prod.keys 檔案」（Install prod.keys），選擇 prod.keys 即可，只能選這一個檔案。電腦版對應的提示是「Decryption keys are missing. Install them now?」（缺少解密金鑰。現在安裝嗎？），點 Yes 選 prod.keys，裝完重啟 Eden。
Eden Android版韌體安裝失敗（Firmware installation failed）怎麼辦？
Eden 解壓韌體 ZIP 後，只要發現任何一個不是 .nca 的檔案就判失敗，多套一層資料夾也算。重新打包：ZIP 打開後直接就是韌體的 nca 檔案，沒有子資料夾、沒有其他檔案，然後選這個 ZIP，不要先解壓。
Eden 識別不了秘鑰檔案、提示金鑰初始化失敗怎麼辦？
先看提示原文。「Verify your keys file has a .keys extension」是檔名不對，常見的是被改成 prod.keys.txt 或 prod (1).keys，改回 prod.keys 再選。「Keys failed to initialize」是檔案內容有問題：不完整、損壞或版本太舊，重新匯出一份新的 prod.keys。
Eden Android裝韌體或 keys 時閃出 Fatal Error 是什麼原因？
Eden 在解壓或複製檔案時出錯就會彈「Fatal Error」。社群裡三星 S22、Tab S9 等機型的使用者報告是儲存許可權問題：在系統設定的「所有檔案訪問許可權」裡顯示系統應用，給 External storage（外部儲存）元件打開許可權後就能裝。這是社群經驗，不保證所有機型都適用。
Eden 電腦版提示 Install decryption keys and restart Eden before attempting to install firmware？
意思是要先裝解密金鑰，並且重啟 Eden，然後才能裝韌體。按 Tools → Install Decryption Keys 選 prod.keys，關掉 Eden 重新打開，再用 Tools → Install Firmware 裝韌體。
Error installing file(s) to NAND（向 NAND 安裝檔案時失敗）是什麼意思？
安裝更新或 DLC 時失敗。最常見的是還沒裝 prod.keys，或者更新 / DLC 檔案本身無效。先裝好 keys 再裝；還不行就重新匯出這個檔案。遊戲本體不能用「安裝到 NAND」裝，要用新增遊戲資料夾。
Eden 驅動獲取失敗（Error during Fetch）怎麼辦？
Android版「GPU 驅動管理器」的 Fetch 會直接訪問 GitHub 的介面拉取驅動列表。網路連不上 GitHub，或者短時間內請求太多被 GitHub 限流（未登入每小時 60 次），都會報這個。換個網路或過一小時再試；也可以從驅動作者的 GitHub 發布頁拿到驅動 zip，用驅動管理器的 Install 匯入，不用解壓。
Eden 提示 Firmware Corrupted（韌體已損壞）怎麼辦？
韌體裝上了但讀不出來，通常是 keys 比韌體舊，或者韌體檔案壞了。把 keys 換成不比韌體舊的版本；還不行就重新匯出韌體再裝。