Gears 檔案工作台與本機處理的設計
本頁內容
手機拍的照片裡,通常記著拍攝地點的經緯度、手機型號與精確到秒的時間。聊天截圖上有對方的名字與頭像,Word 檔記著作者、公司名稱,有時還有電腦上的資料夾路徑。這類資訊統稱中繼資料(metadata),平常無害。檔案一旦交給記者、貼到網路上或寄給不完全信任的人,就可能讓提供檔案的人被認出來。
清除這些資訊的線上服務不少,幾乎都要先上傳檔案。為了保護一張照片,反而需先把它交給一台不認識的伺服器。Gears 檔案工作台把清除中繼資料、遮蔽個資、加密這些處理放進讀者的瀏覽器,檔案預設不離開裝置。Gears 也用了文件站不能用的套件與模型,所以頁面可以連到哪裡,都寫在讀者能自行檢查的地方。
另外做一個產品的原因
Gears 的前身是文件站的小工具區。扣除機器流量之後,小工具區是文件站首頁以外最多人使用的一區,用得最多的是清除中繼資料、遮蔽、密語產生器、QR code 與網址清理。使用的人多半是一般的正體中文使用者,需求跟 Tor 沒有直接關係。
文件站的小工具有三條規則:離線可用、頁面不連網、沒有建置流程。這些規則讓文件站在斷網的地方仍然可用,也限制了工具的規模。偵測人臉只能用 240 KB 的輕量偵測器,常常漏掉合照裡的小臉,清除中繼資料的工具也無法讀取 iPhone 預設的 HEIC 照片。從搜尋引擎進來的讀者又幾乎不會進到小工具區,需要這些工具的人不容易發現它們。
2026-10-14 我們決定把小工具延伸成獨立的產品,文件站的小工具維持原樣。Gears 可以用 npm 套件、打包工具與幾百 MB 的模型,換來文件站無法提供的功能,包括 HEIC 照片的清除、PDF 的遮蔽、錄音轉逐字稿與查證收到的檔案。Gears 的首頁(桌面)依讀者的目的分成「交出去之前」、「安全地傳送」、「檢查收到的」三組,所有工具共用一個只存在記憶體裡的暫存區,關掉分頁就清空。兩天後第一版上線,逐字稿與查證已經在裡面,遠端傳送接著在 10-20 加入。

取代「頁面不連網」的檢查方式
文件站的小工具因為有「頁面不連網」的規則,讀者不必相信我們,也能確定檔案不會被送走。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。

套件新增的對外連線
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 與連線時間,產生連結之前畫面上會寫明。經過哪些伺服器、記下什麼,另外寫在遠端傳送的伺服器說明。通訊軟體產生連結預覽時,可能先在它的伺服器上打開網址。為了不讓預覽占用一次性的房間,打開分享連結之後要按「加入」才會連線。

使用統計
維護者需要知道讀者打開哪些工具、是否處理完、在哪裡失敗。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 的「建議與回饋」留言。
相關閱讀
- 文件站離線閱讀與本機加密的技術設計:Gears 的離線使用與 age 加密沿用同一套思路
- 遠端傳送的伺服器說明:轉送服務經過哪些伺服器、可以得知與保存什麼
- Gears 的設計文件:本文提到的每一項設計,在這裡有完整的規格與測試方式