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 也无法使用。