安装客户端
本章主要讲述 MSST-Net 客户端的安装方式与平台要求。
客户端组成
MSST-Net 客户端由以下部分组成：
- 客户端核心（Core）：负责网络连接与协议处理。
- 客户端控制器（Controller）：负责客户端配置与管理。
不同平台的安装方式可能有所不同。
安装方式
MSST-Net 提供以下安装方式：
- 使用客户端安装器（推荐）
- 手动安装
使用客户端安装器（推荐）
对于桌面端系统（Windows / Linux / macOS），推荐使用 MSST-Net 客户端安装器。
安装器支持以下操作：
- 安装：下载并部署最新版客户端核心与控制器
- 更新：停止服务、替换旧版本、重启服务
- 卸载：停止并移除服务，删除所有已安装文件
启动后，安装器将引导您完成以下选择：
- 控制器类型：Tauri（桌面版原生 GUI）或 WebUI（浏览器界面）
- 下载源：Gitee（国内镜像，推荐）或 GitHub（官方源）
安装器还将自动完成以下操作：
- 安装客户端核心与控制器
- 安装平台依赖（如 Windows 上的 wintun）
- 配置系统服务（开机自启、后台运行）
- 在 Linux 上优先使用系统包管理器安装 Tauri 控制器（
.deb/.rpm），不支持时回退至 AppImage
安装目录：
| 平台 | 路径 |
|---|---|
| Linux | /opt/msst-net |
| Windows | C:\Program Files\MSST-Net |
| macOS | /usr/local/msst-net |
安装器必须以 root（Linux / macOS）或管理员（Windows）权限运行。
下载地址：
手动安装
如果您希望手动安装客户端，请下载客户端组件：
桌面端安装
桌面端系统包括：
- Windows
- Linux
- macOS
安装时需要以下组件：
- 客户端核心（通常以
msst-net-client-core开头） - 客户端控制器（通常以
msst-net-client-controller开头）
控制器版本选择请参考：
移动端安装
移动端系统（如 Android）使用 Compose 版控制器。
Compose 版控制器内置客户端核心，无需单独安装核心组件。
安装时仅需安装控制器。
控制器说明请参考：
平台说明
Windows
Windows 平台运行客户端核心需要 wintun。
使用客户端安装器时，wintun 会自动下载并安装，无需手动处理。
手动安装时，需将 wintun 提供的 wintun.dll 与客户端核心放置在同一目录。
下载地址：
Linux
Linux 平台通常无需额外依赖。
如需后台运行，建议配置系统服务。
详见：
macOS
macOS 平台通常无需额外依赖。
如需后台运行，建议配置系统服务。
详见：
安装验证
安装完成后，建议进行以下检查：
- 客户端核心是否能够正常启动
- 客户端控制器是否能够正常打开
- 控制器是否能够检测到客户端核心
- 是否成功生成设备 ID
如果以上检查均通过，则表示客户端安装成功。
下一步
完成客户端安装后，建议继续：
- 配置系统服务（可选）
- 完成接入认证
详见：