如何在 IPFS 上託管 NFT 映像？ （皮納塔指南）

了解 IPFS 及其在 NFT 儲存中的作用

1. IPFS 代表星際檔案系統，是一種點對點超媒體協議，旨在使網路更快、更安全、更開放。

2. 與透過伺服器位址定位檔案的傳統 HTTP 不同，IPFS 透過其獨特的加密雜湊來檢索內容，從而確保不變性和完整性。

3. NFT 依賴外部儲存來儲存媒體資產，因為以太坊等區塊鏈網路由於成本和可擴展性限制，不會直接在鏈上儲存大型二進位檔案。

4. 將影像檔案儲存在 IPFS 上可以確保只要至少一個節點固定內容，資產就可以保持可存取性，從而避免集中故障點。

5. IPFS 產生的內容識別碼（CID）成為嵌入 NFT 元資料 JSON 檔案中的規範引用，將令牌連結到其視覺表示。

設定 Pinata 帳戶和 API 訪問

1. 造訪 pinata.cloud 並使用電子郵件或 GitHub 驗證註冊免費帳戶。

2. 導覽至您的個人資料設定下的「API 金鑰」部分，以產生一組啟用「Pin」權限的新金鑰。

3. 複製 JWT 令牌和 API 金鑰對 - 以程式設計方式或透過 CLI 工具與 Pinata 的 REST API 互動時需要這些憑證。

4. Pinata 提供公共網關，例如 https://gateway.pinata.cloud/ipfs/，允許任何人無需身份驗證即可解析 CID，從而實現去中心化存取。

5. 免費層用戶每月可獲得 1GB 固定儲存和有限的 API 調用，足以啟動小型 NFT 集合或測試工作流程。

使用 Pinata Web 介面上傳 NFT 影像

1. 登入 Pinata 儀表板，然後按一下頂部導覽列中的「固定檔案」。

2. 將單一影像檔案（或包含多個資產的 ZIP 檔案）拖曳到上傳區域。

3. 上傳完成後，Pinata 顯示 CID、檔案名稱、大小和時間戳記；它還顯示檔案是否固定到 Pinata 的基礎設施。

4. 按一下任何上傳項目旁的三點選單以複製其 CID 或產生可共用網關 URL。

5. 對於批次處理，在上傳之前以一致的命名約定組織圖像，以簡化以後的元資料生成。

使用 Pinata SDK 和 CLI 工具自動上傳

1. 透過 npm 安裝官方 Pinata SDK： npm install @pinata/sdk 。

2. 使用 API 金鑰和金鑰在 Node.js 腳本中初始化客戶端，然後使用可讀流或緩衝區呼叫pinFileToIPFS() 。

3. 使用pinata-cli套件從終端上傳： pinata pin add ./images/ ，支援遞迴目錄上傳。

4. 將上傳邏輯整合到鑄幣腳本中，以便每個影像在將元資料寫入區塊鏈之前立即接收 CID。

5. 將傳回的 CID 與對應的代幣 ID 一起儲存在本機 JSON 檔案或資料庫中，以在合約部署期間保持可追溯性。

常見問題解答

Q：影像固定到 IPFS 後可以更新嗎？答：不會。 IPFS 內容在設計上是不可變的。要更改圖像，您必須重新上傳它並獲取新的 CID，然後相應地更新 NFT 的元資料。

Q：如果 Pinata 離線會怎樣？答：您的檔案透過快取或固定它們的其他 IPFS 節點仍然可用。 cloudflare-ipfs.com 或 dweb.link 等公共閘道也獨立提供相同的 CID。

Q：每次鑄造後我需要再次固定我的 NFT 影像嗎？答：不一定。如果所有 NFT 都引用相同的圖像或使用基於模板的結構（其中變化是在鏈外處理的），則一次性上傳就足夠了。

Q：有沒有辦法驗證我的圖片是否仍然被固定？答：是的。使用 Pinata 的pinList端點或透過curl 檢查狀態： curl 'https://api.pinata.cloud/data/pinList?ipfsPinHash= CID_HERE ' -H 'Authorization: Bearer YOUR_JWT' 。