btcpayserver/btcpayserver-docker

어떤 프로젝트인가요?

핵심 기능

• 01환경 변수와 선택적 조각을 바탕으로 Docker Compose 스택을 생성합니다.
• 02BTCPay Server, PostgreSQL, NBXplorer, Bitcoin Core를 함께 제공합니다.
• 03도메인을 설정하면 자동 HTTPS 인증서를 적용하도록 Nginx를 구성합니다.
• 04Tor 숨겨진 서비스와 선택적 Lightning 구현체를 지원합니다.
• 05명령줄 유틸리티를 설치하고 부팅 시 스택이 시작되도록 등록합니다.

활용 사례

• 온라인 스토어용 Bitcoin 결제 처리 시스템을 VPS에서 직접 호스팅합니다.
• 안내형 설치 스크립트를 사용해 클라우드 제공업체에 BTCPay Server를 배포합니다.
• 기존 BTCPay 배포에 선택적으로 Lightning 또는 알트코인 지원을 추가합니다.

빠른 시작

1. 1

   도메인, 네트워크 및 구성 요소의 환경 변수를 설정합니다

   export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs"
2. 2

   저장소를 클론합니다

   git clone https://github.com/btcpayserver/btcpayserver-docker
3. 3

   설정 스크립트를 실행해 스택을 생성하고 시작합니다

   . ./btcpay-setup.sh -i
4. 4

   브라우저에서 도메인을 열고 첫 번째 관리자 계정을 등록합니다

사용 전 알아둘 점

• !자동 HTTPS를 사용하려면 서버를 가리키는 도메인이 있어야 하며 포트 80과 443이 열려 있어야 합니다.
• !Bitcoin 초기 동기화에는 오랜 시간이 걸릴 수 있으며 상당한 서버 리소스가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

btcpayserver-docker은(는) 무엇인가요?

환경 변수에서 전체 BTCPay Server 스택을 구성하고 실행하는 공식 Docker Compose 배포판입니다. 이 저장소는 셀프 호스팅 Bitcoin 결제 처리 시스템인 BTCPay Server의 공식 Docker 배포판을 제공합니다. 설정 스크립트는 소수의 환경 변수와 선택적 조각을 바탕으로 Docker Compose 스택을 구성한 뒤, 명령줄 유틸리티를 설치하고 부팅 시 스택이 시작되도록 등록한 다음 서비스를 실행합니다.

btcpayserver-docker은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

btcpayserver-docker은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

btcpayserver-docker은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. btcpayserver-docker의 마지막 커밋은 2026년 11월 6일입니다.

btcpayserver-docker은(는) 어디에 사용할 수 있나요?

온라인 스토어용 Bitcoin 결제 처리 시스템을 VPS에서 직접 호스팅합니다. 안내형 설치 스크립트를 사용해 클라우드 제공업체에 BTCPay Server를 배포합니다. 기존 BTCPay 배포에 선택적으로 Lightning 또는 알트코인 지원을 추가합니다.

btcpayserver-docker는 어떻게 설치하나요?

도메인, 네트워크 및 구성 요소의 환경 변수를 설정합니다: export BTCPAY_HOST="btcpay.example.com" export NBITCOIN_NETWORK="mainnet" export BTCPAYGEN_CRYPTO1="btc" export BTCPAYGEN_LIGHTNING="none" export BTCPAYGEN_REVERSEPROXY="nginx" export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage-xs" 저장소를 클론합니다: git clone https://github.com/btcpayserver/btcpayserver-docker 설정 스크립트를 실행해 스택을 생성하고 시작합니다: . ./btcpay-setup.sh -i 브라우저에서 도메인을 열고 첫 번째 관리자 계정을 등록합니다

btcpayserver-docker은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/btcpayserver/btcpayserver-docker