Base Node: Chạy Base Node Bằng Docker

Base Node Là Gì?

Base Node là tên gọi cho bộ cấu hình Docker của base/node, chạy một full node cho Base L2 bằng cách dùng base-reth-node làm execution client và base-consensus làm consensus client. Nó kết nối tới RPC và beacon endpoint của một node Ethereum L1 mà bạn tự cung cấp, thay vì đóng gói sẵn một L1 node bên trong, và bao phủ cả mạng Base mainnet lẫn Base Sepolia.

Tính Năng Chính Cho Người Vận Hành Node

• ✓Stack Docker Compose ghép base-reth-node (execution client) với base-consensus (consensus client), nên hai client khởi động cùng nhau thay vì phải tự nối bằng tay.
• ✓Hỗ trợ cả Base mainnet và Base Sepolia testnet, chuyển đổi giữa .env.mainnet và .env.sepolia bằng biến NETWORK_ENV.
• ✓Chế độ Flashblocks: đặt RETH_FB_WEBSOCKET_URL sẽ chuyển execution client sang chế độ Flashblocks, truy vấn được qua eth_getBlockByNumber với tham số block pending tại cổng 8545.
• ✓Follow mode qua BASE_NODE_SOURCE_L2_RPC, dùng để đồng bộ từ một nguồn RPC L2 khác thay vì từ các peer của chính mạng.
• ✓Kiểm soát pruning qua RETH_PRUNING_ARGS để giới hạn lượng lịch sử chain mà execution client giữ lại.
• ✓Đồng bộ hỗ trợ snapshot, với link và các bước khôi phục được ghi tại docs.base.org thay vì phải đồng bộ từ genesis.

Bắt Đầu Với Base Node

Clone base/node, sau đó chọn mạng: dùng .env.mainnet cho Base mainnet hoặc .env.sepolia cho Base Sepolia. Đặt BASE_NODE_L1_ETH_RPC và BASE_NODE_L1_BEACON trong file đó để trỏ tới RPC và beacon endpoint của một node Ethereum L1 mà bạn đã có sẵn — base/node không đóng gói sẵn L1 node, nên bạn cần chuẩn bị trước. Sau đó chạy `docker compose up --build` cho mainnet, hoặc `NETWORK_ENV=.env.sepolia docker compose up --build` cho Sepolia. Cả Docker và Docker Compose đều cần được cài sẵn trên máy chủ. Nếu muốn đồng bộ nhanh hơn, docs.base.org có hướng dẫn khôi phục từ snapshot thay vì đồng bộ từ genesis.

Cấu Hình Base Node Của Bạn

Bốn biến cấu hình chính điều khiển node: BASE_NODE_L1_ETH_RPC và BASE_NODE_L1_BEACON trỏ tới L1 node của bạn, còn BASE_NODE_NETWORK và RETH_CHAIN chọn mạng — cả hai đặt là base cho mainnet hoặc base-sepolia cho Sepolia. Mỗi mạng cũng có sequencer endpoint riêng (mainnet-sequencer.base.org hoặc sepolia-sequencer.base.org). Ngoài cấu hình cơ bản đó, ba biến tuỳ chọn thay đổi hành vi: RETH_FB_WEBSOCKET_URL bật chế độ Flashblocks, BASE_NODE_SOURCE_L2_RPC bật follow mode với một RPC L2 khác, và RETH_PRUNING_ARGS cắt bớt lượng lịch sử mà execution client giữ lại. Danh sách đầy đủ các tuỳ chọn nằm trong .env.mainnet và .env.sepolia, chứ không phải trong README.

Lựa Chọn Thay Thế Cho Việc Tự Chạy Node

Câu Hỏi Thường Gặp

Vấn đề Base Node giải quyết

Vận hành hạ tầng phụ thuộc vào Base mà không có node riêng nghĩa là phải tin tưởng một bên thứ ba cho mọi lượt đọc trạng thái Base, và phải chấp nhận bất kỳ phiên bản client hay cấu hình nào bên đó chọn. base/node đóng gói base-reth-node và base-consensus vào một stack Docker Compose trỏ tới endpoint L1 của riêng bạn, nên người vận hành cần quyền kiểm soát trực tiếp trạng thái đồng bộ, truy vấn lịch sử, hay dữ liệu pending block của Flashblocks không phải tự ghép một cặp node OP Stack từ đầu.

Trường hợp sử dụng tốt nhất

• •Các đội vận hành hạ tầng phụ thuộc vào Base (indexer, block explorer, cầu nối) cần truy cập RPC trực tiếp thay vì đi qua một bên thứ ba cho mọi request.
• •Nhà phát triển kiểm thử phản hồi pending block của Flashblocks bằng cách đặt RETH_FB_WEBSOCKET_URL rồi gọi eth_getBlockByNumber với tham số pending.
• •Người vận hành chạy Base Sepolia cục bộ để phát triển trên testnet, chuyển mạng bằng NETWORK_ENV=.env.sepolia.
• •Bất kỳ ai muốn đồng bộ từ snapshot thay vì từ genesis để rút ngắn thời gian đồng bộ ban đầu, theo các bước khôi phục tại docs.base.org.

Ai nên dùng — và ai nên bỏ qua

Hãy thử Base Node nếu bạn đang vận hành hạ tầng đọc trạng thái chain của Base liên tục — một indexer, một cầu nối, một block explorer — và chi phí lặp lại hay giới hạn rate của một RPC được lưu trữ sẵn vượt quá công sức tự chạy một máy có 32GB+ RAM và ổ NVMe. Bỏ qua nếu bạn chỉ cần gọi RPC Base thỉnh thoảng cho một ứng dụng nhỏ: dựng RPC và beacon endpoint L1 cộng bài toán lưu trữ mà README đặt ra là quá nhiều hạ tầng để sở hữu cho lưu lượng nhẹ. Hãy xem việc không có bảo hành trong disclaimer là một thực tế vận hành thật sự, không phải câu chữ hình thức, nếu bạn chạy thứ này trong môi trường gần giống production.