固定

檔案如何在 IPFS 網路上持久存在，以及為什麼固定很重要。

垃圾回收問題

IPFS 節點的儲存空間有限。為了管理磁碟空間，它們會定期執行垃圾回收 — 一個清除未被明確標記為重要的快取資料的程序。沒有介入，您上傳的檔案可能在幾小時內就從網路中被清除。

固定告訴 IPFS 節點：「永久保留此檔案 — 不要對其進行垃圾回收。」被固定的檔案會無限期地留在節點的儲存中，確保在網路上保持可用。

本機固定 vs. 遠端固定

本機固定意味著執行自己的 IPFS 節點並將檔案固定到該節點。您需要負責正常執行時間、儲存和網路連線。如果您的節點離線，檔案將變得不可用。

遠端固定（IPFS.NINJA 提供的服務）意味著由代管服務在始終在線的基礎設施上固定您的檔案。您無需執行自己的節點即可獲得固定的持久性。

TIP

透過 IPFS.NINJA 上傳的每個檔案都會自動固定到我們的 IPFS 叢集。無需額外步驟 — 您的檔案從上傳那一刻起就是持久的。

取消固定後會發生什麼

如果您從 IPFS.NINJA 帳戶中刪除檔案，我們會從節點上取消固定。但如果以下情況，檔案可能仍然可存取：

• 其他 IPFS 節點快取或固定了相同的 CID
• IPFS 閘道在其快取中有該檔案
• 另一個使用者上傳了相同的內容（相同的 CID = 相同的檔案）

隨著時間推移，如果沒有節點固定該 CID，檔案將從網路中被完全垃圾回收。

固定最佳實務

• 儘早固定 — 在智慧合約、NFT 中繼資料或外部系統中參照 CID 之前，先上傳並固定您的內容。
• 不要依賴快取 — IPFS 閘道快取是暫時的。只有固定的內容才能保證持久存在。
• 保持帳戶活躍 — 只要您的 IPFS.NINJA 帳戶處於活躍狀態，即使在免費層級，檔案也會保持固定。

固定現有內容

您不必透過 IPFS.NINJA 上傳檔案才能固定它。如果內容已經存在於 IPFS 網路上 — 由其他人上傳的，或者您透過另一個服務上傳的 — 您可以透過提供其 CID 將其固定到您的帳戶。

當您固定現有 CID 時，我們的叢集會：

1. 在 IPFS 網路上搜尋擁有該內容的節點
2. 從最近的可用節點下載內容
3. 在我們的基礎設施上本機固定
4. 使其可透過您的帳戶和閘道存取

這對以下情境很有用：

• 保存 NFT 資產 — 固定現有收藏集的中繼資料和圖片
• 備份內容 — 確保重要的 CID 即使原始固定者離線也保持可用
• 從其他服務遷移 — 固定現有 CID 而無需重新上傳檔案

詳情請參閱固定 API 文件。