macOS 14+ 與 Apple Silicon
當前安裝包不支援 Intel Mac，也不支援 macOS 13 及更早版本。目標 HTTP/HTTPS 服務必須已經啟動，並能從當前 Mac 直接訪問；企業或校園網路還應能夠連線 Cloudflare 網路。
下載官方檔案並校驗 SHA-256
官方下載檔名為 ZhiHua-JieSuo-4.1.3-macOS-arm64.zip，大小约 21.7 MB。首次运行前可在“终端”执行以下命令：
shasum -a 256 ~/Downloads/ZhiHua-JieSuo-4.1.3-macOS-arm64.zip77db2aa9e6c7a51d7a95efdfd27d329f3a22e7982b689603d32a612650506338結果必須完全一致。如果不同，請不要開啟檔案，刪除後從知華科技官網重新下載。校驗可以發現下載損壞或檔案被替換，但不能替代對來源和用途的判斷。
安裝到“應用程式”後再啟動
解壓下載檔案
連按兩下 ZIP 檔案完成解壓，不要長期在瀏覽器臨時下載目錄中執行。
移動應用
開啟解壓後的資料夾，將“知華界梭.app”拖入 Finder 的“應用程式”資料夾。
從應用程式啟動
前往“應用程式”，連按兩下“知華界梭”。如被系統攔截，先閱讀下一節再處理。
確認使用邊界
閱讀首次使用提示、隱私說明和公網釋出風險，確認後進入主介面。
遇到“Apple 無法檢查是否包含惡意軟體”怎麼辦
當前公開版使用本地臨時簽名，尚未透過 Apple Developer ID 正式簽名與公證。只有在檔案來自知華科技官網且 SHA-256 一致時，才可先嚐試開啟一次，然後前往“系統設定 → 隱私與安全性”，在安全性區域選擇“仍要開啟”並核對應用名稱。不要對來源不明或校驗不一致的檔案執行該操作。
填寫本地服務並啟動臨時公網隧道
127.0.0.1 表示当前 Mac。访问局域网其他设备时，应填写目标设备 IP，并先确认当前 Mac 可以直接访问它。
| 場景 | 協議 | IP或主機名 | 埠 |
|---|---|---|---|
| 本機前端開發服務 | 自動 | 127.0.0.1 | 3000 |
| 本機 API | HTTP | 127.0.0.1 | 8080 |
| 本機 HTTPS 服務 | HTTPS | 127.0.0.1 | 8443 |
| 區域網裝置頁面 | 自動 | 192.168.1.20 | 80 |
- 確認“本地服務”狀態正常，應用會定期重新檢測。
- 點選“啟動服務”，確認目標服務由你所有或已經獲得授權。
- 等待狀態從檢查中、連線中變為執行中。
- 複製隨機生成的
https://*.trycloudflare.com地址并测试。 - 使用結束後停止服務，原臨時地址隨之失效。
協議自動檢測、HTTPS 與多個服務
“自動”適合不確定本地目標協議時使用；明確為 HTTP 或 HTTPS 時可直接選擇。公網入口始終為 HTTPS，但客戶端到本地目標仍按所選協議連線。本地 HTTPS 使用自簽名證書時可開啟允許自簽名選項，該設定會關閉這一段連線的證書驗證，只應對自己瞭解並信任的本地目標使用。
點選左側“代理服務”旁的加號可新增服務。每項服務擁有獨立名稱、IP、埠、協議、隧道程序和隨機公網地址。執行中的服務應先停止再修改或刪除。
狀態含義與故障判斷
排查時優先檢視“執行記錄”的最後一條紅色或黃色資訊。先驗證本地地址，再判斷隧道網路和公網自檢，避免同時修改多個條件。
停止、退出與解除安裝
點選單個服務“停止”或“全部停止”可關閉隧道。關閉主視窗不等於退出應用，應從選單欄選擇“知華界梭 → 退出知華界梭”或按 Command + Q。解除安裝時先退出，再把“知華界梭.app”移到廢紙簍；如需刪除配置，可檢查 ~/Library/Preferences/cn.zhuatech.jiesuo.plist。
安全、隱私與使用邊界
- 僅用於開發、聯調、測試、演示與短時分享，不適合生產環境。
- 只支援 HTTP/HTTPS Web 服務，不是 VPN，不支援通用 TCP/UDP 轉發。
- 公網連結預設沒有知華界梭提供的密碼或身份認證。
- 不要釋出資料庫、路由器後臺、裝置管理頁、無認證後臺、機密檔案或敏感資料。
- 僅釋出自己擁有或已獲得明確授權的服務，禁止未授權訪問、攻擊、隱匿代理或非法用途。
- 流量經過 Cloudflare 網路，並受 Cloudflare 條款、隱私政策和技術限制約束。
macOS 版常見問題
本地服務顯示異常怎麼排查？+
先在當前 Mac 的瀏覽器直接開啟本地地址，例如 http://127.0.0.1:3000。確認服務已啟動、IP與埠正確、HTTP/HTTPS匹配；訪問區域網裝置時還要檢查防火牆和網路可達性。
公網地址長時間無法生成怎麼辦？+
檢視執行記錄最後一條錯誤，確認網路可以訪問 Cloudflare，並在停止後重試。企業、校園或受限網路可能攔截 Cloudflare Tunnel。
開啟公網連結顯示 502 Bad Gateway 是什麼原因？+
通常說明隧道存在但無法訪問本地目標。檢查本地服務、埠、協議，以及本地 HTTPS 是否使用未受信任的自簽名證書。
為什麼不支援 Intel Mac？+
當前公開安裝包只為 Apple Silicon arm64 構建，適用於 M1、M2、M3、M4 及後續晶片。Intel Mac 請不要下載或嘗試繞過架構限制。
“仍要開啟”按鈕在哪裡？+
通常需要先在“應用程式”中嘗試啟動一次，再開啟“系統設定 → 隱私與安全性”向下滾動檢視。該入口可能只在攔截後的一段時間內出現。
官方參考資料
- Apple：在 Mac 上安全地開啟 AppApple Support
- Cloudflare Quick Tunnels 官方說明Cloudflare Developers