ピン留め

ファイルが 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 ドキュメントをご覧ください。