透過標準 Docker 部署執行自託管比特幣支付軟體 BTCPay Server 的營運者,若想保留洋蔥網路存取,必須在下次設定或更新時明確選用 Tor。此變更隨 2.4.5 版本推出,將 Tor 從自動包含的元件中移除,使原本預先捆綁的服務成為管理員的設定選項。

BTCPay 在隨 2.4.5 版本發布的 10 月 5 日公告中詳述了此部署變更,而 GitHub 官方發布頁面記錄的軟體發布日期為 10 月 6 日。對既有安裝而言,相關觸發點是下次 Docker 設定或更新——這意味著除非營運者重新選用,否則該元件可能在日常維護過程中從運行中的部署裡消失。

此調整對依賴 Tor 的 Docker 營運者影響重大,包括透過伺服器洋蔥位址(即 Tor 隱藏服務所暴露的 .onion 端點)進行存取的用戶,他們先前是透過核心 BTCPay Server 片段獲得該服務。片段是組裝 Docker 堆疊時使用的設定元件。

更新後重新啟用 Tor

BTCPay 建議管理員在更新前先檢視部署變更。升級至 2.4.5 版本後,啟用 Tor 的指令為:

sudo btcpay-fragments add opt-add-tor

Tor 仍受支援,BTCPay 表示既有資料會保留在現有的 Tor 儲存卷中。這保護了已儲存的資料,但持續的洋蔥網路存取仍取決於部署中是否包含並運行 Tor。

根據 BTCPay Server 文件,選用的 Tor 片段 opt-add-tor 會加入隱藏服務及所選的洋蔥網路連線。營運者可使用 btcpay-fragments show 檢查設定,該指令不會變更任何內容,並會報告已儲存的新增與排除片段,以及上次產生清單中的生效片段。在更新前以及新增片段後各檢查一次輸出,可讓管理員掌握堆疊實際運行內容的前後對照。變更片段的指令需要 root 權限,並會立即重新套用設定。

私有服務需要另行設定例外

2.4.5 版本說明還指出一項針對 HTTP 外呼請求的重大變更:閃電網路連線、LNURL 請求、發票通知 URL 與 webhook 對私有網路目的地的請求預設會被封鎖。此限制旨在防範伺服器端請求偽造(SSRF),這是一類應用程式被誘騙向內部或其他受限網路資源發送請求的漏洞。

由於兩項變更同時在同一版本中推出,單次更新可能影響營運者設定的兩個不同部分:洋蔥網路可用性以及對私有位址的外呼。啟用此保護後,刻意使用私有服務的營運者必須透過 ssrfexceptions 允許所需的目的地位址。BTCPay 的營運者指南指出,變更設定後應重新啟動應用程式並測試受影響的整合。