安装
在 macOS、Windows 或 Linux 上下载并安装 Amux Desktop
系统要求
| 平台 | 要求 |
|---|---|
| macOS | macOS 10.15 (Catalina) 及以上，Intel 或 Apple Silicon |
| Windows | Windows 10 及以上，64 位 |
| Linux | Ubuntu 20.04+、Debian 11+、Fedora 36+ 或同等版本 |
下载
从 GitHub Releases 页面下载最新版本。
| 平台 | 文件 | 架构 | 下载 |
|---|---|---|---|
| macOS | amux-desktop-x.x.x.dmg | Universal (Intel + Apple Silicon) | GitHub Releases |
| Windows | amux-desktop-x.x.x-setup.exe | x64 | GitHub Releases |
| Linux | amux-desktop-x.x.x.AppImage | x64 | GitHub Releases |
| Linux (Debian) | amux-desktop-x.x.x.deb | x64 | GitHub Releases |
安装步骤
macOS
- 打开下载的
.dmg文件 - 将 Amux Desktop 拖到 Applications 文件夹
macOS 安全提示
由于应用未经 Apple 公证，macOS 可能显示**"已损坏"或"无法打开"**的错误。以下是三种解决方法：
方法 1：右键打开
- 右键点击（或 Control+点击）应用图标
- 从菜单中选择**"打开"**
- 在安全对话框中点击**"打开"**
方法 2：系统设置放行
- 尝试打开应用（会被阻止）
- 前往 系统设置 > 隐私与安全性
- 向下滚动找到"已阻止 Amux"的提示
- 点击**"仍要打开"**
- 在确认对话框中点击**"打开"**
方法 3：移除隔离属性（终端）
xattr -dr com.apple.quarantine /Applications/Amux.app如果应用在下载文件夹中：
xattr -dr com.apple.quarantine ~/Downloads/Amux.app使用任一方法后，应用将可以正常打开，无需重复操作。
Windows
- 运行下载的
.exe安装程序 - 按安装向导完成安装
- Amux Desktop 将添加到开始菜单
Linux
AppImage：
chmod +x amux-desktop-x.x.x.AppImage
./amux-desktop-x.x.x.AppImageDebian/Ubuntu (.deb)：
sudo dpkg -i amux-desktop-x.x.x.deb数据目录
Amux Desktop 的配置、数据库和日志存储在以下位置：
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/amux-desktop/ |
| Windows | %APPDATA%/amux-desktop/ |
| Linux | ~/.config/amux-desktop/ |
该目录包含：
| 文件/文件夹 | 描述 |
|---|---|
database.sqlite | 本地数据库（提供商、代理、日志、令牌等） |
logs/ | 应用日志文件 |
presets/ | 缓存的提供商预设 |
从源码构建
如果你需要从源码构建：
git clone https://github.com/isboyjc/amux.git
cd amux
# 安装依赖
pnpm install
# 开发模式运行
cd apps/desktop
pnpm dev
# 构建分发包
pnpm package平台特定构建：
pnpm package:mac # macOS (.dmg)
pnpm package:win # Windows (.exe)
pnpm package:linux # Linux (.AppImage, .deb)自动更新
Amux Desktop 支持自动检查更新。当有新版本可用时，应用内会弹出更新通知。你也可以在 Settings 中手动检查更新。