技術文章

Gears 檔案工作台與本機處理的設計

本頁內容
  1. 另外做一個產品的原因
  2. 取代「頁面不連網」的檢查方式
  3. 頁面的 CSP
  4. 逐字稿 Worker 的對外請求
  5. 套件新增的對外連線
  6. 網址檢查的本機比對
  7. Cloudflare 的注入與壓縮
  8. 使用統計
  9. Tor Browser 的 canvas 亂數
  10. 目前的對外連線
  11. 還沒做到的部分
  12. 相關閱讀

手機拍的照片裡,通常記著拍攝地點的經緯度、手機型號與精確到秒的時間。聊天截圖上有對方的名字與頭像,Word 檔記著作者、公司名稱,有時還有電腦上的資料夾路徑。這類資訊統稱中繼資料(metadata),平常無害。檔案一旦交給記者、貼到網路上或寄給不完全信任的人,就可能讓提供檔案的人被認出來。

清除這些資訊的線上服務不少,幾乎都要先上傳檔案。為了保護一張照片,反而需先把它交給一台不認識的伺服器。Gears 檔案工作台把清除中繼資料、遮蔽個資、加密這些處理放進讀者的瀏覽器,檔案預設不離開裝置。Gears 也用了文件站不能用的套件與模型,所以頁面可以連到哪裡,都寫在讀者能自行檢查的地方。

另外做一個產品的原因

Gears 的前身是文件站的小工具區。扣除機器流量之後,小工具區是文件站首頁以外最多人使用的一區,用得最多的是清除中繼資料、遮蔽、密語產生器、QR code 與網址清理。使用的人多半是一般的正體中文使用者,需求跟 Tor 沒有直接關係。

文件站的小工具有三條規則:離線可用、頁面不連網、沒有建置流程。這些規則讓文件站在斷網的地方仍然可用,也限制了工具的規模。偵測人臉只能用 240 KB 的輕量偵測器,常常漏掉合照裡的小臉,清除中繼資料的工具也無法讀取 iPhone 預設的 HEIC 照片。從搜尋引擎進來的讀者又幾乎不會進到小工具區,需要這些工具的人不容易發現它們。

2026-10-14 我們決定把小工具延伸成獨立的產品,文件站的小工具維持原樣。Gears 可以用 npm 套件、打包工具與幾百 MB 的模型,換來文件站無法提供的功能,包括 HEIC 照片的清除、PDF 的遮蔽、錄音轉逐字稿與查證收到的檔案。Gears 的首頁(桌面)依讀者的目的分成「交出去之前」、「安全地傳送」、「檢查收到的」三組,所有工具共用一個只存在記憶體裡的暫存區,關掉分頁就清空。兩天後第一版上線,逐字稿與查證已經在裡面,遠端傳送接著在 10-20 加入。

Gears 的桌面,左側是暫存區與選擇檔案的按鈕,右側的工具分成交出去之前、安全地傳送、檢查收到的三組

取代「頁面不連網」的檢查方式

文件站的小工具因為有「頁面不連網」的規則,讀者不必相信我們,也能確定檔案不會被送走。Gears 拿掉了這條規則。npm 套件裡有幾萬行不是我們寫的程式,逐字稿的大模型要從 Hugging Face(公開的機器學習模型託管平台)下載,遠端傳送要經過社群的伺服器。每多一項,讀者就多一處無法自行確認、只能相信我們說法的地方。

Gears 把頁面可以連線的對象寫在讀者能自行檢查的地方,需要連網的功能逐一說明送出了什麼、誰可以得知。還沒做到的部分也不迴避,一併寫出來。

頁面的 CSP

CSP(Content Security Policy,內容安全政策)是網站交給瀏覽器的一份規則,列出頁面可以從哪裡載入程式、可以連線到哪裡,規則以外的請求由瀏覽器直接擋下。Gears 在每個頁面的 <head> 放一個 meta 標籤,clearnet 版(一般網路上的 anoni.net)的內容如下(兩個送出網址換成說明):

default-src 'none'; script-src 'self' 'wasm-unsafe-eval'; style-src 'self';
img-src 'self' blob: data:; media-src blob:;
connect-src 'self' <使用統計的送出網址> <建議與回饋的送出網址>;
worker-src 'self' blob:; font-src 'self'; manifest-src 'self';
base-uri 'none'; form-action 'none'

connect-src 限制程式可以連線的對象。即使某個相依套件被植入惡意程式,fetch、XMLHttpRequest 與 WebSocket 也只能連到 Gears 自己的網域與兩個送出網址,讀者的檔案無法送出。規則就在頁面原始碼裡,在瀏覽器選「檢視原始碼」就可以看到,不必相信我們的說法。wasm-unsafe-eval 讓 HEIC 解碼器與辨識模型可以執行 WebAssembly(瀏覽器裡以接近原生速度執行的程式格式),它只允許編譯 WebAssembly,JavaScript 的 eval 仍然無法使用。

規則由 vite.config.ts 的 policy() 產生,新增任何對外連線都要改那裡,畫面上也要標示。程式審查時可以直接看出新增了哪些連線。

逐字稿 Worker 的對外請求

逐字稿的語音辨識在 Web Worker(瀏覽器在背景另開的執行緒)裡執行,避免轉錄時畫面停住。Worker 從網址載入時,套用的是 Worker 腳本本身回應標頭裡的 CSP,頁面 meta 標籤的規則不適用於 Worker。

2026-10-15 加入逐字稿時,Transformers.js(在瀏覽器執行機器學習模型的函式庫)內含一份 onnxruntime-web(模型的執行引擎),預設從 jsDelivr(公開的 CDN)下載 WebAssembly。當時只有 meta 標籤的 CSP,Worker 不受限制,請求因此送了出去。改法是用 Vite 的 ?url 匯入那一份 WebAssembly,從自己的網域載入。nginx 也改成用標頭送一份 CSP,Worker 從此受到同一組規則約束。頁面同時有標頭與 meta 標籤時,請求要兩邊都符合才放行,頁面本身仍然只能連到 meta 標籤列出的對象。

同樣的錯誤現在由瀏覽器測試把關。tests/e2e/guard.ts 在每個測試記下頁面發出的請求與主控台錯誤。只要有連到測試伺服器以外的請求,或主控台出現被 CSP 擋下的錯誤,測試就失敗。

逐字稿的 large-v3-turbo 約 760 MB,從社群的主機送出流量太重,改由讀者選擇之後從 Hugging Face 下載。按鈕寫成「從 Hugging Face 下載並開始」,按下之前畫面先說明 Hugging Face 可以得知 IP 位址、瀏覽器與下載了哪個模型。標頭的 CSP 只允許那幾個模型在固定 commit 下的下載路徑。每個檔案讀完會比對 SHA-256 雜湊值,不符就不儲存,請求也不帶 cookie 與 Referer。

逐字稿選擇模型的畫面,選了 large-v3-turbo 之後,下方說明模型從 Hugging Face 下載、Hugging Face 會看到 IP 位址、瀏覽器與下載的模型,錄音不會送出

套件新增的對外連線

CSP 是最後一道防線,平常的檢查在升級套件時進行,先在套件裡搜尋對外的網址。2026-10-15 Gears 加入人臉偵測時,第一版用的是 MediaPipe(Google 的機器學習套件)。選版本時在套件裡搜尋,發現 @mediapipe/tasks-vision 從 1.0.0 起多了送往 odml.pa.googleapis.com 的網址,所以停在還沒有這段程式的 0.10.35。CSP 可以擋下這種請求,但擋下之後主控台會留下錯誤,也很難確定套件在請求失敗之後執行了哪一段程式。所以要在升級時就發現套件新增的對外連線。同一天人臉偵測因為準確度改用 OpenCV 的 YuNet,MediaPipe 也從 Gears 移除。

有些請求只能靠 CSP 擋下。查證工具用 c2pa-web(C2PA 標準的開源函式庫)驗證內容憑證(相機與編輯軟體附在檔案上的來源紀錄)。遇到其中的身分聲明時,底下的 c2pa-rs 會連線取得簽發者的金鑰,而且沒有設定可以關閉(c2pa-rs issue #1645)。這個請求由 CSP 擋下,是 Gears 唯一預期會出現的 CSP 錯誤,測試只允許這一個路徑的錯誤。

網址檢查的本機比對

收到可疑的簡訊連結時,讀者可以貼進 Gears 的網址檢查,比對 165 反詐騙諮詢專線公開的「遭停止解析涉詐網站」清單。最直接的做法是把網址送到伺服器查詢,但伺服器上的查詢紀錄會累積成一份名單,記下誰收到了哪些詐騙連結。

2026-10-14 查證時,清單有 86,173 個不重複的網域,整理成純文字約 1.5 MB。壓縮後約 400 KB,整份放進瀏覽器比對也不算大。Gears 在部署時下載清單,跟網站一起送到讀者的瀏覽器,網址完全不必送出。清單裡有共用平台的子網域,為了不把整個平台標成詐騙,比對時用完整的主機名稱。清單只收已經停止解析的網域,畫面上也寫明不在清單裡不代表安全。

我們評估之後決定不展開短網址。由伺服器代為連線的話,任何人都能用自己的短網址取得主機的真實 IP,主機也可能被當成探測內部網路的跳板。詐騙簡訊常給每個收件人不同的短網址。代為展開時,詐騙方的紀錄會多一次點擊,等於替讀者向對方確認收到了訊息。遇到短網址時,Gears 提醒讀者請對方提供完整的網址。

Cloudflare 的注入與壓縮

讀者取得的頁面要跟建置產物相同,才能拿來跟公開的原始碼比對。anoni.net 前面是 Cloudflare,它會在整個 zone(同一個網域的設定範圍)的 HTML 回應裡注入 Web Analytics 與 JS Detections(Cloudflare 的流量統計與機器人偵測)的 script。Gears 的 CSP 會擋下這些 script,回應另外帶上 Cache-Control: no-transform,要求 Cloudflare 不改動內容。

2026-10-17 第一次部署時,no-transform 加在所有檔案上。帶了它的回應,Cloudflare 完全不壓縮,連 nginx 送出的 gzip 也會解開。上線後實測,1.5 MB 的 165 清單與 14 MB 的 onnxruntime WebAssembly 都以原始大小送到讀者手上。注入只發生在 HTML,所以改成只有頁面與圖片帶 no-transform(圖片是為了避開 Polish 重新壓縮)。其他檔案交給 Cloudflare 壓縮,WebAssembly 壓縮後約小四分之三。

Cloudflare 在邊緣節點(離讀者最近的機房)解開 TLS,經過的檔案在 Cloudflare 上是明文。所以 Gears 的原則寫明,上傳檔案的端點不經過 Cloudflare。遠端傳送是例外,clearnet 的入口經過 Cloudflare,因為內容在兩端之間另外加密。分享連結的 # 後面帶著一把金鑰,瀏覽器不會把 # 之後的內容送到伺服器。兩端用它導出金鑰之後,每則訊息再用 AES-256-GCM 加密,轉送服務與 Cloudflare 只經手密文。

Cloudflare 仍然可以得知兩端的 IP 與連線時間,產生連結之前畫面上會寫明。經過哪些伺服器、記下什麼,另外寫在遠端傳送的伺服器說明。通訊軟體產生連結預覽時,可能先在它的伺服器上打開網址。為了不讓預覽占用一次性的房間,打開分享連結之後要按「加入」才會連線。

遠端傳送產生連結之前的說明,路線是你、Cloudflare、中繼伺服器、對方,表格列出中繼伺服器與 Cloudflare 可得知 IP 位址與連線時間,無法得知檔名、內容與文字訊息

使用統計

維護者需要知道讀者打開哪些工具、是否處理完、在哪裡失敗。Gears 不載入 Umami(開源的網站流量統計服務)的 script,由程式直接把事件送到社群自架的 Umami,CSP 只允許那一個網址。

每個事件只能帶白名單裡的欄位,值也要在清單裡,不符就整筆不送。檔名、檔案大小、檔案內容、讀者輸入的文字、檢查的網址、信件的寄件人、雜湊值與查證的結果都不送,螢幕尺寸只取到百位數。瀏覽器開了 Do Not Track 或 Global Privacy Control(瀏覽器通知網站不要追蹤的設定)時一律不送,讀者也可以在頁尾選擇不記錄。建置 onion 版(經由 Tor 連線的 .onion 網站)時會移除整段統計程式,產物裡沒有送出統計的程式碼。

Tor Browser 的 canvas 亂數

onion 版放在 gears.<onion>,建置之後由 scripts/check-site.mjs --onion 確認產物裡沒有連到 clearnet 的 anoni.net。2026-10-17 製作 onion 版時,我們發現在 Tor Browser 15.0 的一般安全等級下,canvas(網頁上用程式繪圖的元件)的 getImageData 與 toBlob 在讀者允許之前一律回傳亂數而不報錯。HEIC 轉 JPEG、PDF 轉成圖片這類要從 canvas 讀回像素的工具,因此輸出一張看起來正常、內容卻是雜訊的圖。

現在 src/ui/canvas-access.ts 在讀取之前先畫四個點再讀回比對,不符就停止。畫面會請讀者在網址列的 canvas 圖示允許之後再按一次,同一個分頁之後就正常。

Tor Browser 不支援 service worker(讓網頁離線也能開啟的背景程式),onion 版不能離線使用。Tor Browser 也沒有 cross-origin isolation(多執行緒運算需要的隔離設定),逐字稿只能用 1 個 CPU 核心。WebRTC 完全停用,面對面傳送無法使用。這些限制都寫在畫面上,原本面對面傳送的位置改為建議使用遠端傳送,或完全不經過伺服器的 OnionShare(經由 Tor 分享檔案的開源工具)。

目前的對外連線

Gears 目前的對外連線如下表,打開瀏覽器開發者工具的網路分頁就能逐項對照。

連到哪裡 什麼時候 送出什麼、誰可得知
anoni.net 自己的網域 開啟頁面、第一次用到某個工具時 頁面、程式與模型檔的請求,不含讀者的檔案
社群自架的 Umami 使用工具時,開了 Do Not Track、Global Privacy Control 或選擇不記錄時不送 工具代號、事件與失敗原因的代碼
社群自架的 Formbricks(開源的表單服務) 讀者在「建議與回饋」按下送出 讀者填寫的內容、從哪個工具過來、介面語系與版本
assets.anoni.net 讀者選了社群轉檔的逐字稿模型 模型檔的請求
Hugging Face 讀者選擇逐字稿的 large-v3-turbo,並按下下載 模型檔的請求,Hugging Face 可得知 IP、瀏覽器與下載的模型
遠端傳送的轉送服務 讀者產生或加入遠端傳送的連結 兩端之間加密過的內容,經手的 Cloudflare 可得知 IP 與時間
Cloudflare Realtime 的 TURN(無法直接連線時轉送影音的伺服器) 遠端傳送的視訊通話 加密過的影音,TURN 伺服器可得知兩端的 IP

onion 版沒有使用統計,社群轉檔的模型也改由同一個 onion 網站提供。

還沒做到的部分

在 clearnet 選擇從 Hugging Face 下載大模型時,Hugging Face 可以得知讀者的 IP。遠端傳送的視訊通話經過 Cloudflare Realtime 的 TURN,社群自架的 coturn(開源的 TURN 伺服器)已經設定好、驗證過,還在等一台 VPS。

CSP 能防範被植入惡意程式的相依套件,無法防範被入侵的伺服器。伺服器被入侵時,送出的頁面連同 CSP 都可能被替換。要確認網站上執行的就是 repo 裡的原始碼,需要兩段比對。第一段是網站與 build 分支:網站在 GitHub Actions 公開建置,產物推到 repo 公開的 build 分支,讀者現在就可以拿網站上的檔案跟它比對。

第二段是 build 分支與原始碼,也就是可重現建置(reproducible build):任何人從同一個 commit 建置,都要得到逐位元組相同的檔案。這部分還沒做到,也還沒驗證過。已知的障礙是 165 清單在建置時下載,網站每週一自動重建一次。同一個 commit 在不同週建置出來的清單不同,service worker 的版本號也跟著不同。

Gears 還在 Beta,文中的版本、數字與檔案位置都是發文時的狀態。對實作的意見歡迎到 anoni-net/gears 開 issue,也可以在 Gears 的「建議與回饋」留言。

相關閱讀