mcpField
R
running-a-base-node

running-a-base-node

github.com/baseクラウド・DevOps120316 回インストール1 日前に更新
リポジトリ

running-a-base-node について

安定した RPC アクセスを必要とする本番アプリ向けに、Reth を使った Base ノードの構築と運用を案内するスキルです。ハードウェア、ネットワーク、セキュリティ、同期、同期完了の確認を扱います。

主な機能

  1. 01Reth クライアントの選定
  2. 02RPC アクセスのセキュリティ指針
  3. 03ハードウェアとポート要件
  4. 04同期とスナップショットの案内
  5. 05同期状態の確認

活用シーン

  1. 01Base ノードのハードウェア計画
  2. 02RPC エンドポイントへのアクセス制限
  3. 03スナップショットによる初期同期の短縮
  4. 04デプロイ前のノード稼働確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/base/skills --skill running-a-base-node

インストール後、Claude Code で/running-a-base-nodeを入力して読み込まれたか確認します。

詳細

Base ノードの実行

信頼性の高い無制限の RPC アクセスを必要とする本番アプリ向けです。

セキュリティ

  • RPC アクセスを制限する — 127.0.0.1 またはプライベートインターフェースにバインドし、認証なしで RPC ポート（8545／8546）をパブリックインターネットに公開しないでください
  • ファイアウォールルール — パブリック向けに開放するポートは 9222（Discovery v5）と 30303（P2P）のみにし、それ以外のすべての受信トラフィックをブロックしてください
  • 最小限のファイルシステム権限を持つ非 root ユーザーとして実行する
  • RPC エンドポイントをリモートクライアントに公開する場合は、TLS 終端を使用する（nginx／caddy を使ったリバースプロキシ）
  • 不正アクセスを監視する — 想定外の RPC 呼び出しや接続数の急増をログに記録し、アラートを設定してください

ハードウェア要件

  • CPU：最低 8 コア
  • RAM：最低 16 GB
  • ストレージ：NVMe SSD、計算式：(2 × chain_size) + snapshot_size + 20% buffer

ネットワーク

必須ポート：

  • ポート 9222：Reth Discovery v5 に必須
  • ポート 30303：P2P Discovery と RLPx

これらのポートがブロックされていると、ノードはピアの検出や同期が困難になります。

クライアントの選択

Base ノードには Reth を使用してください。Geth Archive Node はサポート対象外になりました。

Reth の特長：

  • 高スループットの L2 で優れたパフォーマンスを発揮
  • アーカイブノードを標準でサポート

同期

  • 初回の同期には 数日かかります
  • 外部プロバイダーを使用する場合、RPC クォータを大量に消費します
  • 同期を高速化するにはスナップショットを使用してください（URL は Base のドキュメントで確認してください）

同期ステータス

同期未完了の兆候：デプロイ時に発生する Error: nonce has already been used

同期を確認するには：

  • 最新のブロックをエクスプローラーと比較する
  • ピア接続を確認する
  • ログで進捗を監視する

コメント

Markdown 対応