跳转到内容
Clash NyanpasuClash Nyanpasu

安装

Windows · x64 / ARM64 macOS · Intel / Apple 芯片 Linux · DEB / RPM / AppImage 原生多内核支持

Clash Nyanpasu 支持 Windows 10 及更高版本、macOS 12.6 及更高版本，以及 glibc >= 2.39 的 Linux。请从官方 releases 页面选择适用于设备的安装包；各版本提供的包型和处理器架构可能不同。

选择安装包

Section titled “选择安装包”
flowchart TD
  A[确认操作系统与处理器架构] --> B{操作系统}
  B -->|Windows| C{处理器}
  C -->|Intel 或 AMD| D[x64 安装程序]
  C -->|Windows ARM| E[ARM64 安装程序]
  B -->|macOS| F{处理器}
  F -->|Intel| G[x64 DMG]
  F -->|Apple 芯片| H[aarch64 DMG]
  B -->|Linux| I{发行版或包类型}
  I -->|Debian 或 Ubuntu| J[DEB · amd64 或 arm64]
  I -->|Fedora 或 RPM 系| K[RPM · x86_64 或 aarch64]
  I -->|Arch Linux| L[AUR · 社区维护]
  I -->|AppImage| M[AppImage · x86_64]
  1. 确认处理器架构。 Windows 用户打开设置 → 系统 → 关于，查看“系统类型”；macOS 用户打开苹果菜单 → 关于本机；Linux 用户可在终端运行 uname -m。
  2. 根据文件名后缀选择安装包。 x64、amd64 和 x86_64 表示 64 位 Intel/AMD 架构；ARM64 和 aarch64 表示 64 位 Arm 架构。发布页不一定为每种架构提供所有包型。
  3. 安装并继续完成首次连接。 Linux 用户还应阅读下方对应包型的说明。

Windows

Section titled “Windows”
Windows 10 及更高版本 x64 ARM64

大多数 Intel/AMD 电脑下载文件名以 _x64-setup.exe 结尾的安装程序；Windows on ARM 下载 _arm64-setup.exe。

便携版压缩包

Section titled “便携版压缩包”

Windows 版本还提供 _x86_64_portable.zip 和 _aarch64_portable.zip。解压后运行应用程序即可。另有包含 WebView2 Runtime 的 Fixed-WebView 便携版。

macOS

Section titled “macOS”
macOS 12.6 及更高版本 Intel · x64 Apple 芯片 · aarch64

Intel Mac 下载文件名以 _x64.dmg 结尾的磁盘映像；Apple 芯片 Mac 下载 _aarch64.dmg。打开磁盘映像后，将 Clash Nyanpasu 拖到“应用程序”目录。如果安装失败，请参阅常见问题。

Linux

Section titled “Linux”

官方 Linux 安装包会随版本变化。目前的包型包括 amd64 和 arm64 的 DEB、x86_64 和 aarch64 的 RPM，以及 amd64 AppImage。当前尚未发布 ARM64 AppImage。

下载文件名以 _amd64.deb 或 _arm64.deb 结尾的安装包，然后在下载目录中安装：

终端窗口
sudo apt install ./Clash.Nyanpasu_*_amd64.deb

ARM64 设备使用：

终端窗口
sudo apt install ./Clash.Nyanpasu_*_arm64.deb

以上通配符要求当前目录中只有一个符合条件的版本安装包。

如果遇到其他 AppImage 问题，请在提交问题时注明 Linux 发行版、处理器架构、应用版本和安装包类型。

可选：创建 AppImage 启动器和登录自启动项

Section titled “可选：创建 AppImage 启动器和登录自启动项”

应用内置的登录启动选项位于设置 → 系统 → 启动设置 → 随系统启动。如果手动创建桌面启动项，请将 AppImage 保存在固定的绝对路径，并将 VERSION 替换为实际文件名。应用菜单启动器应放在 applications 目录；登录自启动则使用独立的 autostart 目录。Autostart=true 不是标准的桌面条目键，update-desktop-database 也只刷新应用程序目录。请在应用内设置和手动自启动项中选择一种，以免应用重复启动。

将 APPIMAGE_PATH 设置为 AppImage 的绝对路径。以下示例使用标准 hicolor 图标目录：

终端窗口
APPIMAGE_PATH="$HOME/Applications/Clash.Nyanpasu_VERSION_amd64.AppImage"
ICON_DIR="$HOME/.local/share/icons/hicolor/256x256/apps"
APP_DIR="$HOME/.local/share/applications"


chmod +x "$APPIMAGE_PATH"
mkdir -p "$ICON_DIR" "$APP_DIR"
curl -fL "https://raw.githubusercontent.com/libnyanpasu/clash-nyanpasu/main/frontend/nyanpasu/src/assets/image/logo-box.png" -o "$ICON_DIR/clash-nyanpasu.png"


cat > "$APP_DIR/clash-nyanpasu.desktop" <<EOF
[Desktop Entry]
Type=Application
Name=Clash Nyanpasu
Comment=Clash proxy client
Exec="$APPIMAGE_PATH" %U
Icon=clash-nyanpasu
Terminal=false
Categories=Network;
EOF


update-desktop-database "$APP_DIR"

如果还需要登录时自动启动，请在用户自启动目录创建单独的条目：

终端窗口
APPIMAGE_PATH="$HOME/Applications/Clash.Nyanpasu_VERSION_amd64.AppImage"
AUTOSTART_DIR="$HOME/.config/autostart"
mkdir -p "$AUTOSTART_DIR"


cat > "$AUTOSTART_DIR/clash-nyanpasu.desktop" <<EOF
[Desktop Entry]
Type=Application
Name=Clash Nyanpasu
Exec="$APPIMAGE_PATH"
Terminal=false
EOF

如果系统中没有 update-desktop-database 命令，请安装发行版提供的 desktop-file-utils 软件包。

Arch Linux · AUR

Section titled “Arch Linux · AUR”
社区维护 三选一安装

AUR 包由社区贡献者维护，不属于 Clash Nyanpasu 项目官方包。这几种包型彼此冲突，请只安装其中一种。以下版本来自 2026 年 10 月 17 日查询的 AUR RPC 记录；安装前请确认当前记录。

包名：clash-nyanpasu。此包会在本机编译应用。