본문으로 건너뛰기

풀노드 재동기화 방법

풀노드를 운영하다 보면 비트코인 노드(코어 또는 노츠) 동기화에 문제가 생길 때가 있습니다. 풀노드를 재설치할 수 있는 사람은 처음 구축할 때와 같이 재구축하면 대부분 해결됩니다. 그렇지만 엄브렐 1.0대 버전을 지원하지 않는 기기(예: 오드로이드 등)의 경우 엄브렐을 다시 설치할 수 없기 때문에 비트코인 노드를 재동기화 하는 방법으로 문제를 해결해야 합니다. SSH로 풀노드에 접속하는 방법을 설명합니다.

경고

아래의 방법은 리눅스에 명령어로 엄브렐을 설치한 경우만 사용할 수 있습니다. 마이크로SD 카드나 USB 메모리에 플래싱해서 엄브렐을 설치한 경우는 사용할 수 없습니다.

Umbrel에 SSH 접속​

  1. Umbrel 서버의 IP 주소 확인 (같은 네트워크에 있는 경우 umbrel.local 사용 가능).

  2. SSH 클라이언트를 사용하여 Umbrel 서버에 접속:

    ssh [email protected]
  • 여기서 umbrel은 풀노드 구축 당시 설정한 아이디입니다.
  • 명령어를 입력한 후 엔터를 치면 패스워드를 입력하라고 나옵니다.
  • 기본 패스워드는 설치 과정에서 설정한 것을 사용합니다. 만약 초기 설정값을 사용했다면 Umbrel 문서를 참고하세요.
정보

만약 umbrel.local 주소로 ssh 접속이 안되면 내부IP를 찾아 umbrel.local 대신 내부IP주소를 통해 접속해야 합니다. 내부IP가 192.168.1.3이라면 아래와 같이 접속하면 됩니다.

ssh [email protected]

내부IP가 무엇인지 모른다면 풀노드 접속 방법 문서를 참고하세요.

Nano 설치 확인​

Nano 편집기가 설치되지 않은 경우, 설치합니다:

  1. 설치 확인: 
    nano --version
    결과가 없으면 Nano를 설치하세요.
  2. Nano 설치: 
    sudo apt update
    sudo apt install -y nano

Umbrel 비트코인 설정 파일 수정​

  1. Umbrel 비트코인 설정 파일의 위치로 이동:

    cd ~/umbrel/app-data/bitcoin/data/bitcoin/

  2. bitcoin.conf 파일 열기:

    sudo nano bitcoin.conf

재동기화를 위한 설정 추가​

bitcoin.conf 파일에 아래 내용을 추가하거나 확인합니다:

  • 모든 데이터 삭제 후 다시 동기화하려면:

    prune=0

    prune 설정이 0으로 되어 있어야 전체 블록체인을 다운로드합니다.

  • 특정 블록부터 동기화를 시작하려면:

    reindex=1

    이 설정은 기존 데이터베이스를 다시 생성합니다.

  1. 저장 후 종료:
    • 저장: Ctrl + O (Enter 키로 확인)
    • 종료: Ctrl + X

Umbrel 비트코인 노드 재시작​

비트코인 노드를 재시작하기 위해 엄브렐을 재시작 합니다. 그러면 재색인을 시작하게 될 것입니다.

cd ~/umbrel
sudo ./scripts/stop
sudo ./scripts/start
경고
  • 재색인이 완료되면 reindex=1 옵션을 제거하는 것이 좋습니다.
  • 그렇지 않으면 노드가 재부팅 될 때마다 비트코인 블록체인을 재색인하게 됩니다.

동기화 진행 상황 확인​

  1. SSH를 통해 동기화 상태를 확인: 
    tail -f ~/umbrel/app-data/bitcoin/data/bitcoin/debug.log
    • 로그에서 동기화 상태를 모니터링할 수 있습니다.