跳到主要内容

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 日期、筛选条件和后续记录。