Monero daemon Docker 가이드
Docker로 Monero daemon(monerod)을 실행하는 방법입니다.
참고: GetMonero Full Node Guide, guides.monero.com.
빠른 시작
1. 환경 변수 (선택)
cp env-example.txt .env
# DATA_DIR, MONERO_VERSION 등 필요 시 수정
2. 빌드 및 실행
docker compose up -d
3. 로그·상태 확인
docker compose logs -f
docker exec monero-node monerod status
첫 동기화는 1~2일 걸릴 수 있습니다. Pruned 모드 기준 약 70GB 디스크를 사용합니다.
포트
| 포트 | 용도 |
|---|---|
| 18080 | P2P |
| 18081 | RPC (기본) |
| 18089 | RPC restricted (공개 노드) |
데이터 디렉터리
${DATA_DIR:-./monero-data}가 컨테이너 내 /data에 마운트됩니다.
이미지 기본 설정은 Pruned (prune-blockchain=1)이며, 약 70GB를 사용합니다.
Linux (프로덕션)
sudo mkdir -p /mnt/cryptocur-data/monero
sudo chown -R 1000:1000 /mnt/cryptocur-data/monero
# .env 에 DATA_DIR=/mnt/cryptocur-data/monero 설정
설정 파일 (선택)
기본은 이미지 내장 monerod.conf.default(Pruned, public-node)를 사용합니다.
호스트에서 설정을 바꾸려면 monerod.conf.example를 복사해 monerod.conf로 편집한 뒤:
volumes:
- ${DATA_DIR:-./monero-data}:/data
- ./monerod.conf:/etc/monero/monerod.conf:ro
보안 참고
- 프로덕션에서는 바이너리 GPG 검증을 권장합니다. 이 이미지는 빌드 시 GitHub에서 다운로드만 하며, 검증 스크립트는 포함하지 않습니다.
- RPC를 외부에 열 때는 restricted RPC·
public-node=1조합으로 제한하는 것이 안전합니다.
하드웨어 권장
- RAM: 8GB 이상
- 디스크: Pruned 약 70GB / Full 200GB+ SSD
문제 해결
- 동기화 느림: 첫 동기화 1~2일 소요.
docker compose logs -f로 진행 확인. - 포트: 18080 인바운드 허용 시 풀 노드 기여에 유리.
자세한 내용: ../localhost/troubleshooting.md.