지갑 경계 정의
감시 전용 지갑은 개인 지출 키를 보유하지 않고도 결제를 감지할 수 있습니다. 확장 공개 키는 여전히 민감한 지갑 활동을 노출하므로 보호해야 합니다. Lightning 통합은 온라인 지갑을 요구할 수 있으며 추가 운영 위험을 초래합니다.
전체 스택에 맞춘 규모
Bitcoin 백엔드, 데이터베이스, 웹 서비스 및 선택적 Lightning 노드는 스토리지와 메모리 요구 사항이 다릅니다. 소형 머신을 선택하기 전에 현재 지원되는 배포 지침과 성장 요구 사항을 검토하세요.
판매자 인터페이스 보안
전용 호스트 이름, HTTPS, 강력한 로그인 보호 및 제한된 관리자 액세스를 사용하세요. 서버를 최신 상태로 유지하고 수신 애플리케이션에서 웹훅 서명 또는 지원되는 검증 메커니즘을 확인하세요. 브라우저 리디렉션만으로 상품을 발송하지 마세요.
백업 및 조정
관련 문서에 따라 스토어 구성, 데이터베이스, 지갑 복구 정보 및 라이트닝 관련 자료를 보호하세요. 복구를 테스트하고 인보이스를 결제 시스템과 대조하세요. 특히 만료, 과소 결제 및 환불과 관련하여 확인하세요.
배포 및 체인 전략 확인
현재 지원되는 배포 지침, 전용 호스트 이름 및 검증된 HTTPS 경로를 사용하세요. 지원되는 경우 프루닝된 체인은 지속적인 저장 요구 사항을 줄일 수 있지만, 재스캔 및 복구 요구 사항을 이해해야 합니다. 현재 체인 크기만으로 디스크를 선택하지 말고 전체 스택과 성장을 위한 공간을 남겨두세요.
- 외부 테스트에서 결제 콜백 확인
- 실제 스토어 운영 전에 테스트 결제를 사용하세요
- 인보이스 정산 정책 확인
공식 문서: BTCPay 배포 옵션
지출 키를 의도한 위치에 보관하세요
감시 전용 설정은 서버에 지출 키를 제공하지 않고 확장 공개 키로 결제를 감지할 수 있습니다. xpub는 지갑 활동을 노출할 수 있으므로 민감합니다. 핫 지갑은 지출 능력을 온라인에 배치하여 이 위험을 바꿉니다. 지갑과 Lightning 보관을 별도로 검토하고 지원되는 백업 절차를 따르세요.
공식 문서: BTCPay 지갑 모델
선택한 스택에 맞춰 배포 체크리스트 작성
전용 도메인, 지원되는 배포 방식, 의도한 체인 모드 및 동기화에 충분한 디스크 여유 공간으로 시작하십시오. 설치 전에 업스트림 Docker 생성기와 선택한 구성 요소를 검토하십시오. 비밀이 아닌 배포 선택 사항을 보존하여 다른 머신에서도 일관되게 재구축할 수 있도록 하십시오. 고객에게 결제 화면을 표시하기 전에 도메인 확인, 인증서 발급 및 관리 계정 소유권을 확인하십시오. 일반적인 Docker Compose 예시는 모든 선택적 BTCPay 구성 요소가 구성되었음을 증명하지 않습니다.
- 어떤 인스턴스 소유자가 업데이트, 모니터링, 백업 및 사고 대응을 제어하는지 결정하세요.
- 리버스 프록시 노출을 프라이빗 Bitcoin RPC, 데이터베이스 및 Lightning 관리와 분리하세요.
- 과거 결제가 있는 지갑을 연결하기 전에 프루닝된 백엔드의 복구/재스캔 한도를 문서화하세요.
- 가치 있는 주문을 이행하기 전에 통합을 위한 지원되는 테스트 환경이나 소규모 통제된 결제 실습을 유지하세요.
공식 문서: BTCPay Server: 배포 선택 사항 · BTCPay Server: Docker 배포 지원
시드를 가져오지 않고 누락된 지갑 결제 조사
스토어는 지출 키가 다른 기기에 남아 있는 상태에서 지갑의 xpub/파생 정보를 사용할 수 있습니다. 선택한 지갑으로 수신 및 복구 경로를 테스트하세요. BTCPay에서 인보이스 결제가 확인되지만 외부 지갑에 표시되지 않는 경우, 자금이 사라졌다고 단정하기 전에 해당 지갑의 파생 체계와 주소 갭 한도 동작을 점검하세요. 미결제 상태로 생성된 주소가 길게 이어지면 지갑의 검색에 영향을 줄 수 있습니다. 복구 단어를 서버에 복사하지 말고 지원되는 지갑 진단 기능을 사용하세요.
이행 전 인보이스 대사
인보이스 식별자를 기록하고 이행 작업을 멱등적으로 만드세요. 브라우저가 상점으로 돌아오는 것은 탐색 이벤트일 뿐 결제 완료의 증거가 아닙니다. 인증된 서버 통합을 통해 결제 상태를 확인하고, 만료·지연·과소 결제된 인보이스를 명시적으로 처리하며, 미해결 결과에 대한 검토 경로를 유지하세요. 콜백이 반복되는 경우 성공 응답을 반환하더라도 주문이 두 번 출고되거나 크레딧 처리되어서는 안 됩니다.
- 만료 임박 시점에 도착하는 결제를 테스트하고 주문이 올바른 인보이스와 연결된 상태로 유지되는지 확인하세요.
- 데이터베이스, 스토어 구성 및 지갑 복구 자료를 검증된 독립 백업에 보관하세요.
- Lightning은 별도의 유동성 및 채널 백업 책임을 추가합니다. 어제의 전체 VPS을 복원하는 것은 안전한 범용 복구 절차가 아닙니다.
- BTCPay 인스턴스를 호스팅해도 KoalaVPS 고객 결제에 Lightning 또는 XMR이 추가되지 않습니다. 이 호스팅 사이트의 결제 수단은 공개된 일곱 가지 경로로 유지됩니다.
공식 문서: Bitcoin 개발자 가이드: 결제 확인 · LND: 재해 복구 · Core Lightning: 지갑 및 채널 백업