Nodes/bitcoin/localhost/updates

bitcoin

Bitcoin Core 업데이트 로그

3분 읽기 · localhost/updates

list목차(7)

Bitcoin Core 업데이트 로그

Bitcoin Core 노드 소프트웨어의 최근 릴리스 요약입니다. 공식 릴리스 페이지: https://bitcoincore.org/en/download/, https://github.com/bitcoin/bitcoin/releases.

업데이트 체크리스트

  • 현재 버전 확인: bitcoin-cli --version
  • 릴리스 노트 검토 (breaking change, DB 마이그레이션 여부)
  • 블록 체인 데이터 백업 또는 스냅샷 확보
  • 테스트 환경에서 먼저 검증 (testnet/signet)
  • 노드 중지 → 바이너리 교체 → 재기동
  • 재기동 후 getblockchaininfo / getnetworkinfo 확인

최근 릴리스 요약

버전 주요 변경 주의
28.0 (2024-10) Libbitcoin kernel 분리 단계 확대, wallet SQLite 기본, BIP324 v2 전송 안정화 libsecp256k1 정적 링크 기본
27.1 (2024-06) 27.0 버그 수정 (assumeutxo 관련)
27.0 (2024-04) BIP324 (v2 P2P 암호화 전송), addnode/UPnP 변경 -upnp 기본값 off
26.0 (2023-12) assumeutxo 경험적 지원, Kernel 라이브러리 분리 시작
25.0 (2023-05) wallet에서 legacy descriptor 사용 권고 레거시 wallet 경고

업데이트 방법

바이너리 교체 (공식 tar.gz)

# 1. 현재 노드 중지 (정상 종료)
bitcoin-cli stop
# logs가 "Shutdown: done" 출력될 때까지 대기

# 2. 새 버전 다운로드
VERSION=28.0
wget https://bitcoincore.org/bin/bitcoin-core-${VERSION}/bitcoin-${VERSION}-x86_64-linux-gnu.tar.gz
wget https://bitcoincore.org/bin/bitcoin-core-${VERSION}/SHA256SUMS
sha256sum --ignore-missing --check SHA256SUMS

tar -xzf bitcoin-${VERSION}-x86_64-linux-gnu.tar.gz
sudo install -Dm755 bitcoin-${VERSION}/bin/* -t /usr/local/bin/

# 3. 재시작
bitcoind -daemon

# 4. 버전 확인
bitcoin-cli --version
bitcoin-cli getblockchaininfo | jq '.blocks, .headers'

Docker 이미지 교체

cd chains/bitcoin/docker
# docker-compose.yml의 image 태그 변경 (예: bitcoind 28.0 빌드)
docker compose pull
docker compose down
docker compose up -d
docker compose logs -f bitcoind | grep 'Bitcoin Core version'

다운그레이드 주의

Bitcoin Core는 다운그레이드 시 chainstate DB 호환이 깨질 수 있습니다. 다운그레이드가 필요하면 이전 버전으로 동기화된 스냅샷에서 재시작하는 편이 안전합니다.

참고

bitcoin 다른 챕터