Step 1: 서버 준비 및 기본 설정 🖥️

먼저 Ubuntu 24.04 LTS가 설치된 서버를 준비하고 기본 설정을 진행해볼게요:

# 시스템 업데이트
sudo apt update && sudo apt upgrade -y

# 필수 패키지 설치
sudo apt install -y build-essential pkg-config libssl-dev libudev-dev \
    libclang-dev cmake make git curl jq unzip htop iotop

# 방화벽 설정
sudo ufw allow ssh
sudo ufw allow 8899/tcp  # RPC 포트
sudo ufw allow 8900/tcp  # 웹소켓 포트
sudo ufw allow 8901/tcp  # 트랜잭션 포워딩 포트
sudo ufw enable

# 스왑 공간 설정 (RAM이 부족할 경우)
sudo fallocate -l 128G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
            

서버 보안을 위한 추가 설정도 잊지 마세요! ⚠️

# Fail2ban 설치 (SSH 무차별 공격 방지)
sudo apt install -y fail2ban
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

# 비밀번호 없는 SSH 키 기반 인증 설정
# (로컬 컴퓨터에서 실행)
ssh-keygen -t ed25519 -C "solana-rpc-node"
ssh-copy-id user@your-server-ip
            

Step 2: Rust 및 Solana CLI 설치 🦀

솔라나 노드를 실행하려면 Rust와 Solana CLI가 필요해요:

# Rust 설치
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Solana CLI 설치 (2025년 3월 기준 최신 버전)
sh -c "$(curl -sSfL https://release.solana.com/v2.5.3/install)"
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 설치 확인
solana --version
            

여기서 v2.5.3은 2025년 3월 기준 최신 버전이에요. 실제 설치 시에는 솔라나 공식 사이트에서 최신 버전을 확인하세요! 🔄

Step 3: 솔라나 계정 생성 및 네트워크 선택 🔑

노드 운영을 위한 솔라나 계정을 생성하고 사용할 네트워크를 선택해야 해요:

# 새 키페어 생성
solana-keygen new -o ~/validator-keypair.json

# 네트워크 선택 (메인넷-베타)
solana config set --url https://api.mainnet-beta.solana.com

# 또는 테스트넷 선택 (처음 시작하는 경우 권장)
# solana config set --url https://api.testnet.solana.com

# 키페어 설정
solana config set --keypair ~/validator-keypair.json

# 구성 확인
solana config get
            

Step 4: RPC 노드 설정 및 실행 🚀

이제 실제로 RPC 노드를 설정하고 실행해볼게요. 여기서는 두 가지 방법을 소개할게요:

A. 솔라나 Labs 클라이언트 (기본 방식)

# 노드 데이터 디렉토리 생성
mkdir -p ~/solana-rpc-node
cd ~/solana-rpc-node

# 레저(원장) 설정
solana-validator --ledger ~/solana-rpc-node \
  --identity ~/validator-keypair.json \
  --entrypoint entrypoint.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint2.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint3.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint4.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint5.mainnet-beta.solana.com:8001 \
  --expected-genesis-hash 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d \
  --rpc-port 8899 \
  --dynamic-port-range 8000-8020 \
  --no-voting \
  --private-rpc \
  --rpc-bind-address 0.0.0.0 \
  --only-known-rpc \
  --accounts-index-memory-limit-mb 16000 \
  --limit-ledger-size 50000000 \
  --maximum-full-snapshots-to-retain 2 \
  --maximum-incremental-snapshots-to-retain 4 \
  --snapshot-interval-slots 500 \
  --incremental-snapshot-interval-slots 500 \
  --contact-info-pubkey ~/validator-keypair.json \
  --enable-rpc-transaction-history \
  --enable-cpi-and-log-storage \
  --enable-extended-tx-metadata-storage \
  --full-rpc-api \
  --no-untrusted-rpc \
  --wal-recovery-mode skip_any_corrupted_record \
  --log ~/solana-rpc-node/solana-validator.log
            

B. Firedancer 클라이언트 (2025년 권장 방식)

# Firedancer 설치
curl -sSfL https://firedancer.solana.com/install | sh
source ~/.bashrc

# Firedancer 구성
mkdir -p ~/firedancer-node
cd ~/firedancer-node

# 구성 파일 생성
cat > config.toml << EOF
[node]
identity = "~/validator-keypair.json"
ledger_dir = "~/firedancer-node/ledger"
log_file = "~/firedancer-node/firedancer.log"

[network]
entrypoints = [
  "entrypoint.mainnet-beta.solana.com:8001",
  "entrypoint2.mainnet-beta.solana.com:8001",
  "entrypoint3.mainnet-beta.solana.com:8001",
  "entrypoint4.mainnet-beta.solana.com:8001",
  "entrypoint5.mainnet-beta.solana.com:8001"
]
expected_genesis_hash = "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d"
dynamic_port_range = "8000-8020"

[rpc]
bind_address = "0.0.0.0:8899"
websocket_bind_address = "0.0.0.0:8900"
enable_transaction_history = true
enable_cpi_and_log_storage = true
enable_extended_tx_metadata = true
full_api = true
private = true
only_known = true

[accounts]
index_memory_limit_mb = 16000

[storage]
ledger_size_limit = 50000000
max_full_snapshots = 2
max_incremental_snapshots = 4
snapshot_interval = 500
incremental_snapshot_interval = 500
wal_recovery_mode = "skip_any_corrupted_record"
EOF

# Firedancer 노드 실행
firedancer-validator --config config.toml
            

위 명령어를 실행하면 노드가 시작되고 블록체인 데이터 동기화가 시작돼요. 처음 동기화는 하드웨어에 따라 24-72시간 정도 걸릴 수 있어요! 인내심을 가지고 기다려주세요~ 😅

Step 5: 시스템 서비스로 등록하기 ⚙️

노드가 서버 재시작 후에도 자동으로 실행되도록 시스템 서비스로 등록해볼게요:

# systemd 서비스 파일 생성 (솔라나 Labs 클라이언트용)
sudo nano /etc/systemd/system/solana-rpc.service

# 아래 내용 입력
[Unit]
Description=Solana RPC Node
After=network.target

[Service]
User=YOUR_USERNAME
ExecStart=/home/YOUR_USERNAME/.local/share/solana/install/active_release/bin/solana-validator \
  --ledger /home/YOUR_USERNAME/solana-rpc-node \
  --identity /home/YOUR_USERNAME/validator-keypair.json \
  --entrypoint entrypoint.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint2.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint3.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint4.mainnet-beta.solana.com:8001 \
  --entrypoint entrypoint5.mainnet-beta.solana.com:8001 \
  --expected-genesis-hash 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d \
  --rpc-port 8899 \
  --dynamic-port-range 8000-8020 \
  --no-voting \
  --private-rpc \
  --rpc-bind-address 0.0.0.0 \
  --only-known-rpc \
  --accounts-index-memory-limit-mb 16000 \
  --limit-ledger-size 50000000 \
  --maximum-full-snapshots-to-retain 2 \
  --maximum-incremental-snapshots-to-retain 4 \
  --snapshot-interval-slots 500 \
  --incremental-snapshot-interval-slots 500 \
  --contact-info-pubkey /home/YOUR_USERNAME/validator-keypair.json \
  --enable-rpc-transaction-history \
  --enable-cpi-and-log-storage \
  --enable-extended-tx-metadata-storage \
  --full-rpc-api \
  --no-untrusted-rpc \
  --wal-recovery-mode skip_any_corrupted_record
Restart=always
RestartSec=10
LimitNOFILE=1000000

[Install]
WantedBy=multi-user.target

# 서비스 활성화 및 시작
sudo systemctl daemon-reload
sudo systemctl enable solana-rpc
sudo systemctl start solana-rpc

# 상태 확인
sudo systemctl status solana-rpc
            

Firedancer 클라이언트를 사용하는 경우에는 위 서비스 파일의 ExecStart 부분만 아래와 같이 변경하면 돼요:

ExecStart=/home/YOUR_USERNAME/.local/bin/firedancer-validator --config /home/YOUR_USERNAME/firedancer-node/config.toml
            

Step 6: RPC 엔드포인트 테스트 🧪

노드가 정상적으로 동기화되었다면 RPC 엔드포인트를 테스트해볼 수 있어요:

# 로컬에서 테스트
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}' http://localhost:8899

# 예상 응답: {"jsonrpc":"2.0","result":"ok","id":1}

# 블록 높이 확인
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"getBlockHeight"}' http://localhost:8899

# 계정 정보 조회 테스트
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"getAccountInfo","params":["4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA", {"encoding":"jsonParsed"}]}' http://localhost:8899
            

모든 명령이 정상적으로 응답한다면 축하해요! 🎉 여러분의 솔라나 RPC 노드가 성공적으로 실행되고 있어요!