安装指南
请选择与操作系统和 CPU 架构匹配的安装包,可通过以下任一方式下载:
- GitHub Releases
- 蓝奏云下载,访问密码:
9vs5
Windows
大多数使用 Intel 或 AMD 处理器的 64 位 Windows 电脑,应下载安装包名称中架构标识为 amd64 的版本。 amd64 同时适用于 Intel 和 AMD,并不只是 AMD 处理器。只有使用 ARM 处理器的 Windows 设备才选择 arm64。
下载 Windows 安装包并按提示完成安装。首次安装证书时,请允许系统显示的 UAC 授权。
普通安装包使用系统 WebView2 Runtime;fixed_webview2 安装包自带固定版本。切换安装包类型时,先退出软件,再覆盖安装到原目录。切换到普通版后,应用会使用系统运行时,安装器仅清理安装记录中列出的固定版 WebView2 文件;未记录的遗留文件和目录中的其他文件会保留,但不会被普通版作为运行时加载。
安装中途失败时,请参照安装失败后如何重试。
Windows 7 只能使用旧版归档中的 2.3.0。
macOS
Intel Mac 选择 _mac_amd64.dmg,Apple Silicon(M 系列)选择 _mac_arm64.dmg,_mac_universal.dmg 同时支持两种架构。
下载 .dmg 文件,将 res-downloader.app 拖入“应用程序”。
首次启动如果被系统阻止,请在“系统设置 → 隐私与安全性”中允许打开。
Linux
Debian / Ubuntu
Debian、Ubuntu 等系统推荐使用 apt 安装对应架构的 .deb 文件:
sudo apt install './res-downloader_<version>_linux_amd64.deb'apt 会自动处理依赖;也可使用 sudo dpkg -i 安装,但需自行补齐缺失依赖。
出现 _apt 权限提示
如果末尾提示文件“无法被用户 _apt 访问,已脱离沙盒并提权为根用户来进行下载”,这条提示本身不代表安装失败。请按Debian / Ubuntu 安装时的权限提示检查安装状态,或调整安装包位置后重试。
Arch Linux
已安装 yay 的用户可以通过以下命令更新系统并安装 AUR 中的 res-downloader:
yay -Syu res-downloader自行构建或维护 AUR 包
当前版本基于 Wails v3,使用 GTK4 和 WebKitGTK 6.0。自行构建或维护 PKGBUILD 时,配置 gtk4、webkitgtk-6.0 和 nss(提供浏览器证书工具 certutil)依赖,并使用以下构建命令:
wails3 task linux:build PRODUCTION=true在 PKGBUILD 的 package() 中,进入项目源码目录后安装程序、共用桌面入口和图标($pkgdir 由 makepkg 提供):
install -Dm755 bin/res-downloader "$pkgdir/usr/bin/res-downloader"
install -Dm644 build/linux/application.desktop "$pkgdir/usr/share/applications/res-downloader.desktop"
install -Dm644 build/linux/Debian/usr/share/icons/hicolor/256x256/apps/res-downloader.png \
"$pkgdir/usr/share/icons/hicolor/256x256/apps/res-downloader.png"通过 yay 安装且 PKGBUILD 已适配当前版本时,无需手动调整。
AppImage
将 AppImage 保存在固定目录,以普通用户身份添加执行权限并启动。Ubuntu 上若出现 bwrap 权限错误,参见 AppArmor 配置示例。
浏览器证书工具
AppImage 和独立程序不会自动安装宿主的 certutil。同步已有浏览器共享证书库需要该工具:Debian / Ubuntu 安装 libnss3-tools,Arch Linux 安装 nss,Fedora 安装 nss-tools。DEB 通过 apt 安装时会自动处理此依赖。
缺少工具时,先用系统包管理器安装,再重新执行证书操作;不要用 sudo 启动应用。
独立程序
使用独立程序时,先添加执行权限后再启动:
chmod +x ./res-downloader_<version>_linux_amd64
./res-downloader_<version>_linux_amd64安装完成后,继续查看快速开始。
