Chạy một Node Chiliz Chain

Khởi chạy, tạo, kết nối và gỡ lỗi một node để đồng bộ với Chiliz Chain

Việc chạy node Chiliz Chain của riêng bạn mang lại khả năng kiểm soát, quyền riêng tư và độ tin cậy cao hơn, nhưng đòi hỏi nhiều chuyên môn kỹ thuật và tài nguyên hơn so với việc sử dụng một RPC endpoint có sẵn.

Nó cho phép bạn giao dịch và tương tác với các smart contract trên Chiliz Chain

Lưu ý rằng có một trang tài liệu riêng dành cho việc chạy node của Validator: chay-mot-node-nha-xac-thuc.md

Điều kiện tiên quyết

Để chạy node Chiliz Chain, bạn phải cài đặt Docker, trên máy tính hoặc trên máy chủ của bạn. Do đó, vui lòng hoàn tất cài đặt Docker trước khi tiếp tục.

Docker image dựng sẵn

Bạn có thể sử dụng các Docker image dựng sẵn từ kho lưu trữ công khai Chiliz Chain 2.0 trên Docker hub.

Khởi chạy một node và bắt đầu đồng bộ

Điểm khởi đầu được khuyến nghị để chạy một node Chiliz Chain là sử dụng data volume được gắn (mounted). Nếu phương pháp này được dùng để tái tạo một Docker container, dữ liệu sẽ được lưu trong thư mục và có thể dễ dàng tái sử dụng hoặc nhân bản sang một node khác.

Bước 1: Tạo một thư mục

Tạo một thư mục và trỏ tới nó trong tham số -v của lệnh sau:

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

Bước 2: Kết nối Client

Để kết nối một client với một node, bạn phải bật RPC HTTP và/hoặc các WebSocket server bằng cách chỉ định nhóm tham số --http và/hoặc --ws tương ứng.

Ví dụ:

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="*" \

THẬN TRỌNG

Vì lý do bảo mật, hãy đảm bảo bạn đặt các giá trị phù hợp cho những tham số sau:

--http.corsdomain

--http.vhosts

--ws.origins

Thông tin bảo trì Node

Thay đổi độ chi tiết (verbosity) khi gỡ lỗi

Trong một số trường hợp, bạn có thể muốn tăng độ chi tiết của node, tức là khi bạn cần gỡ lỗi cho node hoặc cho chính client đang kết nối.

Để làm điều đó, bạn có thể định nghĩa một tham số --verbosity. Nó có thể nhận các tùy chọn sau (mặc định là 3):

• 0=silent

• 1=error

• 2=warn

• 3=info

• 4=debug

• 5=detail

Dừng node và dọn dẹp

Nếu bạn đã khởi chạy node bằng một trong các lệnh trên thì tiến trình node của bạn tiếp tục chạy ở foreground. Để dừng tiến trình này, hãy nhấn CTRL+C.

Chạy lệnh sau để xóa Docker container:

docker rm ccv2-node

Xóa thư mục

Chạy lệnh sau để xóa một thư mục:

rm my-datadir

Cập nhật Node của bạn

Đội ngũ Chiliz Chain nỗ lực giữ cho Chiliz Chain an toàn và hiện đại, và do đó thỉnh thoảng chúng tôi sẽ thực hiện hard fork hàng năm, chẳng hạn như hard fork Dragon8.

Trong trường hợp xảy ra hard fork, node của bạn sẽ không còn đồng bộ với mạng lưới. Vì vậy, điều quan trọng là phải theo dõi các thông báo của chúng tôi và cập nhật node của bạn.

Để giữ cho node của bạn được cập nhật, bạn có thể làm theo các bước sau.

Nếu bạn dùng Docker:

1. Đảm bảo bạn dừng và xóa Docker container hiện có của mình trong khi vẫn giữ lại các volume chứa cơ sở dữ liệu của bạn.

2. Khởi chạy node của bạn bằng Docker image dựng sẵn mới nhất hiện có.

Nếu bạn dùng binary của riêng mình:

1. Tải bản phát hành mới nhất từ kho lưu trữ GitHub của chúng tôi.

2. Build từ đó bằng bộ công cụ của bạn.

Chạy một archive node

Để chạy một node ở chế độ archive, bạn nên thêm 2 tham số sau vào lệnh ccv2-geth được trình bày ở trên:

--syncmode=full \
--gcmode=archive \

Chạy một Node Chiliz Chain từ Snapshot hoặc Backup

Để tăng tốc quá trình đồng bộ của node Chiliz Chain, bạn có thể dựa vào một snapshot — một bản sao gần đây (hoặc archive/backup) của thư mục dữ liệu blockchain (datadir). Phương pháp này cho phép node của bạn đi vào hoạt động nhanh hơn so với việc đồng bộ từ đầu.

Khuyến nghị giữ lại các snapshot cho các thiết lập node mới. Việc ghi đè một datadir hiện có bằng một snapshot có thể dẫn đến những điểm không nhất quán.

Các Snapshot có sẵn

Mỗi mạng lưới có một snapshot riêng:

• Spicy Testnet: chaindata_snapshot.tar.gz

• Chiliz Chain Mainnet: chaindata_snapshot.tar.gz

Dọn dẹp dữ liệu hiện có

Nếu bạn có ý định áp dụng một snapshot cho một node hiện có, hãy đảm bảo bạn xóa các thư mục và tệp sau bên trong datadir của bạn trước khi khởi động lại node:

rm -rf blobpool transactions.rlp LOCK lightchaindata triecache

Bước này giúp ngăn ngừa các xung đột tiềm ẩn phát sinh từ dữ liệu còn sót lại.

Các bước để chạy một Node từ Snapshot:

1. Tạo một thư mục dữ liệu:

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

1. Tải xuống Snapshot:

Thay thế URL bằng URL snapshot Mainnet nếu cần.

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 &

Để theo dõi tiến độ tải xuống, hãy dùng: tail -f download.log

1. Giải nén Snapshot:

tar -xzf chaindata.tar.gz

1. Chạy Node Chiliz Chain:

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="*"

Thông tin bổ sung về Geth

Truy cập các tùy chọn dòng lệnh của Geth để xem danh sách đầy đủ các tham số Geth có sẵn.