Filecoin Docker 노드 가이드
Filecoin 공식 클라이언트 lotus는 Docker 이미지를 제공합니다. Full Node는 Docker가 실용적이며, Storage Provider(Miner)는 sealing I/O 때문에 호스트 설치를 권장합니다.
- 공식 이미지: filecoin/lotus
- 공식 문서: https://docs.filecoin.io/networks/mainnet/get-started
- 소스: https://github.com/filecoin-project/lotus
Full Node (Mainnet, lotus daemon)
# 데이터 디렉토리
sudo mkdir -p /data/filecoin
sudo chown -R 532:532 /data/filecoin # 이미지 기본 UID
docker run -d --name lotus-daemon --restart unless-stopped \
-p 1234:1234 -p 1347:1347 \
-v /data/filecoin:/var/lib/lotus \
-e LOTUS_PATH=/var/lib/lotus \
filecoin/lotus:v1.30.0 \
lotus daemon
- 1234: API/JSON-RPC
- 1347: libp2p
스냅샷 사용 (사실상 필수)
Genesis 동기화는 수 주가 걸립니다. 공식 스냅샷으로 시작하세요.
# 공식 스냅샷 다운로드 (최소 단위)
# 주의: 약 40~60 GB 압축 파일
curl -o /tmp/minimal.car -L \
https://snapshots.mainnet.filops.net/minimal/latest
# 컨테이너 외부에서 import (daemon 중지 후)
docker run --rm \
-v /data/filecoin:/var/lib/lotus \
-v /tmp:/snapshots \
-e LOTUS_PATH=/var/lib/lotus \
filecoin/lotus:v1.30.0 \
lotus daemon --import-snapshot /snapshots/minimal.car --halt-after-import
그런 뒤 docker start lotus-daemon.
상태 확인
# 체인 헤드
docker exec lotus-daemon lotus chain head
# 동기화 상태
docker exec lotus-daemon lotus sync status
# 네트워크·피어
docker exec lotus-daemon lotus net peers | wc -l
Calibration Testnet
이미지 태그에 -calibrationnet suffix를 붙이거나 빌드 태그를 사용합니다.
docker run -d --name lotus-calib --restart unless-stopped \
-p 1234:1234 -p 1347:1347 \
-v /data/filecoin-calib:/var/lib/lotus \
filecoin/lotus:v1.30.0-calibnet \
lotus daemon
Miner(Storage Provider)는 호스트 권장
- GPU 가속 sealing, PoSt 증명, 수 TB 볼륨 등 I/O·레이아웃 요구가 매우 구체적
lotus-miner,boost,sealer등 컴포넌트 분리 운영- 자세한 설치/운영은 ../localhost/README.md 및 Storage Provider Onboarding