> For the complete documentation index, see [llms.txt](https://docs.chiliz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chiliz.com/jp/kaihatsu/kihon/chiliz-chain-setsuzoku/node-jikko.md).

# Chiliz Chain Node を実行する

独自の Chiliz Chain node を実行すると、制御性、プライバシー、信頼性が向上しますが、既存の RPC エンドポイントを使用する場合と比べて、より高度な技術的専門知識とリソースが必要になります。

これにより、Chiliz Chain 上の smart contract とのトランザクションや通信が可能になります。

{% hint style="info" %}
Validator 専用のノード実行ドキュメントページもありますので、ご注意ください: running-a-validator-node.md
{% endhint %}

## **前提条件**

Chiliz Chain node を実行するには、お使いのマシンまたはサーバーに [Docker](https://www.docker.com/) がインストールされている必要があります。そのため、続行する前に [Docker のインストール](https://docs.docker.com/engine/install/) を完了してください。

### **ビルド済み Docker イメージ**

[Docker hub 上の Chiliz Chain 2.0 公開リポジトリ](https://hub.docker.com/repository/docker/chilizchain/ccv2-geth) にあるビルド済みの Docker イメージを使用できます。

## **ノードの起動と同期の開始**

Chiliz Chain node を実行する際の推奨される出発点は、マウントされたデータボリュームを使用する方法です。この方法で Docker コンテナを再作成すると、データはディレクトリに保存され、簡単に再利用したり、別の node にクローンしたりできます。

### **ステップ 1: ディレクトリの作成**

ディレクトリを作成し、次のコマンドの `-v` パラメータでそれを指定します:

```bash
docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 8545:8545 \
-p 8546:8546 \
chilizchain/ccv2-geth:latest \
--chiliz # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
--datadir=/datadir \
--ipcdisable
```

### **ステップ 2: クライアントの接続**

クライアントを node に接続するには、それぞれ `--http` および/または `--ws` のパラメータグループを指定して、RPC HTTP および/または WebSocket サーバーを有効にする必要があります。

例えば:

```bash
docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 8545:8545 \
-p 8546:8546 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
--datadir=/datadir \
--ipcdisable \
--http \
--http.addr=0.0.0.0 \
--http.api=eth,net,web3,debug,txpool \
--http.port=8545 \
--http.corsdomain="*" \
--http.vhosts="*" \
--ws \
--ws.addr=0.0.0.0 \
--ws.api=eth,net,web3,debug,txpool \
--ws.port=8546 \
--ws.origins="*" \
```

{% hint style="warning" %}
**注意**

セキュリティ上の理由から、以下のパラメータに適切な値を設定してください:

`--http.corsdomain`

`--http.vhosts`

`--ws.origins`
{% endhint %}

## **ノードのメンテナンス情報**

### デバッグ時の verbosity の変更

場合によっては、node の verbosity を上げたいことがあります。つまり、node または接続するクライアント自体をデバッグする必要がある場合です。

そのためには、`--verbosity` パラメータを定義できます。以下のオプションを受け付けます（デフォルトは 3 です）:

* 0=silent
* 1=error
* 2=warn
* 3=info
* 4=debug
* 5=detail

### ノードの停止とクリーンアップ

上記のいずれかのコマンドを使用して node を起動した場合、node プロセスはフォアグラウンドで実行され続けます。このプロセスを停止するには、CTRL+C を押してください。

次のコマンドを実行して Docker コンテナを削除します:

```bash
docker rm ccv2-node
```

### **ディレクトリの削除**

次のコマンドを実行してディレクトリを削除します:

```bash
rm my-datadir
```

## ノードの更新

Chiliz Chain チームは Chiliz Chain を安全かつ最新の状態に保つよう努めており、そのため Dragon8 hard fork のように、毎年時折 hard fork を実施します。

hard fork が発生すると、お使いの node はネットワークと同期しなくなります。そのため、私たちのアナウンスをフォローし、node を更新することが重要です。

node を最新の状態に保つには、以下の手順に従ってください。

**Docker を使用している場合:**

1. データベースを含むボリュームを保持したまま、既存の Docker コンテナを停止して削除してください。
2. [利用可能な最新のビルド済み Docker イメージ](https://hub.docker.com/repository/docker/chilizchain/ccv2-geth) を使用して node を起動します。

**独自のバイナリを使用している場合:**

1. [GitHub リポジトリから最新のリリースをダウンロードします](https://github.com/chiliz-chain/v2/releases)。
2. そこからお使いのツールセットでビルドします。

## archive node の実行

node を archive モードで実行するには、上記で示した `ccv2-geth` の呼び出しに次の 2 つのパラメータを追加する必要があります:

```bash
--syncmode=full \
--gcmode=archive \
```

## スナップショットまたはバックアップからの Chiliz Chain ノードの実行

Chiliz Chain node の同期プロセスを高速化するために、スナップショット（ブロックチェーンデータディレクトリ（`datadir`）の最近のコピー（またはアーカイブ/バックアップ））を利用できます。この方法では、ゼロから同期する場合と比べて、node をより迅速に稼働させることができます。

{% hint style="info" %}
新しい node のセットアップにはスナップショットを保持することをお勧めします。\
既存の datadir をスナップショットで上書きすると、不整合が生じる可能性があります。
{% endhint %}

### 利用可能なスナップショット

各ネットワークには専用のスナップショットがあります:

* Spicy Testnet: [chaindata\_snapshot.tar.gz](https://s3.eu-west-3.amazonaws.com/spicy-snapshots.chiliz.com/chaindata_snapshot.tar.gz)
* Chiliz Chain Mainnet: [chaindata\_snapshot.tar.gz](https://s3.eu-west-3.amazonaws.com/snapshots.chiliz.com/chaindata_snapshot.tar.gz)

{% hint style="info" %}
**既存データのクリーニング**

既存の node にスナップショットを適用する場合は、node を再起動する前に、datadir 内の以下のディレクトリとファイルを削除してください:

```bash
rm -rf blobpool transactions.rlp LOCK lightchaindata triecache
```

この手順により、残存データから生じる潜在的な競合を防ぐことができます。
{% endhint %}

### スナップショットから node を実行する手順:

1. データディレクトリを作成します:

```bash
mkdir -p ~/chiliz-node/my-datadir
```

2. スナップショットをダウンロードします:

必要に応じて URL を Mainnet スナップショットの URL に置き換えてください。

{% code overflow="wrap" lineNumbers="true" %}

```bash
cd ~/chiliz-node/my-datadir
nohup curl -L --retry 5 -o chaindata.tar.gz https://s3.eu-west-3.amazonaws.com/spicy-snapshots.chiliz.com/chaindata_snapshot.tar.gz > download.log 2>&1 &
```

{% endcode %}

{% hint style="info" %}
ダウンロードの進捗を監視するには、次を使用します:\
`tail -f download.log`
{% endhint %}

3. スナップショットを展開します:

```bash
tar -xzf chaindata.tar.gz
```

4. Chiliz Chain node を実行します:

{% code lineNumbers="true" %}

```bash
docker run \
  -v ~/chiliz-node/my-datadir:/datadir \
  --name ccv2-node \
  -p 8545:8545 \
  -p 8546:8546 \
  chilizchain/ccv2-geth:latest \
  --spicy \  # Use --chiliz for Mainnet
  --datadir=/datadir \
  --ipcdisable \
  --http \
  --http.addr=0.0.0.0 \
  --http.api=eth,net,web3,debug,txpool \
  --http.port=8545 \
  --http.corsdomain="*" \
  --http.vhosts="*" \
  --ws \
  --ws.addr=0.0.0.0 \
  --ws.api=eth,net,web3,debug,txpool \
  --ws.port=8546 \
  --ws.origins="*"
```

{% endcode %}

## Geth に関する追加情報

利用可能な Geth パラメータの完全なリストを表示するには、Geth の [command-line options](https://geth.ethereum.org/docs/fundamentals/command-line-options) をご覧ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chiliz.com/jp/kaihatsu/kihon/chiliz-chain-setsuzoku/node-jikko.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
