naver.HOW data lake by AI

실전 이더리움 노드 구축 가이드: Geth와 Lighthouse 설정하기

Written by

sp

in

블록체인 기술의 진화와 함께 이더리움은 PoW(Proof of Work)에서 PoS(Proof of Stake) 메커니즘으로 성공적으로 전환했습니다. 이 변화는 네트워크의 에너지 효율성과 보안성을 크게 향상시켰지만, 노드 운영 방식에도 중요한 변화를 가져왔습니다. 현대 이더리움 네트워크에서는 실행 계층(Execution Layer)과 합의 계층(Consensus Layer) 클라이언트를 함께 운영해야 합니다. 이 글에서는 가장 널리 사용되는 클라이언트 조합인 Geth(실행 계층)와 Lighthouse(합의 계층)를 설정하는 방법을 상세히 살펴보겠습니다.

이더리움 노드 구조 이해하기

현재 이더리움 네트워크는 두 개의 핵심 계층으로 구성됩니다:

  1. 실행 계층(Execution Layer): 이전의 이더리움 1.0에 해당하며, 거래 처리와 상태 관리를 담당합니다. Geth, Erigon, Nethermind, Besu 등의 클라이언트가 있습니다.
  2. 합의 계층(Consensus Layer): 이전의 비콘 체인(Beacon Chain)으로 알려졌으며, 블록 생성자 선택과 네트워크 합의를 관리합니다. Lighthouse, Prysm, Teku, Nimbus 등의 클라이언트가 있습니다.

두 계층은 Engine API를 통해 통신하며, 안전한 통신을 위해 JWT(JSON Web Token) 인증 방식을 사용합니다. 노드 운영을 위해서는 두 계층의 클라이언트를 모두 실행하고 올바르게 연결해야 합니다.

필요 사항

이더리움 노드를 구축하기 전에 다음 요구사항을 확인하세요:

  • 하드웨어 요구사항:
    • CPU: 4코어 이상의 최신 프로세서
    • RAM: 최소 16GB (32GB 권장)
    • 스토리지: SSD 최소 2TB (메인넷 전체 동기화 기준)
    • 네트워크: 안정적인 인터넷 연결 (최소 25Mbps 업로드/다운로드)
  • 소프트웨어 요구사항:
    • 최신 버전의 운영 체제 (Linux, macOS, Windows)
    • Rust 프로그래밍 환경 (Lighthouse용)
    • Go 프로그래밍 환경 (Geth용)

단계별 설정 가이드

1. 실행 환경 준비하기

먼저 필요한 소프트웨어를 설치하고 디렉토리 구조를 생성합니다.

# 작업 디렉토리 생성
mkdir -p ~/ETH
cd ~/ETH

# 설정 파일용 디렉토리 생성
mkdir -p config
mkdir -p geth-data
mkdir -p lighthouse-data

2. JWT 비밀키 생성하기

Geth와 Lighthouse가 서로 안전하게 통신하기 위한 JWT 토큰을 생성합니다.

# JWT 비밀키 생성
openssl rand -hex 32 > ~/ETH/config/jwt.hex

# 파일 권한 설정
chmod 600 ~/ETH/config/jwt.hex

3. Geth 설치 및 실행하기

Geth는 이더리움의 실행 계층 클라이언트로, 트랜잭션 처리와 상태 관리를 담당합니다.

macOS에서 Homebrew를 통한 설치:

# Homebrew를 통한 Geth 설치
brew tap ethereum/ethereum
brew install ethereum

Geth 실행하기:

# Geth 실행 (메인넷)
geth --datadir ~/ETH/geth-data \
  --authrpc.addr localhost \
  --authrpc.port 8551 \
  --authrpc.vhosts localhost \
  --authrpc.jwtsecret ~/ETH/config/jwt.hex \
  --http \
  --http.api eth,net,engine,admin \
  --syncmode snap

주요 매개변수 설명:

  • --datadir: Geth 데이터를 저장할 디렉토리
  • --authrpc.jwtsecret: 합의 계층과 통신하기 위한 JWT 비밀키 경로
  • --syncmode snap: 빠른 초기 동기화를 위한 스냅 모드 사용

4. Lighthouse 설치 및 실행하기

Lighthouse는 이더리움의 합의 계층 클라이언트로, 비콘 체인 동기화와 검증을 담당합니다.

macOS에서 Homebrew를 통한 설치:

# Lighthouse 설치
brew tap sigp/lighthouse
brew install lighthouse

Rust를 통한 소스 코드 빌드 (Homebrew가 작동하지 않는 경우):

# Rust 설치 및 업데이트
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
rustup update stable

# Lighthouse 저장소 클론 및 빌드
cd ~/ETH
git clone https://github.com/sigp/lighthouse.git
cd lighthouse
cargo build --release

Lighthouse 비콘 노드 실행하기:

# Lighthouse 비콘 노드 실행 (Homebrew 설치 시)
lighthouse bn \
  --network mainnet \
  --datadir ~/ETH/lighthouse-data \
  --execution-endpoint http://localhost:8551 \
  --execution-jwt ~/ETH/config/jwt.hex \
  --checkpoint-sync-url https://mainnet.checkpoint.sigp.io \
  --http

# 소스 코드에서 빌드한 경우
~/ETH/lighthouse/target/release/lighthouse bn \
  --network mainnet \
  --datadir ~/ETH/lighthouse-data \
  --execution-endpoint http://localhost:8551 \
  --execution-jwt ~/ETH/config/jwt.hex \
  --checkpoint-sync-url https://mainnet.checkpoint.sigp.io \
  --http

주요 매개변수 설명:

  • --network mainnet: 이더리움 메인넷 사용
  • --execution-endpoint: Geth 실행 계층 엔드포인트
  • --execution-jwt: JWT 비밀키 경로
  • --checkpoint-sync-url: 체크포인트 동기화를 위한 URL (초기 동기화 시간 단축)

동기화 상태 확인하기

노드 설정 후 동기화 상태를 확인하는 방법입니다.

Geth 동기화 상태 확인:

# Geth 콘솔 연결
geth attach http://localhost:8545

# 콘솔에서 동기화 상태 확인
> eth.syncing

Lighthouse 동기화 상태 확인:

# HTTP API를 통한 동기화 상태 확인
curl -X GET "http://localhost:5052/eth/v1/node/syncing" -H "accept: application/json"

로컬 개발 네트워크 실행하기

메인넷 대신 로컬 개발 네트워크를 실행하려면 다음 명령을 사용할 수 있습니다.

# Geth 개발 모드 실행
geth --datadir ~/ETH/geth-dev \
  --dev \
  --http \
  --http.api eth,net,web3,personal \
  --http.corsdomain "*" \
  --allow-insecure-unlock

이 모드는 테스트 및 개발용으로 사전 자금이 지급된 계정을 제공합니다.

문제 해결 가이드

1. “Post-merge network, but no beacon client seen” 경고

이 경고는 Geth가 실행 중이지만 비콘 클라이언트(Lighthouse)와 연결되지 않았음을 의미합니다.

해결 방법:

  • JWT 비밀키가 두 클라이언트에서 동일한지 확인
  • Lighthouse 실행 시 엔드포인트 주소와 포트가 올바른지 확인
  • 로그에서 연결 오류 확인

2. Lighthouse 빌드 에러: “lock file version 4 was found…”

이 오류는 Cargo(Rust 패키지 관리자)의 버전이 너무 낮아 최신 형식의 lock 파일을 이해하지 못할 때 발생합니다.

해결 방법:

rustup update stable

3. 불완전한 다운로드 문제 (9바이트 파일)

바이너리 다운로드가 실패하고 9바이트 크기의 파일만 저장되는 경우가 있습니다.

해결 방법:

# 다른 다운로드 방법 시도
wget https://github.com/sigp/lighthouse/releases/download/v5.1.3/lighthouse-v5.1.3-aarch64-apple-darwin.tar.gz

보안 및 성능 최적화 팁

보안 강화하기

  1. SSH 키 인증 설정: 암호 기반 로그인 대신 SSH 키 인증 사용
  2. 방화벽 구성: 필요한 포트만 개방 (Geth: 30303, Lighthouse: 9000)
  3. 업데이트 유지: 클라이언트를 최신 버전으로 정기적으로 업데이트

성능 최적화하기

  1. 하드웨어 스케일링: 노드 성능은 하드웨어에 크게 의존합니다. 충분한 CPU, RAM, 빠른 SSD를 확보하세요.
  2. 네트워크 최적화: 안정적인 인터넷 연결과 충분한 대역폭 확보
  3. 동기화 모드 선택: 초기 동기화에 snap 모드를 사용하고, Lighthouse에서 체크포인트 동기화 활용

결론

이더리움 노드 구축은 블록체인 기술을 심층적으로 이해하고 네트워크에 직접 참여할 수 있는 귀중한 경험입니다. Geth와 Lighthouse를 함께 설정함으로써 현대 이더리움 네트워크의 두 핵심 계층을 모두 운영할 수 있게 됩니다. 초기 설정 과정은 다소 복잡할 수 있지만, 올바르게 구성된 노드는 안정적으로 작동하며 이더리움 생태계의 중요한 부분이 됩니다.

노드를 운영하면서 정기적인 유지 관리와 업데이트를 통해 보안을 유지하고, 하드웨어 요구 사항의 변화에 주의를 기울이는 것이 중요합니다. 더 나아가 검증자(Validator)로 참여하여 스테이킹에 참여할 수도 있지만, 이는 32 ETH의 예치금과 추가적인 설정이 필요합니다.

블록체인 기술은 빠르게 진화하고 있으므로, 항상 최신 개발 사항을 확인하고 공식 문서를 참조하여 노드를 최신 상태로 유지하세요.

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

More posts