RoamSwitch for Mac 操作手冊

依實際顯示順序，逐一詳細說明從選單列圖示開啟的選單中的每個項目。即使是初次使用 RoamSwitch 的使用者，只要依此順序一邊開啟選單一邊閱讀，也不會感到迷失。

1. 關於本手冊

RoamSwitch 是一款以 🛡️ 圖示常駐於 Mac 選單列的應用程式。與一般需要點選 Dock 圖示開啟的應用程式不同，您完全不需要一直保持視窗開啟。只要點選畫面右上方選單列中的圖示，就會依當時狀況開啟對應的選單。

選單的內容並非固定不變，顯示的項目會依當下的狀態而改變。例如「授權輔助程式」只會在輔助程式尚未獲得授權時顯示，一旦完成授權便會消失。同樣地，「解除 Air-Gap 隔離」也只會在隔離實際發動時才會出現。本手冊為這類「條件式顯示的項目」標上條件式顯示的記號。

此外，許多進階功能都標有 Pro 標記，代表這項功能需要購買（或試用）RoamSwitch Pro 後才能啟用。沒有此標記的項目皆可免費使用。

2. 選單列圖示與狀態顯示

選單最上方會顯示一行文字，說明目前的保護狀態。例如 🛡️ 已在信任網路中受到保護，以圖示搭配簡短文字讓您一眼看懂目前狀態。點選此行即可開啟畫面，查看更詳細的目前狀態說明。

圖示本身的外觀也會依狀態而改變（例如隔離期間會轉為警示色）。設計上，只要看一眼選單列圖示，就能大致掌握「目前受到多少程度的保護」。

3. 授權輔助程式（僅首次）條件式顯示

為了實際阻擋網路流量或切換防火牆，RoamSwitch 會使用一個以管理員權限執行、稱為「輔助程式」的小型附加程式。安裝完成後，只要這個輔助程式尚未獲得授權，選單上方就會顯示 ⚠️ 授權輔助程式… 這個項目。

點選後會顯示 macOS 管理員密碼輸入畫面。輸入密碼並授權後，此項目將永久消失，此後所有保護功能都會自動運作。在完成此項授權之前，RoamSwitch 無法真正阻擋網路流量。請務必將此步驟納入初次設定的一部分完成。

操作步驟

1. 點選選單列的 🛡️ 圖示，選擇⚠️ 授權輔助程式…。
2. 在顯示的 macOS 對話框中，輸入這台 Mac 的管理員（Admin）帳號名稱與密碼。
3. 點選「允許變更」。當對話框關閉、該項目從選單中消失，即代表授權完成。

4. Air-Gap 隔離中的顯示與解除 條件式顯示

「Air-Gap」是當 RoamSwitch 偵測到惡意軟體、ARP 欺騙等嚴重威脅時，將 Mac 從網路實體切斷的緊急防禦功能。發動期間，選單上方會顯示隔離的種類（全面隔離／降級模式），若已知原因，也會一併顯示發動理由。

操作步驟

1. 點選選單列的 🛡️ 圖示，選擇隔離狀態行（🔒 隔離中…）下方的ℹ️ 隔離狀態與解除說明…，確認發動原因。
2. 若沒有任何可疑操作，請從同一個選單選擇🔓 解除 Air-Gap 隔離。
3. 在確認對話框中選擇「解除」，即可當場恢復網路通訊。

5. Wi-Fi 連線資訊顯示 條件式顯示

連接 Wi-Fi 時，會以一行文字顯示所連線的網路名稱（SSID）與加密方式（如 WPA3）。點選後，可查看訊號強度、頻段等更詳細的連線資訊。若僅以有線區域網路連線，則不會顯示此行。

6. 登錄與切換目前的網路

RoamSwitch 的核心概念是「在自宅或職場等可信任的地點放寬管制，在其他未知網路則嚴格防護」。為此，只要先將目前所在的網路登錄一次，日後再次來到該地點時，就能自動切換為適當的安全等級。

若您位於尚未登錄的網路

操作步驟

1. 在 Mac 已連接到想要登錄的網路的狀態下，點選選單列的 🛡️ 圖示。
2. 將游標移到登錄目前的網路上，從開啟的子選單中選擇「自宅」「職場」「行動分享」其中之一，或選擇「以自訂名稱登錄…」。
3. 若選擇「以自訂名稱登錄…」，請在顯示的輸入欄中輸入您喜歡的名稱，接著選擇安全等級並點選「登錄」。

若您位於已登錄的網路

子選單會以單選按鈕列出可為該網路設定的安全等級（信任、標準保護等），目前選用的等級會加上勾選記號。點選任一等級即可立即切換。分隔線下方有「重新命名…」與「取消登錄」，可用來修改網路的名稱，或直接取消該登錄。

操作步驟

1. 變更安全等級時：從選單列 🛡️ 圖示 →目前的網路: {登錄名稱}，只要點選想切換的等級即可立即套用。
2. 重新命名時：點選同一個子選單分隔線下方的「重新命名…」，輸入新名稱後點選「儲存」。
3. 取消登錄時：點選同一個子選單中的「取消登錄」。下次連接此網路時將視為「未登錄」，並套用外出預設保護（第 8 章）。

7. 管理已登錄的網路

至今登錄過的所有網路，都會以清單形式列在子選單中。每個項目會以 {登錄名稱} [{安全等級}] ({MAC 位址局部)} 的格式顯示，其後接續與第 6 章相同的安全等級切換、重新命名、取消登錄選單。當您想彙整檢視曾在外出時登錄、目前不在附近的網路時，可使用此功能。若尚未登錄任何網路，則會顯示相對應的空白狀態。

操作步驟

1. 將游標移到選單列 🛡️ 圖示的已登錄的網路（數量）上。
2. 將游標移到想要調整的網路項目上，會出現與第 6 章相同的安全等級清單、「重新命名…」與「取消登錄」，請選擇所需的操作。

8. 外出預設保護

連接到咖啡廳、車站、機場等從未登錄過的網路時，會自動套用的安全等級。您可以從子選單中選擇來變更這個預設等級。由於對陌生網路愈是不可掉以輕心，初始狀態下會選用最嚴格的等級。除非有充分理由，否則建議不要調降此等級。

操作步驟

1. 將游標移到選單列 🛡️ 圖示的外出預設保護: {等級}上。
2. 從開啟的子選單中，點選想設為預設的安全等級。

9. 惡意軟體防護（XProtect & ClamAV）

這是 RoamSwitch 選單中項目最多的子選單。從 macOS 內建的 XProtect、免費防毒軟體 ClamAV，到 Web／郵件下載保護、DNS 層級的威脅防禦、釣魚連結偵測，再加上大量 Pro 專屬監控功能，所有與惡意軟體、未授權存取相關的設定都集中在這裡。以下依由上而下的順序逐一介紹。

9.1 Apple XProtect

可確認 macOS 內建的惡意軟體偵測引擎 XProtect 目前的版本與運作狀態。「檢查 XProtect 運作狀態…」可查看詳細內容，「診斷檔案安全性…」則可對個別檔案進行簡易檢查。RoamSwitch 並未額外新增什麼，這個項目只是將 Mac 中已內建的保護功能可視化而已。

操作步驟

1. 檢查個別檔案時：從惡意軟體防護子選單選擇「診斷檔案安全性…」，在開啟的視窗中從 Finder 拖放檔案，或點選「選擇檔案」指定想檢查的檔案。

9.2 ClamAV（免費防毒軟體）

ClamAV 是開放原始碼的免費防毒引擎。若已安裝，可從子選單執行「立即快速掃描」「自訂掃描（指定資料夾）」「更新病毒碼」「管理隔離的檔案」等。若尚未安裝，則會改為顯示安裝提示。

操作步驟

1. 執行掃描時：在惡意軟體防護子選單→ClamAV 中，選擇「立即快速掃描」，或選擇「自訂掃描…」並指定資料夾。進度可在選單列圖示或掃描視窗中確認，完成後會以通知顯示結果。
2. 處理遭隔離的檔案時：從同一個子選單開啟「隔離管理」，從清單中選擇檔案，並選擇「還原」（若為誤判則移回原位置）或「永久刪除」。
3. 更新病毒碼時：從同一個子選單點選「更新病毒碼」。最新的病毒碼會透過網際網路取得。

9.3 Web・郵件保護（下載自動掃描）Pro

每當指定監控的資料夾（例如下載資料夾）中出現新檔案時，自動執行病毒掃描的功能。這代表在您透過瀏覽器下載檔案，或儲存郵件附件的瞬間，就能在開啟前完成檢查。可透過開關切換啟用／停用，以「📁 監控資料夾」新增或編輯對象，並在「隔離管理」中查看依掃描結果遭隔離的檔案。啟用時，也會顯示最近的掃描記錄。

操作步驟

1. 在惡意軟體防護子選單中查看「Web 與郵件保護」一行。啟用 Pro 後它已處於開啟狀態。如果你曾把它關閉，點擊該行即可重新開啟開關。
2. 開啟「📁 監控資料夾」，透過「新增資料夾」選擇下載資料夾等想監控的位置，然後「儲存」（預設已包含下載資料夾）。
3. 之後，只要該資料夾出現新檔案，就會自動進行掃描。偵測到威脅時會收到通知，檔案也會移至隔離管理。

9.4 DNS 威脅防護（惡意網站・C2 封鎖）Pro

在 DNS 層級直接封鎖對危險網域的名稱解析，例如釣魚網站，或惡意軟體用來與攻擊者伺服器通訊的「C2（指令伺服器）」。開啟開關後，於「供應商」選擇要使用哪個安全 DNS 服務，並於「適用政策」設定套用範圍。啟用時，選單最下方會顯示目前安全 DNS 是否實際生效，或因位於信任網路而被排除適用。

操作步驟

1. 在惡意軟體防護子選單中查看「DNS 威脅防護」一行。啟用 Pro 後它已處於開啟狀態。如果你曾把它關閉，點擊該行即可重新開啟開關。
2. 將游標移到「供應商」上，點選想使用的安全 DNS 服務。
3. 將游標移到「適用政策」上，選擇要套用的範圍（所有網路／僅限未信任的網路等）。

9.5 連結保護（釣魚連線偵測）Pro

將您即將點選的連結，以及應用程式正嘗試連線的目標，與已知釣魚網站清單即時比對並發出警告的功能。可從子選單選擇運作模式，也能確認釣魚資訊來源的更新狀態，並切換自動更新的開關。啟用時，也會顯示目前實際透過哪種機制（瀏覽器擴充功能、網路層等）進行檢查。

操作步驟

1. 在惡意軟體防護子選單中，將游標移到「連結保護」上，點選動作模式（僅通知／自動封鎖等）進行選擇。
2. 點選「自動更新」該行，即可開啟或關閉釣魚資訊來源的自動更新。

9.6 隨手可用的手動檢查工具

操作步驟

1. 手動檢查連結：選擇此項目後會開啟輸入欄，請貼上想確認的 URL 並點選「檢查」。幾秒後即會顯示安全性判定結果。
2. 手動稽核機密資訊、API 金鑰外洩：選擇此項目後會開始掃描，完成後會列出偵測結果（檔案路徑與類型）的清單。
3. 套件 CVE 比對：選擇此項目後，會列出透過 Homebrew 安裝的套件，並顯示與已知漏洞比對後的結果清單。
4. 稽核 AI 代理的指示檔：選擇該項後開始檢查，並以卡片形式列出發現的問題，顯示「風險：高」或「風險：中」、檔案位置和行號。符合只表示「需要人來讀一讀」，並不斷定為惡意。按「在 Finder 中顯示」可開啟對應檔案。

9.7 常駐監控開關一覽

從這裡開始，是以勾選開關切換的個別項目，控制在背景持續運作的各項監控功能。以下依實際顯示順序列出。啟用 Pro 後，勒索軟體偵測、憑證蜜罐令牌、自動日誌稽核、關鍵檔案與鎖定檔的竄改監控、與 XProtect 連動的自動切斷等會自動開啟。「連接埠・裝置監控」中的「SSH 暴力破解偵測與封鎖」（11.3 節）在啟用 Pro 後也會自動開啟（僅在遠端登入開啟時才運作）。ClickFix 防護、Docker 偵測、瀏覽器憑證存取監控與程序執行記錄，因可能妨礙日常使用或需要額外權限，預設關閉。若無特別理由，請保持已開啟的項目不變，只自行開啟需要的項目。

操作步驟 以上項目皆只需點選惡意軟體防護子選單中對應的一行，即可切換啟用／停用（可依勾選記號判斷目前狀態）。「勒索軟體復原…」與「處理程序執行記錄…」並非開關項目，而是用於開啟專用視窗。

9.8 運作確認用模擬測試

為了安全地確認「自己是否真的受到保護」而設計的無害模擬測試功能。無需引發實際威脅，即可當場模擬偵測～通知～（必要時）自動封鎖的完整流程是否正常運作。適合在導入後立即確認，或作為定期的健全性檢查。

操作步驟

1. 從惡意軟體防護子選單中選擇想要嘗試的模擬項目。
2. 若出現確認對話框，請選擇「執行」。數秒到數十秒後，若收到與實際偵測時相同格式的通知，即表示運作正常。

9.9 Web Shell 等偵測規則（Web Rules）

面向開發 Web 的 Mac，用於找出 PHP、JavaScript、JSP、ASP 的 Web Shell、被注入的惡意程式碼、偽裝成圖片的 PHP 以及 .htaccess 濫用（自 Mac 1.11.11 起）。範圍包括 ~/Sites、MAMP、Herd、Local、/Library/WebServer/Documents、登記用於套件 CVE 比對的專案資料夾，以及 Web 與郵件防護已在監視的資料夾（如下載）。未安裝 ClamAV 也能運作。

設定從選單列 🛡️ 圖示 → 惡意軟體防護 →「Web Shell 等偵測規則設定…」開啟。視窗中有規則版本與數量、「立即檢查開發用的 Web 資料夾」、開啟規則與掛鉤資料夾的按鈕、「自動隔離層級」、帳號處置開關，以及已偵測到但保留原位的檔案清單。

預設只隔離「critical」。嚴重的偵測（如 eval($_POST[...]) 這類單行 Web Shell）會被移入隔離區並通知您（可在「管理隔離檔案」中還原）。較低的「high」偵測不會觸碰檔案，只會出現在通知與本視窗的清單中，您可以在清單中選擇「在 Finder 中顯示」「今後不再偵測」或清除清單。這個預設值是為了避免誤報移動您正在處理的檔案。層級可選「不隔離」「僅 critical」「critical 與 high」。設為「今後不再偵測」的檔案清單與 ClamAV 的排除清單各自獨立。

檢查時機：下載等已在監視的資料夾，在寫入後立即檢查。開發用 Web 資料夾每天檢查一次，也可用「立即檢查開發用的 Web 資料夾」。每天一次的檢查因耗時較長，不會進入 node_modules 與 .git（指定資料夾的檢查會進入 node_modules）。Mac 無法在執行前阻止，全部為事後偵測。

進階：自訂規則放在「開啟規則資料夾」所開啟的位置（~/Library/Application Support/RoamSwitch/rules.d；只讀取擁有者為 root 或本人且他人不可寫的檔案）。若要在每次偵測時呼叫自己的腳本，請在「開啟掛鉤資料夾」所開啟的位置（~/Library/Application Support/RoamSwitch/hooks）放置名為 post-detection 的可執行檔（偵測內容以 JSON 透過標準輸入傳入，30 秒後終止）。帳號處置（「偵測到時停用檔案擁有者的登入 shell」）預設關閉，開啟需要管理員密碼，對象是已隔離檔案的擁有者。它不會處理已登入的使用者（包括正在使用這台 Mac 的您）、root 以及 UID 低於 501 的帳號。被停用的帳號可在此視窗中還原。

10. Mac 安全綜合診斷

為 Mac 整體安全設定評分的綜合診斷功能。選單標題本身會即時顯示「○/○ 良好・分數」，因此不必開啟選單也能一眼掌握健康狀態。開啟子選單後，會列出各檢查項目的合格與否。

操作步驟

1. 調整設定後，點選子選單中的「立即重新診斷」，即可當場更新分數。
2. 若想了解哪些項目需要改善，請選擇「📊 開啟綜合診斷報告…」，在開啟的視窗中確認紅色與黃色的項目。許多項目都備有可當場處理的按鈕。

10.1 安全活動記錄

將圍堵事件時間軸(ARP詐騙偵測、勒索軟體誘餌檔案偵測、XProtect連動Air-Gap、未知連接埠自動封鎖等)與郵件附件中已確認的惡意軟體偵測結果整合到同一畫面,可透過關鍵字搜尋、依分類或嚴重程度篩選,並透過時間序列圖表向下鑽研查看。

同一子選單中的「📜 Mac安全記錄稽核…」針對的是macOS自身的統一記錄(sudo、SSH、Gatekeeper、XProtect等);本畫面的不同之處在於,只會橫向搜尋RoamSwitch自身做出的圍堵判斷。

操作步驟

1. 點擊選單列的🛡️圖示→「Mac安全綜合診斷」→「📈 安全活動記錄…」。
2. 在畫面頂部選擇分類、嚴重程度與時間範圍,並視需要在搜尋欄輸入關鍵字。
3. 點擊圖表中的長條,可將清單縮小到該時段。再次點擊可取消篩選。

11. 連接埠・裝置監控

從網路本身（ARP 欺騙、VPN、開放的連接埠）到連接的實體裝置（USB、藍牙），彙整了監控 Mac「與外界邊界」的相關項目。

11.1 ARP 欺騙偵測

偵測同一網路上其他裝置試圖冒充您、竊聽您通訊內容的「ARP 欺騙（冒充）」攻擊。目前狀態會以一行文字顯示，若偵測到攻擊，該處會出現「立即全面封鎖」按鈕。「自動封鎖」與「固定閘道器的 ARP／NDP（預防）」皆可透過開關啟用或停用，後者是一種在不受信任網路上事先讓攻擊更難以成立的預防措施。啟用 Pro 後，「自動封鎖」預設開啟，而「固定閘道 ARP/NDP（預防）」預設關閉。

操作步驟

1. 若想在偵測期間手動封鎖，請點選連接埠・裝置監控子選單中的「立即全面封鎖」。
2. 點選「自動封鎖」、「固定閘道器的 ARP／NDP（預防）」各行，即可當場切換開啟／關閉。

11.2 VPN 通道（不受信任網路的 MITM 防護）Pro

當您位於咖啡廳、機場等不受信任的網路時，將通訊加密並切換至經由 VPN 傳輸的功能。首先在「後端」選擇要使用 WireGuard 還是 Tailscale。

操作步驟

1. 在連接埠・裝置監控子選單→「VPN 通道」→「後端」中，選擇要使用 WireGuard 還是 Tailscale。
2. 使用 WireGuard 時：從「匯入設定檔…」選擇您事先準備好的.conf設定檔。匯入後點選「連線」即可立即啟用 VPN。
3. 使用 Tailscale 時：選擇「連線」後，瀏覽器會開啟 Tailscale 的登入畫面，請使用帳號登入並授權。之後即可從「出口節點（Exit Node）」選擇要經由的節點。
4. 無論使用哪種方式，點選「Kill Switch」該行即可切換開啟／關閉。開啟後，若 VPN 連線意外中斷，通訊本身也會隨之停止，避免未加密的原始通訊外洩。

11.3 對外公開的連接埠

列出您 Mac 上處於開啟狀態、可從外部存取的連接埠（例如忘記關閉的開發伺服器），並可一併確認防火牆目前的狀態。不慎持續開啟的開發用連接埠，往往是攻擊者鎖定的典型破口，建議養成定期檢視此處、確認有無忘記關閉項目的習慣。

操作步驟

1. 若要確認目前開啟的連接埠，請將游標移到連接埠・裝置監控子選單→「對外公開的連接埠（數量）」上。
2. 選擇「RoamSwitch Sensor 配對…」後會開啟輸入欄，請輸入 Sensor 端畫面上顯示的配對代碼，並點選「連動」。

11.4 連線中的 USB 裝置／USB・BadUSB 防護

列出目前連接中的 USB 裝置。下方則排列著防範「BadUSB」攻擊的項目——這類攻擊會偽裝成 USB 隨身碟，實際上卻表現得像鍵盤，擅自輸入指令。

操作步驟

1. 開啟「USB／BadUSB 防護設定…」，從清單中選擇往後仍會使用的裝置，點選「加入許可清單」。
2. 設定完成後，在連接埠・裝置監控子選單中，分別點選「不正 USB／BadUSB 實體連接埠防護」與「自動阻擋不明 USB 儲存裝置」以開啟。

11.5 藍牙自動關閉

在身處不受信任網路等必要時機，自動關閉藍牙的開關。可降低近距離不正藍牙連線發生的機會本身。顯示內容會依藍牙狀態與支援情況而異。

操作步驟 點選連接埠・裝置監控子選單中對應的一行，即可切換開啟／關閉。

12. 手動覆寫

RoamSwitch 通常會依所連線的網路自動切換安全等級，而這項功能則用於「只想暫時固定在某個特定等級」的情境。選擇最上方的「恢復自動判斷」，即可隨時切回自動模式。下方則列出各安全等級，選擇其中之一後，系統會進一步詢問要將此設定維持多久。

操作步驟

1. 將游標移到選單列 🛡️ 圖示的手動覆寫上。
2. 點選想要固定的安全等級。
3. 接著在顯示的持續時間清單中，點選想維持的期間，即可立即套用。
4. 若想恢復自動判斷，隨時可從相同位置點選「恢復自動判斷」。

13. RoamSwitch Pro

若尚未購買 Pro，會顯示「💎 啟用／購買 Pro 版…」，點選後會開啟授權啟用畫面（含購買入口）。若 Pro 版已啟用，則會改為顯示「💎 RoamSwitch Pro（已啟用）」，點選後可確認目前的授權狀態。在第 9 章、第 11 章所見的眾多 Pro 功能，只要在此啟用授權，就能一次全部使用。

操作步驟

1. 尚未購買時：點選選單列 🛡️ 圖示 →「💎 啟用／購買 Pro 版…」，即可開啟畫面進行購買（或試用）手續。
2. 若您已持有授權金鑰：在同一畫面的授權金鑰輸入欄貼上金鑰，點選「啟用」。啟用成功後，選單顯示會變成「💎 RoamSwitch Pro（已啟用）」。

14. 登入時自動啟動

每次重新啟動或登入 Mac 時，是否自動啟動 RoamSwitch 的開關。勾選後會在登入時自動啟動。為了持續保護，強烈建議保持開啟狀態。

15. 語言

可從子選單的單選按鈕選擇 RoamSwitch 本身的顯示語言。此設定獨立於 macOS 的系統語言，能單獨切換 RoamSwitch 的顯示語言。

操作步驟 從子選單點選想使用的語言，選單與視窗的顯示會立即切換。

16. 說明・關於・檢查更新

17. 復原與解除安裝

操作步驟

1. 通訊中斷時的緊急復原：點選選單列 🛡️ 圖示 →「🧰 復原與解除安裝」→「🆘 緊急恢復網路…」，並在確認對話框中選擇「恢復」。
2. 解除安裝時：從同一個子選單點選「🗑 解除安裝 RoamSwitch…」。若系統要求輸入管理員密碼，請輸入密碼，並在確認對話框中選擇「解除安裝」，即可完整移除本體、輔助程式與相關檔案。詳情請參閱解除安裝步驟。

18. 結束（Quit）

結束 RoamSwitch 本身。請注意，結束期間，網路自動判斷與保護功能將不再運作。若您只是想暫時停用，也可以考慮改用第 12 章的「手動覆寫」，將等級固定在所需狀態，而不是直接結束程式。