BTCPay, 토르(Tor) 미선택 시 '양파 주소' 접근 차단

비트코인 결제 소프트웨어 BTCPay 서버를 표준 Docker 배포판으로 운영하는 사용자는 다음 설정 또는 업데이트 시 토르(Tor)를 명시적으로 선택하지 않으면 onion(양파) 주소 접근을 유지할 수 없게 됩니다. 이번 변경으로 토르가 자동으로 포함되는 구성 요소에서 제외되어, 관리자의 설정 선택 사항으로 변경되었습니다.

BTCPay는 10월 5일 버전 2.4.5와 함께 배포 변경 사항을 상세히 안내했습니다. 공식 GitHub 릴리스 페이지에는 10월 6일에 해당 소프트웨어 릴리스가 기록되어 있습니다. 기존 설치의 경우, 관련 사항은 다음 Docker 설정 또는 업데이트 시 적용됩니다.

이번 변경은 서버의 onion 주소를 통한 접근 등 토르에 의존하는 Docker 운영자에게 중요한 영향을 미칩니다. 이전에는 BTCPay 서버의 핵심 조각(fragment)을 통해 토르가 제공되었으나, 이제는 사용자가 직접 설정해야 합니다. 조각은 Docker 스택을 조립하는 데 사용되는 구성 요소입니다.

BTCPay는 업데이트 전 배포 변경 사항을 검토할 것을 관리자들에게 권고합니다. 2.4.5 버전으로 업데이트한 후 토르를 활성화하는 절차는 다음과 같습니다:

```bash
sudo btcpay-fragments add opt-add-tor
```

토르는 계속 지원되며, BTCPay는 기존 데이터가 현재 토르 볼륨에 그대로 유지된다고 밝혔습니다. 이는 저장된 데이터를 보존하지만, 지속적인 onion 주소 접근은 배포에 토르를 포함하고 실행하는 것에 달려 있습니다.

BTCPay 서버 문서에 따르면, `opt-add-tor`는 숨겨진 서비스와 선택된 onion 연결을 추가하는 옵션 토르 조각으로 설명됩니다. 운영자는 `btcpay-fragments show` 명령어를 사용하여 구성을 확인할 수 있습니다. 이 명령어는 구성을 변경하지 않으며, 마지막으로 생성된 매니페스트의 유효한 조각과 함께 저장되거나 제외된 추가 조각을 보고합니다.

조각 변경 명령어는 루트 권한이 필요하며 즉시 설정을 다시 적용합니다.

**비공개 서비스는 별도의 예외 처리 필요**

2.4.5 릴리스 노트는 또한 아웃바운드 HTTP 요청에 대한 중요한 변경 사항을 식별했습니다. 라이트닝 연결, LNURL 요청, 송장 알림 URL 및 웹훅에 대해 비공개 네트워크 대상이 기본적으로 차단됩니다. 이 제한은 서버 측 요청 위조(SSRF)를 방지하기 위한 것입니다.

이 보호 기능이 활성화된 상태에서 의도적으로 비공개 서비스를 사용하는 운영자는 `ssrfexceptions`을 통해 필요한 대상의 접근을 허용해야 합니다.

BTCPay의 운영자 가이드에 따르면, 설정을 변경한 후 애플리케이션을 다시 시작하고 영향을 받는 통합 기능을 테스트해야 합니다.