Muddog 安裝與更新
支援環境
請先在下載頁面確認作業系統與版本， 再下載安裝檔。
| 作業系統 | 提供形式與使用指南 |
|---|---|
| Linux x86_64 | .deb 與 .rpm 套件。需要使用 systemd 的桌面環境。 |
| Windows 10/11 x64 | .msi 安裝檔。目前的 Windows 套件僅支援 x64。 |
| macOS 13 Ventura 以上 | .dmg 安裝檔。Universal 套件同時支援 Intel 與 Apple Silicon。控制應用程式需要 macOS 管理員帳號。 |
Linux 套件管理員會一併安裝執行應用程式所需的程式庫與相依套件。 Linux 的個別應用程式 VPN 還需要 systemd 使用者工作階段與 cgroup v2；nftables 已包含在套件相依項目中。 Windows 也支援個別應用程式 VPN；macOS 則支援所有網際網路流量與依 IP・網段使用 VPN。
本指南適用於 2.x。若下載頁面尚未顯示您作業系統的 2.x 檔案，
請先確認是否已發布。Windows 版 1.0.7 的 .exe 檔案，
請依照舊版使用指南操作。
Linux 與 Windows 會在安裝完成後自動啟動網路分享；macOS 則在首次執行 並允許背景服務執行後啟動。之後服務也會在開機時執行， 因此即使未開啟應用程式視窗，其他使用者仍可使用您的網路連線。 安裝前請先閱讀網路分享管理。
在 Linux 上安裝
以下指令以 2.0.0 的檔名為例。請在終端機切換至下載檔案所在的目錄， 並將檔名換成實際下載的套件名稱後再執行。安裝需要管理員權限。
Debian / Ubuntu
sudo apt install ./muddog_2.0.0_amd64.deb
Fedora
sudo dnf install ./muddog-2.0.0-1.x86_64.rpm
安裝後首次啟動
- 安裝完成後，請從桌面環境登出再重新登入。
- 從應用程式選單啟動 Muddog。
- 確認連線畫面顯示 VPN 狀態與我的網路分享狀態。
- 依照連線至 VPN選擇國家並連線。
透過一般使用者帳號以 sudo 安裝時，該使用者會被加入 muddog 群組。
必須重新登入，應用程式才能取得此權限。請以一般使用者身分執行應用程式；
使用 VPN 不需要輸入 Mudfish ID 或密碼。
若管理員使用其他帳號安裝，或需要讓多位使用者控制應用程式，請參閱 確認服務存取權限。
在 Windows 上安裝
- 若已透過舊版
.exe安裝程式安裝 Muddog，請先在 Windows 的 設定 → 應用程式中解除安裝。若出現要求移除舊版的提示， 請完成移除後再重新執行 MSI 安裝。 - 執行下載的
.msi檔案，並核准管理員權限要求。 - 依照指示安裝。若未安裝 WebView2 Runtime，安裝精靈會從網際網路下載， 因此需要網際網路連線。
- 以一般使用者權限執行開始功能表或桌面上的 muddog。
- 在連線畫面確認服務狀態，再依照連線至 VPN操作。
預設安裝位置為 %ProgramFiles%\muddog。安裝程式會註冊並自動啟動
muddog-engine 服務，也會新增引擎所需的 UDP 輸入防火牆規則。
VPN 與個別應用程式 VPN 所需的元件已包含在套件中。
日常使用應用程式時，無須每次都以管理員權限執行。
在 macOS 上安裝
- 開啟下載的
.dmg檔案。 - 將 Muddog.app 複製到**應用程式（
/Applications）**資料夾。 直接從 DMG 內執行，無法註冊背景服務。 - 使用 macOS 管理員帳號登入後，執行複製過去的 Muddog。
- 在系統設定 → 一般 → 登入項目與延伸功能中，允許 Muddog 在背景執行。 項目名稱可能因 macOS 版本而異。
- 應用程式重新連上服務後，依照連線至 VPN操作。
若要重新開啟授權畫面，請在 macOS 選單列選擇
Service → Background Service Settings…。若需要註冊服務，
請選擇 Service → Enable Background Service。
這些選單名稱以英文顯示。執行應用程式本身無須使用 sudo。
更新
若正在使用 VPN，請按下中斷連線，再從下載頁面取得適用於您作業系統的新安裝檔。
- Linux：關閉應用程式，在上述安裝指令中指定新的
.deb或.rpm檔名，執行安裝。 - Windows：關閉應用程式，再執行新的
.msi檔案。更新過程會取代原有的 MSI 安裝版本。 - macOS：先選擇 Service → Remove Background Service and Quit，
移除服務並結束應用程式。使用新 DMG 中的 Muddog.app 取代
/Applications中的應用程式，再重新執行並完成所需的服務授權。
更新過程會中斷進行中的 VPN 與分享連線。 更新後，請重新開啟應用程式並確認連線與分享狀態。 若出現應用程式與服務版本不同的錯誤，請參閱 疑難排解。
若從 Linux 舊版 1.0.7 升級，請先關閉舊版應用程式，再安裝新套件。
若已註冊舊有的 muddog_srv.service，安裝程式會停止該服務並停用其自動啟動。
之後請從應用程式選單啟動 Muddog。
解除安裝
Linux
Debian / Ubuntu 請使用以下指令。
sudo apt remove muddog
Fedora 請使用以下指令。
sudo dnf remove muddog
移除套件後，服務與 VPN 會停止，Muddog 新增的網路路由也會清除。
在 Debian / Ubuntu 上，若也要移除專用服務帳號與群組，可以使用
sudo apt purge muddog 取代一般移除指令。
Windows
在 Windows 的設定 → 應用程式中，選擇 muddog 並解除安裝。 移除過程會停止服務與 VPN、清除 VPN 路由，再刪除服務及安裝時新增的防火牆規則。 使用者設定與連線及轉送記錄會保留。
macOS
- 在應用程式中選擇 Service → Remove Background Service and Quit。
- 服務移除且應用程式結束後，將
/Applications中的 Muddog.app 移至垃圾桶。
若先刪除應用程式檔案，可能會延後背景項目的清理。 使用者設定與連線及轉送記錄會保留。
剩餘記錄與停止分享
移除套件與刪除連線及轉送記錄是兩件不同的事。剩餘本機記錄的位置與保存方式， 請參閱連線與轉送記錄。 若想保留程式並停止分享，可以停止服務， 但服務停止期間，您也無法使用自己的 VPN。