Nodes/monero/docker

monero

Monero daemon Docker 가이드

2분 읽기 · docker

list목차(12)

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.

참고 링크

monero 다른 챕터