Filecoin 호스트 설치 가이드
Ubuntu 22.04 기준 lotus 소스 빌드·실행 개요입니다. Storage Provider 운영은 별도 상세 문서(공식)를 참고하세요.
- 공식 문서: https://lotus.filecoin.io/lotus/install/prerequisites/
- 소스: https://github.com/filecoin-project/lotus
시스템 요구사항 (Full Node 기준)
| 항목 | 권장 |
|---|---|
| CPU | 8+ vCPU |
| RAM | 32 GB+ |
| Disk | 500 GB NVMe (스냅샷 사용 시) ~ 수 TB |
| Network | 100 Mbps+ |
Storage Provider는 수 TB~PB 섹터 볼륨 + GPU(RTX 30/40 series) sealing 장비가 별도로 필요합니다.
사전 준비
sudo apt update && sudo apt install -y \
mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config \
curl clang build-essential hwloc libhwloc-dev wget
# Go 1.22+
wget https://go.dev/dl/go1.22.8.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.8.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
# Rust (FVM/bls signatures)
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
빌드
git clone https://github.com/filecoin-project/lotus.git
cd lotus
git checkout v1.30.0
make clean all
sudo make install
lotus --version
Calibration testnet 빌드:
make clean calibnet
sudo make install
실행
# 환경 변수
mkdir -p ~/.lotus
export LOTUS_PATH=$HOME/.lotus
# 스냅샷으로 시작 (강력 권장)
curl -o ~/minimal.car -L https://snapshots.mainnet.filops.net/minimal/latest
lotus daemon --import-snapshot ~/minimal.car --halt-after-import
rm ~/minimal.car
# 일반 기동
lotus daemon
systemd 서비스
# /etc/systemd/system/lotus-daemon.service
[Unit]
Description=Lotus Daemon
After=network-online.target
[Service]
User=filecoin
Environment="LOTUS_PATH=/home/filecoin/.lotus"
ExecStart=/usr/local/bin/lotus daemon
Restart=on-failure
LimitNOFILE=8192000
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now lotus-daemon
journalctl -u lotus-daemon -f
상태 조회
lotus chain head
lotus sync status
lotus net peers
Storage Provider 추가 절차 (개요)
Storage Provider는 별도 데몬 lotus-miner와 boostd, sealer 조합으로 운영합니다. 자세한 절차는 공식 문서: