參考資料 / 設定
Telegram · 連線、代理伺服器與資料保護
驗證、自動代理伺服器池、IP 模式、備用策略、外部請求及機密資料儲存。
本文件描述 TgWitness 0.9.3 的運作行為及其限制。驗證、 來源存取、網路連線及擷取完整性均為獨立的狀態。 關於登入步驟、檔案格式及多重帳戶,請先參閱 「帳戶與會話格式」。關於事件政策及重新啟動 行為,請參閱「資料收集運作方式」。
引導式連線設定#
在 更多工具 → 帳戶 → 連線路徑,管理員可以選擇 這個帳戶, 一個帳戶 群組 或 所有帳戶, 然後選擇一條路線。 評論篩選 列出 受影響的帳戶。 準備與檢查 在不變更 已儲存路線的情況下,測試建議的路線。 套用已核對的連線 驗證預覽內容,必要時 暫停監測,儲存路線,並恢復已執行的監測。 系統絕不會在先前處於閒置狀態的帳戶中啟動資料蒐集。歷史紀錄下載仍 處於暫停狀態,可另行恢復。切換前請先暫停正在執行的匯出作業。
群組變更預設會讓帳戶保留其原有路徑。請僅在預覽清單中顯示您預期的變更時, 才取消勾選該選項。 應用程式會分別回報 每個帳戶的結果;這並非橫跨資料庫的「全有或全無」式交易。若 切換失敗,該帳戶將恢復至先前設定。若無法恢復,系統會 明確顯示此狀況。預覽將於十分鐘後過期,且若變更連線 設定或群組成員資格,則需重新檢查。
當「Apply」的路線、 模式和政策未變更時,會將成功的預檢結果重複使用長達 90 秒。受管隧道仍須維持相同的 執行中程序。較舊的結果、已變更的隧道程序以及自動 MTProxy 池路線 則會重新進行檢查。簽署過的應用程式記錄會保留原始檢查時間, 並記錄重複使用情況及其使用時間長度。每次預檢都會關閉其臨時未經認證的 客戶端;收集器則會使用其自身的授權連線進行連線。
| 路徑 | TgWitness 所管理的內容 |
|---|---|
| 直接 | 來自主機的連線;未偵測到外部主機的 VPN,亦未強制執行相關設定。 |
| VPN | 每個帳戶僅有一個全隧道 WireGuard 設定檔,由本機使用者空間的 SOCKS5 程序執行。不會安裝任何主機介面或驅動程式。 |
| 我的代理伺服器 | SOCKS5、HTTP CONNECT 或 MTProxy 憑證。SOCKS5/HTTP 欄位可填入網址。選取多個帳戶時,將共用此處輸入的代理伺服器。 |
| 公開版 MTProto | 現有池會分配 Telegram 路由。在進階設定中配置獨立且合適的代理伺服器之前,外部請求將被停用。 |
| WARP | 為每個選定的帳戶建立獨立的本地隧道,並將 WARP 註冊資訊及 WireGuard 設定檔儲存於該帳戶的保管庫中。 |
當前路徑檢查使用的是全新的、未經身份驗證的 Telegram 傳輸通道,而非
該帳戶的會話。它會透過該路徑建立傳輸連線至
該帳戶的資料中心,並進行一次未經身份驗證的 MTProto 往返傳輸
(req_pq_multi);此過程不會產生授權金鑰,亦不使用任何帳戶。
報告的延遲值為該連線時間加上往返時間,且檢查
會分別記錄這兩部分。對於支援 HTTP 的路由,它還會請求
透過該路由請求 Cloudflare 的 HTTPS 追蹤,並顯示其回報的出口 IP、
國家、WARP 狀態及檢查時間。除非追蹤
回報 WARP 處於活躍狀態,否則 WARP 準備階段將失敗。這些預檢會回報路由連通性及
觀察到的出口。請透過存檔的擷取與
驗證結果檢視已擷取的記錄。僅有正在運行的本地進程,並不代表出口檢查成功。
該面板會計算最近五次檢查的移動平均值。當
平均值超過 5 秒,或連續三次檢查超過該值時,該路徑即被視為緩慢;
若連續兩次檢查失敗,則該路徑將被視為不可用; network.slow_route 並
network.route_recovered 記錄相關變更。針對速度緩慢的 WARP 路徑,「重新擲骰 WARP」
會重新啟動該帳號與其他 Cloudflare WARP 端點之間的隧道,保留
最快的路徑,並記錄 network.warp_rerolled 並記錄其前後的時間;
「新 WARP 身分」會註冊一個新的 WARP 裝置,並僅在該裝置
速度較快時才予以保留。本地代理伺服器地址、Telegram 帳戶及其連線會維持
不變;Telegram 連線將透過重新啟動的隧道重新連線。速度緩慢的 WARP
路徑最多每 30 分鐘自動重新擷取一次;若此舉
無助改善,後續的重新擷取將等待操作員介入。
可攜式 WARP 與 WireGuard#
這是 非官方 WARP 整合方案 ,使用 wgcf 2.3.1 以及 wireproxy 1.1.3 。 管理員須在首次下載或進行 WARP 註冊前,明確同意此設定。 這些設定連線會直接連至 GitHub 和 Cloudflare,並 洩露該裝置的 IP 位址。一般帳戶的流量會維持原有路由,直到 應用程式啟動為止。Cloudflare 會選擇出口位址及國家;不同的隧道 可以共用同一個出口位址。此功能不提供國家選擇、定期 IP 輪替以及全主機範圍的 VPN 殺手開關。
支援的輔助程式下載版本:Linux 和 macOS x86-64/ARM64,以及 Windows x86-64。
會將建構產出與審查來源碼中捆綁的 SHA-256 雜湊值進行比對,
且在啟動前會再次檢查快取中的可執行檔。 任何輔助程式均不會被加入
PATH 環境變數、安裝為系統服務,亦不會配置公開監聽器。所有檔案皆存放
於工作區的 portable-routes/ 目錄中,並以加密金庫條目形式儲存。
迴路 SOCKS5 監聽器需使用獨立生成的憑證。
私人設定檔和 WARP 帳戶憑證會透過現有的 工作區金庫進行加密。執行期間,輔助程式需要一份僅限擁有者存取的明文設定檔; 在正常停止時,該檔案會被移除。若主機發生當機,此檔案可能會殘留於 僅限擁有者存取的資料資料夾中。此機制不會加密磁碟,亦無法防止 系統管理員存取。 若面板的父管道 消失,監督程式將關閉隧道。失敗的隧道絕不會啟用直接備援。重新啟動面板 將恢復選定的隧道;啟動失敗時,系統會在限定延遲後重新嘗試。 停止 隧道 亦會暫停監測並維持停止狀態。 啟動隧道 啟動隧道;準備就緒時請另行恢復監測。
上傳的 WireGuard 設定檔必須包含一個介面(Interface)和一個對等端(Peer)、完整的 IPv4 及 IPv6 路由,且不得包含鉤子(hooks)、包含(includes)、環境變數替換或額外的 監聽器(listeners)。公開端點位址會在啟動前進行解析並固定。 請使用外部 VPN 或 SOCKS5 閘道,以支援 OpenVPN/IPsec 及私有端點。
驗證方法#
API ID 和 API 雜湊值用於識別應用程式;它們並不能取代帳戶登入。 在 TgWitness 中,這些資訊為選用項目。優先順序如下:首先是表單中輸入的一組值,其次是來自 匯入帳戶 JSON 檔案的一組值,接著是儲存於工作區的一組值,最後是內建的 50 組 公開配對組,當 Telegram 拒絕某組時,系統會以隨機順序嘗試並自動輪替。僅 Telegram Desktop 配對組 (2040) 會隨附相應的 Telegram Desktop 客戶端描述一併傳送。 您可將從 my.telegram.org 的 API 開發工具取得的專屬配對組用於所有帳戶;每個帳戶仍保有各自的授權。
| 方法 | 要求 | TgWitness 支援 |
|---|---|---|
| 手機號碼、代碼、可選的雙因素驗證 | 帳戶存取;API 配對為選用項目 | 面板登入 |
| 授權金鑰 HEX + DC ID | 完整的 512 字元金鑰及 DC 1–5 | 「直接授權金鑰」分頁;在儲存授權前,會檢查可選的用戶 ID |
| Telethon StringSession | 有效的會話字串 | 面板登入 |
Telethon SQLite .session |
封閉式、一致的文案 | 可直接從面板匯入模式 7/8;可選的離線命令列介面 (CLI) |
Pyrogram SQLite .session |
已關閉的生產環境使用者會話 | 直接匯入模式 2/3 |
| Telegram 桌面版 TData ZIP | 一個現代帳戶;若設有保護,則需輸入本地密碼 | 內存轉換,並包含校驗和/解密檢查 |
| 帳戶 JSON | 支援的 API/會話/金鑰欄位 | 僅憑元資料即可填入 API 憑證;仍需透過會話/金鑰或手機/QR 碼進行登入 |
| QR 碼登入 | 來自授權 Telegram 應用程式的確認 | 本地 QR 碼生成、過期/重試機制,以及可選用的雙因素驗證 (2FA) |
| TDLib / Pyrogram StringSession | 其他特定於資料庫的格式 | 不支援 |
| 機器人代幣 | 一個具備獨立存取/更新模型的機器人 | 此資料蒐集者未使用此工具 |
Telegram 負責選擇代碼傳送方式,包括是否發送 SMS。API 雜湊值無法修復 已被撤銷的會話,亦無法取代遺忘的 2FA 密碼。TgWitness 不會將 登入代碼或 Telegram 2FA 密碼儲存至磁碟。
若為私有來源,該帳號必須已具備存取權限。群組使用者名稱 並非必要。透過代理或會話匯入並不會授予成員資格或管理員 權限。成員能否查看加入群組前的聊天紀錄,取決於該聊天室的設定。
匯入 Telethon 會話檔案#
Telethon SQLite、Pyrogram SQLite 以及 Telegram Desktop TData 採用不同的格式。 此面板會偵測並轉換受支援的結構;重新命名檔案並不 屬於轉換。請在「檔案」下選取一個會話及其對應的 JSON 檔案,按下「檢查檔案」,然後點擊「連線帳戶」。最多可接受四個相符的檔案, 總大小不得超過 8 MiB。 有關 TData/JSON 的詳細資訊,請參閱格式限制。 本服務不提供密碼重設功能。透過手機/雙因素驗證 (2FA) 或 QR 碼登入將建立獨立的授權。
僅限 Telethon 的可選命令列路徑仍可使用:
- 請停止使用原始連線的客戶端,並建立一份一致的副本。該 轉換器會拒絕處理 WAL/日誌未完成的檔案。請正確關閉原始 客戶端,而非刪除這些檔案以繞過檢查。
- 在 TgWitness 環境中,執行:
python -m tgwitness.sessions account.session --out account.tgwitness-session
- 在「新增帳戶」→「檔案」下,載入結果或 貼上其字串,然後繼續。
- 請確認顯示的數字帳號 ID,選擇來源並開始監測。
轉換後的檔案為未加密的帳戶存取密鑰。 請將其存放在受保護的 儲存空間中,切勿將其提交至版本控制系統或傳送給第三方轉換服務。TgWitness 會將授權會話儲存於其加密金庫中。複製會話並不會 建立獨立的授權:請勿同時執行使用克隆授權金鑰的 客戶端,並假設其能獨立接收更新。
轉換操作僅傳遞授權,而非原始訊息、實體快取或 持久性更新游標。此操作不會解決跨程序重啟時的更新復原問題。
MTProto、Telethon 及代理伺服器#
MTProto 是 Telegram 的通訊協定。Telethon 是 TgWitness 所使用的 Python 客戶端函式庫。 MTProxy 是一款 Telegram 傳輸代理伺服器;SOCKS5 和 HTTP CONNECT 提供一般性的 隧道。上述方式均無法取代帳戶驗證。
請在登入前,前往「更多工具」→「帳戶」→「設定」→「連線設定」→「變更連線路徑」,為每個工作區儲存路徑。 新建立的工作區預設為「自動 MTProxy」· 並將公開清單設定為「隱藏地址」。 現有工作區若曾明確使用「直接連線」,則會保留允許此模式的設定。
檔案是透過與讀取訊息不同的獨立連線來讀取的,這與官方 應用程式的做法相同。在該帳號所屬的資料中心內,系統會將該帳號的授權金鑰與 新的 MTProto 連線會話重複使用;若為其他資料中心,則會在 帳號連線期間建立並授權一個金鑰,且該金鑰僅保存在記憶體中。每個檔案連線皆使用與該帳號相同的 路徑。每個資料中心中的連線數量受「參數 → 效能 → 「每個 Telegram 資料中心之檔案連線數」所限制;若設定為 0,則僅透過帳戶的主 連線讀取檔案。單一安裝環境中,所有帳戶同時建立的 Telegram 連線 總數最多為五個。
IP 模式#
路由方式決定連線方式。控制面板中「帳戶」 區段的 IP 模式與 IP 保護功能,將決定伺服器位址何時可能被揭露。這些控制項並不會 安裝 VPN,也不會將所有裝置流量導向特定路徑。
| 模式 | Telegram | 外部請求 |
|---|---|---|
隱藏網址 (hide) |
請使用代理伺服器;若均無法連線,請稍候。無直接備用方案。 | 需使用 SOCKS5/HTTP;若未透過適用代理伺服器,將拒絕請求。 |
僅在萬不得已時才直接使用 (fallback) |
自動 MTProxy 可能會在設定的延遲時間過後使用 Direct 連線,隨後再切回正常運作的代理伺服器。 | 建議使用已設定的外部代理伺服器或該帳戶的 SOCKS5/HTTP 路由;否則允許使用「直接連線」。 |
伺服器需透過隧道或 VPN 連接(tunnel) |
允許使用直連路徑,並可立即自動切換至備用池。 | 若未配置任何適用的代理伺服器,則允許直接連線。 |
隧道或 VPN 模式假設您會另行管理該網路。若無可運作的 隧道,目標端將能看到伺服器本身的位址。請根據 您的實際網路環境選擇模式,而非僅依選項名稱來決定。
選擇路徑#
| 路徑 | 設定 | 分隔線 |
|---|---|---|
| 自動 MTProxy | 內建清單或運算子目錄 | 維持一條可運作的 Telegram 路徑;直接備用方案取決於 IP 模式 |
| 直接 | 隧道或 VPN 模式 | Telethon 使用主機的網路路由 |
| SOCKS5 | 主機、埠號、可選的使用者名稱/密碼 | python-socks,已啟用遠端目標 DNS 功能 |
| HTTP CONNECT | 主機、埠號、可選的使用者名稱/密碼 | 僅支援純 HTTP CONNECT;尚未實作與代理伺服器本身的 TLS 連線 |
| MTProxy | 主機、埠號、密鑰 | 實驗性 Telethon 傳輸格式;32 位元十六進位數字,或 dd + 32 位元十六進位數字 |
偽 TLS ee 密鑰將被拒絕。Telethon 1.45 的正規化功能可移除前綴
與網域,但並未實作偽 TLS 功能。請貼上 tg://proxy?server=…&port=…&secret=…
或 https://t.me/proxy?server=…&port=…&secret=…,並選擇「從連結填入欄位」。
此操作會在不建立連線或儲存的情況下驗證並填入欄位;請另行檢視並儲存
路由。手動填寫欄位仍可使用。請參閱 Telegram 代理連結。
由您的安裝環境提供的公開代理伺服器#
內建清單整合了七個來源: SoliSpirit/mtproto、 zakky8/mtproto-proxy-pro、 kort0881/telegram-proxy-collector、 3yed-61/MTP-Collector、 Therealwh/MTPproxyLIST、 KhodeJav/telegram-proxy-collector 以及 tgmtproxy/telegram-mtproto-proxy-list。 此捆綁快照包含端點資訊、來源標示及下載日期。 清單項目僅作為輸入;後續的連線性檢查將決定實際使用的代理伺服器。
自動 MTProxy 會檢查 Telegram 傳輸連線狀態,維持一個可運作的代理伺服器 並在失敗時切換至另一個。當有足夠 可運作的條目時,工作區會優先選擇不同的代理伺服器;代理伺服器可以共用一個出口位址。失敗的代理伺服器 會在再次嘗試前進行休眠。若無任何代理伺服器可運作,IP 模式將決定收集 是否必須等待,或可使用直接連線。 更換代理伺服器不會變更帳戶 或刪除其日誌。路由選擇與變更皆記錄於簽名日誌中。
當自動路由處於啟用狀態時,清單預設每小時刷新一次,傳輸檢查則 每十分鐘執行一次。這些間隔時間均可自行設定。更新公開清單 會觸發刷新;僅瀏覽清單並不會變更已儲存的手動路由。
Telegram 流量與 HTTPS 請求使用不同的路由。清單下載會使用
獨立的 HTTPS 連線,並透過提供的外部請求路由進行。
TGWITNESS_PROXY_FEED_PROXY 會明確地以 HTTP/SOCKS5 代理伺服器覆寫該路由;
兩種 Compose 版本的收集器皆會轉發該路由。背景池會跟隨主要工作區。
不會將任何 Telegram 會話、API 憑證、控制面板代幣或機器人代幣傳送給資料來源提供者。
提供者名稱、快照日期及下載路徑會顯示於「清單來源」欄位下。
MTProxy 僅傳輸 Telegram 流量。工作區的 HTTP 操作(例如時間戳記、 通知、站外副本及來源檢查)在 已設定的情況下會使用獨立的 SOCKS5/HTTP 代理伺服器,之後則使用該帳戶的 SOCKS5/HTTP 路由。若未設定任一項,則「隱藏地址」功能會拒絕 該請求;其他模式則允許「直接」傳輸。外部請求可被停用。明確 設定的資訊流下載代理伺服器仍屬獨立的操作員覆寫選項。 獨立的見證服務則維持其專屬的路徑。
對於由營運商管理的私有服務,現有的伺服器環境設定
TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1 可允許私有目的地,並維持
代理端的主機名稱解析。此設定無法透過控制面板啟用。僅限公開
模式會在查詢公開解析器之前拒絕 .onion 目的地;Tor 洋蔥
服務需要明確的私有目的地設定以及合適的代理。
此 DNS 行為適用於外部 HTTP 操作,不適用於 Telegram 的傳輸層。
Cloudflare 已針對 JSON DNS 端點提供相關文件說明。
自動池參數
在「更多工具」→「參數」→「自動 MTProxy」下,設定失敗閾值、冷卻時間、 預定輪替、代理共享及允許的備援延遲。
| 控制 | 預設 |
|---|---|
| 在替換前斷開連線 | 3 項,耗時 10 分鐘 |
| 每次連線嘗試所嘗試的代理伺服器數量 | 3 |
| 首次 / 失敗後的最大休息時間 | 10 分鐘 / 6 小時 |
| 預定輪替 | 已停用;若啟用失敗 |
| 每個代理伺服器的帳戶數量 | 0:優先採用獨立條目,必要時合併。設定為 1 則會等待獲得專屬條目。 |
| 允許直接回退前的延遲時間 | 10 分鐘;隱藏地址仍拒絕 Direct |
| 資料源刷新/傳輸檢查 | 60 / 10 分鐘;主要工作區的數值適用於共享資源池 |
不同的代理伺服器可以共用一個出口位址。Telegram 的限制適用於每條路由。
若要將公開清單替換為您自己的營運商目錄,請配置以下覆寫設定。
此設定將完全停用外部訂閱功能,即使其 proxies 陣列為空時亦然。
將空目錄
複製到 proxy-config/proxies.json
,並新增您已部署的公開端點:
{"format": "tgwitness-proxy-catalog-v1", "proxies": [
{"id": "project-eu", "label": "Project EU",
"link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}
必須替換範例值。最多可接受 32 筆不同的條目。 經驗證的清單會回傳標籤/主機/埠號,且不包含共享密鑰;選取其中一項 將把其憑證儲存至工作區金庫中。在進行 明確的傳輸測試之前,可用性尚未經過測試。若目錄格式不正確,則可進行手動設定。
原生啟動:將 TGWITNESS_PROXY_CATALOG 設定為本機 JSON 路徑。Docker:
docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build
該覆蓋層以唯讀模式掛載 proxy-config;檔案必須可被容器 UID 10001 讀取。
該目錄不包含在 Git、Docker 建置環境及原始碼存檔中。此
目錄用於配置收集帳戶;witness 機器人使用其自身的
HTTP/SOCKS5 路由,而非 MTProxy。
直接備用方案受上述 IP 模式規範。變更路徑前,請先 暫停監測。儲存設定會斷開舊客戶端連線並取消未完成的登入;新 客戶端將使用已儲存的路徑。該帳戶的日誌/會話綁定關係將維持不變。 設定會取代先前路徑:編輯時請重新輸入代理伺服器憑證。
憑證採用 network.enc 加密。API 不會回傳使用者名稱、
密碼或機密金鑰。簽名紀錄包含路由類型及是否包含憑證,
但不包含端點與機密金鑰。操作者可在控制面板中查看端點。
機密欄位會在儲存、鎖定或切換工作區後清空。
「測試 Telegram 連線」功能(登入前亦可使用),會透過該路徑開啟並關閉一個臨時 且未經授權的 Telegram 連線。此功能不會聯繫任何 IP 檢查 網站。測試成功僅表示傳輸連線已建立,並不代表群組存取權限、訊息 完整傳送或匿名性。
此代理適用於 Telegram 客戶端的連線,包括 Telegram 數據中心(DC)的媒體
下載。瀏覽器、pip、SSH 以及手動調用的 TSA 工具則有獨立的路由。
代理主機名稱可於本地解析。rdns 會影響目標主機名稱;
Telegram 通常會提供數據中心的數值 IP 位址。
SOCKS5 和純 HTTP CONNECT 本身並不會加密代理憑證或 客戶端至代理的隧道。MTProto 會另行保護 Telegram 流量。在不可信的網路環境中,請使用 適當的安全通道連線至代理。私人群組 是傳輸過程中受 MTProto 保護的雲端聊天;端對端「秘密聊天」則是一種獨立的聊天 類型,由「秘密聊天」模組進行記錄。
加密與簽名#
| 層級 | 已實作 | 操作員責任 |
|---|---|---|
| Telegram 通訊流量 | Telethon MTProto | 平台可信度、傳輸路徑與可用性 |
| 網頁控制面板 | 承載者代幣、迴路預設值、請求限制 | 透過 HTTPS 或 SSH 隧道進行遠端存取 |
| 秘密 | Fernet 用於管理 API 憑證、會話、代理伺服器憑證及簽名私鑰 | 保護解密金鑰與運行主機 |
| 金庫金鑰 | 新安裝時使用本機金鑰或外部主金鑰 | 獨立的受保護儲存空間與金鑰備份 |
| 訊息與附件 | 明文應用程式儲存 | 加密磁碟/磁碟區 |
| ZIP/JSONL/CSV/HTML | 完整性檢查,無內容加密 | 保護匯出副本與傳輸內容 |
| 來源與時間 | 簽名日誌、流程收據、RFC 3161 工具 | 可信密鑰、獨立檢查點/TSA 及保管程序 |
「帳戶」中的儲存保護功能會顯示這些狀態。面板憑證是一種 存取密鑰,而非加密密碼。它授予管理員存取權限; 已發行的憑證可限定於特定帳戶和聊天室。工作區共享 主進程,並非獨立的租戶。
BitLocker、LUKS、FileVault 或受管加密卷宗皆可在 各自的威脅模型下保護儲存裝置。 已解鎖且正在運行的機器之管理員 仍可讀取資料。在儲存規劃中,應納入 SQLite WAL/SHM、媒體檔案、臨時匯出檔案、交換檔、備份 以及瀏覽器下載檔案。Docker 卷宗並非僅因 其為卷宗而自動加密。
外部主金鑰#
若要進行新安裝,請將主金鑰放置於資料目錄之外。 此操作不會自動遷移現有的本機金鑰保管庫。請準備一個 僅限服務身分存取的金鑰目錄,然後執行:
python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case
PowerShell,使用已安裝的專案環境:
python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case
在 Docker 中,請將檔案以唯讀方式掛載至 /data 之外的目錄(例如
/run/secrets/tgwitness-master.key),並將環境變數設定為該路徑。
該服務的 UID 必須具備讀取權限。請透過
環境變數/設定檔傳遞路徑,而非金鑰位元組。
每個工作區都會獲得一個隨機的公開鹽值,以及透過
HKDF-SHA256 衍生的專屬 Fernet 金鑰。vault.external.json 僅儲存衍生元數據,而非主金鑰。
若金鑰遺失或錯誤,系統將無法啟動,且不會在後台自動替換金鑰。請同時保留
鹽值元數據與主金鑰,以備復原之用。
所有工作區均源自同一主金鑰;若主金鑰遭洩露,將影響整個 安裝環境。正在執行的程序可解密機密資料。此工具並非 HSM 或 密碼 KDF。不接受以任意人為設定的密碼取代隨機金鑰。
在刻意規劃的遷移方案
實施並驗證完成之前,請保留現有安裝環境中的現有金鑰。刪除 vault.key 或更換主金鑰可能會導致
無法存取會話/簽署金鑰。請將加密備份與金鑰分開存放,並
在隔離的實例中測試還原功能。