跳至主要内容

Muddog 疑難排解

請先在連線畫面確認問題出在自己的 VPN 連線還是我的網路分享。 各區域的連線詳細資訊，或錯誤通知中的錯誤詳細資訊會顯示原因。

症狀應確認的內容
無法連線至服務服務狀態與存取權限
國家清單為空或連線失敗國家與對象連線
顯示已連線，但 IP 不變或無法存取網站VPN 使用範圍與流量
無法按下應用程式啟動按鈕，或僅特定應用程式未套用 VPN個別應用程式 VPN
顯示服務不支援某項功能的錯誤應用程式與服務版本
只有我的網路分享失敗分享與記錄儲存

無法連線至服務​

應用程式會讀取背景服務的狀態並顯示在畫面上。 這則訊息表示應用程式無法確認狀態，並不代表 VPN 或分享一定已關閉。

服務恢復正常後，應用程式會自動重新連線。請依照下方對應的作業系統， 確認服務狀態與權限。啟動服務時也會開始網路分享。

Linux​

  1. 若剛完成安裝，請從桌面環境登出再重新登入，然後開啟應用程式。

  2. 在終端機確認服務狀態。

    systemctl status muddog-engine.service --no-pager

  3. 若服務已停止，而您想恢復使用 VPN 與分享，請啟動服務。 啟動時也會恢復網路分享。

    sudo systemctl start muddog-engine.service

  4. 若服務正在執行，但應用程式無法存取，請在使用應用程式的帳號所開啟的 終端機中執行 id -nG，確認是否有 muddog 群組。

若管理員以其他帳號安裝，導致未加入群組，請在以要使用應用程式的一般使用者 登入的終端機中執行以下指令。之後必須從桌面環境登出再重新登入。

sudo usermod -aG muddog "$(id -un)"

請勿以管理員權限執行應用程式來取代此步驟。 若服務本身無法啟動，可以使用以下指令查看最近的錯誤。

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows​

在 PowerShell 中確認服務狀態。

Get-Service -Name muddog-engine

若服務已停止，請在以管理員權限執行的 PowerShell 中啟動服務。

Start-Service -Name muddog-engine

若已停用服務，請依照重新啟用自動啟動的方法操作。 若服務不存在或缺少必要檔案，請使用最新的 MSI 安裝或修復。 應用程式請以一般使用者權限執行。

macOS​

  1. 確認使用 macOS 13 以上版本，且已將 Muddog.app 複製到 /Applications。
  2. 確認目前登入的帳號是 macOS 管理員帳號。
  3. 選擇 Service → Enable Background Service，要求註冊服務。
  4. 在 Service → Background Service Settings… 中，允許 Muddog 在背景執行。 授權後，請等待應用程式重新連上服務。

也可以在終端機確認已註冊服務的狀態。

sudo launchctl print system/net.3rocks.muddog.engine

從 DMG 內或其他資料夾執行應用程式，無法註冊服務。 若在取代原有應用程式後發生問題，請依照 macOS 更新步驟 移除服務，再重新執行應用程式。

若依照上述步驟操作後仍然失敗，請在問題回報中一併提供服務錯誤內容。

國家清單為空或連線失敗​

  1. 確認一般網際網路連線正常。
  2. 按下連線國家 → 重新整理清單。
  3. 若所選國家已從清單消失，請使用自動選擇或選擇其他國家連線。
  4. 若曾變更連線伺服器設定，請還原進階設定的預設值並儲存。
  5. 若仍然失敗，請查看連線詳細資訊。

P2P 連線會受到所選國家的參與者與雙方網路狀態影響。 即使國家出現在清單上，也不保證能連線。若沒有可用對象，請稍後重試或選擇其他國家。 若要確認是否由防火牆或路由器的通訊限制造成，也可以使用其他可用網路連線進行比較。

最多 10 次是連線嘗試的上限。若找不到對象，可能會提早結束； 已建立的 VPN 連線中斷後，必須手動重新連線。

顯示已連線，但 IP 不變或無法存取網站​

  1. 確認連線 → 目前連線範圍是否為預期模式。若只儲存設定而未重新連線， 仍會套用原本的範圍。
  2. 若使用 IP・網段模式，請確認要連線的目的地 IP是否被包含在清單內或排除。 位址清單不能輸入網域名稱。
  3. 若使用個別應用程式模式，請完全結束應用程式，再從 Muddog 重新啟動。
  4. 確認要檢查的連線是否為 IPv6。IPv6 不會通過 VPN， Windows 的個別應用程式模式會封鎖所選應用程式的 IPv6 通訊。
  5. 若同時使用其他 VPN 或網路管理工具，也請在中斷那些連線後進行比較。 其他工具設定的路由可能會優先套用。

若用來查詢 IP 的瀏覽器或查詢頁面不在 VPN 套用範圍內，顯示原有網路的 IP 是正常的。 DNS 也可能依使用模式與 DNS 伺服器的 IP 而使用原有網路。

若特定網站的國家限制仍然存在，請嘗試其他國家或連線對象。 Muddog 不保證該服務會允許存取，也不保證特定速度。

若在 macOS 上變更了正在使用的 Wi-Fi 等網路連線，請中斷 VPN 再重新連線。 若 IP 包含模式顯示與其他程式設定的主機路由衝突， 請確認該程式的連線與指定的 IP・網段。

個別應用程式 VPN 未生效​

  • macOS 不支援個別應用程式 VPN。請使用所有網際網路流量或 IP・網段模式。
  • 若透過 VPN 啟動無法使用，請確認已儲存為個別應用程式模式、 已使用該模式連線至 VPN，且已選擇要啟動的應用程式。
  • 若應用程式清單為空，請使用重新整理清單或尋找執行檔。
  • 若瀏覽器只重新開啟既有視窗，請一併結束背景程序後再啟動。
  • 不支援將啟動工作交給獨立服務，或重複使用既有實例的應用程式。 請確認安裝方式與個別應用程式 VPN 的使用條件。
  • Linux 不支援 Snap・Flatpak 應用程式。 若發生 systemd 使用者工作階段、cgroup v2 或 nftables 相關錯誤， 請確認相應環境，並將錯誤詳細資訊包含在問題回報中。
  • 在 Windows 上必須選擇要執行的 .exe 檔案。VPN 重新連線後， 必須完全結束程式，再從 Muddog 重新啟動。
  • 若 Windows 顯示缺少或無法載入 WinDivert 元件的錯誤，請使用 MSI 修復或重新安裝。 若仍然失敗，請回報錯誤詳細資訊。

應用程式與服務版本不同​

若連線至不支援應用程式所要求功能的舊版服務，會發生錯誤。 請使用新套件一併更新應用程式與服務。 macOS 無法使用個別應用程式 VPN，是支援範圍的差異，並非版本錯誤。

若更新後仍有相同錯誤，請依照作業系統對應的方法重新啟動服務。 重新啟動會中斷進行中的個人 VPN 與分享連線。

Linux 使用者請關閉應用程式，執行以下指令後再開啟應用程式。

sudo systemctl restart muddog-engine.service

Windows 使用者請關閉應用程式，在管理員 PowerShell 中執行以下指令後再開啟應用程式。

Restart-Service -Name muddog-engine

macOS 使用者請選擇 Service → Remove Background Service and Quit， 再重新執行 /Applications 中的 Muddog，並完成所需的服務授權。

服務重新啟動後，需要重新連線 VPN。若錯誤持續，請整理應用程式版本與錯誤詳細資訊 並回報，避免反覆重新啟動。

只有網路分享失敗，或無法讀取記錄​

請先查看我的網路分享 → 連線詳細資訊。若記錄儲存空間不足、超過儲存上限， 或發生檔案寫入錯誤，分享就會停止。 記錄會依本機保存方式儲存。

請檢查磁碟空間與服務日誌。若仍需要保存中的記錄，請勿為了消除錯誤而任意刪除， 應附上錯誤訊息尋求支援。

若只有記錄查詢失敗，請確認服務存取權限與版本。 若因每日記錄被清除，導致查詢期間內容發生變更，請重新選擇日期與條件，再按下查詢。 若查詢成功但結果為空，請確認 UTC 日期、篩選條件與下一批記錄。