Dogecoin Core 설치 가이드
Dogecoin Core Full Node를 Windows / macOS / Linux에 설치하고 실행하는 방법입니다.
출처: Operate a Dogecoin Node, dogecoin/dogecoin.
목차
최소 요구사항
- 디스크: 60GB 이상 (SSD 권장, 블록체인 성장에 따라 추가 필요)
- RAM: 2GB 이상
- 네트워크: 포트 22556 오픈(방화벽·라우터 포워딩). unmetered 인터넷 권장(첫 동기화·월 1TB+ 가능).
- 실행: 24/7 가동 시 네트워크에 더 유용.
다운로드
- 공식: Dogecoin.com 또는 GitHub Releases
- OS에 맞는 빌드 선택 (Windows / macOS / Linux, v1.14.9 등 최신 버전 권장).
Windows 설치
- Dogecoin.com 또는 GitHub Releases에서 Windows용 설치 파일 다운로드.
- 다운로드한 설치 파일을 더블클릭하여 실행. Windows 확인 시 예 선택.
- 백신 경고가 나올 수 있음. 공식 사이트·GitHub에서 받은 파일이면 안전하므로, 백신에서 Dogecoin Core를 화이트리스트에 추가한 뒤 재설치.
- 설치 완료 후 시작 메뉴에서 Dogecoin Core 실행.
- 설정 → 옵션 → 네트워크에서 "Allow Incoming Connections" 체크.
- 방화벽·라우터에서 포트 22556 인바운드 허용(또는 포워딩). 자세한 방법은 configuration.md 참고.
Windows에서 Daemon(CLI) 실행
cd "C:\Program Files\Dogecoin\daemon\"
dogecoind -daemon
CLI로 RPC 사용:
dogecoin-cli help
dogecoin-cli getinfo
(설치 경로가 다르면 해당 경로로 이동 후 실행.)
macOS 설치
- Dogecoin.com 또는 GitHub Releases에서 macOS용 빌드 다운로드.
- 다운로드 폴더에서 아이콘 더블클릭 → Applications 폴더로 드래그하여 설치.
- Applications에서 Dogecoin Core 실행.
- Dogecoin Core → Preferences → Network에서 "Allow Incoming Connections" 체크.
- 필요 시 방화벽·라우터에서 포트 22556 허용.
Linux 설치
VPS 또는 로컬 Linux에서 헤드리스 노드로 실행할 때 유용합니다. 비 root 사용자로 실행하는 것을 권장합니다.
1. 최신 Linux 빌드 다운로드
GitHub Releases에서 아키텍처에 맞는 tarball 선택 (예: x86_64).
# 예: v1.14.6 x86_64 (최신 버전은 Releases 페이지에서 확인)
wget https://github.com/dogecoin/dogecoin/releases/download/v1.14.6/dogecoin-1.14.6-x86_64-linux-gnu.tar.gz
tar -xvzf dogecoin-1.14.6-x86_64-linux-gnu.tar.gz
cd dogecoin-1.14.6/bin
2. Daemon 실행 (헤드리스)
./dogecoind -daemon
3. GUI 실행 (로컬에 디스플레이가 있는 경우)
./dogecoin-qt
4. CLI로 상태 확인
./dogecoin-cli help
./dogecoin-cli getinfo
./dogecoin-cli getconnectioncount
연결 수가 8을 넘으면 인바운드 연결이 동작 중인 것으로 볼 수 있습니다.
5. 동기화 로그 보기
Data Directory의 debug.log 확인 (기본: ~/.dogecoin/debug.log).
tail -f ~/.dogecoin/debug.log
(Ctrl+C로 종료.)
소스 빌드
공식 문서와 빌드 방법은 GitHub의 doc 디렉터리를 참고하세요.
- Getting Started (GitHub)
- doc 트리 — OS별 빌드 안내
커뮤니티에서 제공하는 자동 설치 스크립트 예: vertiond/pidohj (Single Board Computer 및 amd64 지원).
실행 및 동기화
- Dogecoin Core 시작 (GUI 또는
dogecoind -daemon). - 첫 실행 시 블록체인 동기화가 자동으로 시작됩니다. 24시간 이상 걸릴 수 있으며, 네트워크·디스크에 따라 며칠 걸릴 수도 있습니다.
- 동기화가 끝나고 포트 22556이 열려 있으면, 풀 노드로 네트워크에 기여하게 됩니다.
설정·RPC·포트 포워딩은 configuration.md를 참고하세요.
업그레이드
- 지갑 사용 시: 백업 후 진행. 오래된 버전 사용 중이면 plain text 백업도 권장.
- Dogecoin Core 종료: GUI는 종료 후 완전히 끝날 때까지 대기. CLI는
dogecoin-cli stop. - 새 버전을 Dogecoin.com 또는 GitHub Releases에서 다운로드.
- 현재 OS에 맞는 설치 절차대로 새 버전 설치 후 실행.