跨平台支持！res-downloader在Windows/macOS/Linux上的部署

1. 关于res-downloader

res-downloader是一款基于Go + Wails框架开发的跨平台资源下载工具，支持网络资源嗅探与下载，包括微信视频号、网页抖音/快手无水印视频、酷狗音乐等多种网络资源。其核心优势在于：

• 多平台兼容：完美支持Windows、macOS、Linux三大操作系统
• 代理抓包技术：通过系统代理实现网络资源拦截，无需复杂配置
• 丰富资源支持：覆盖主流音视频平台，提供无水印下载能力

2. 系统环境要求

操作系统	最低配置要求	推荐配置
Windows	Windows 10+ (64位)，4GB内存	Windows 10/11专业版，8GB内存
macOS	macOS 10.15+，4GB内存	macOS 12+，8GB内存
Linux	内核4.15+，4GB内存	Ubuntu 20.04+，8GB内存

⚠️ 注意：Windows 7用户需下载2.3.0历史版本，不支持最新特性

3. 下载安装包

3.1 官方下载渠道

• 主版本：通过GitCode仓库获取最新稳定版
  git clone https://gitcode.com/GitHub_Trending/re/res-downloader.git
• 快速下载：访问蓝奏云镜像（密码：9vs5）获取预编译二进制文件

3.2 各平台文件选择指南

操作系统	文件类型	典型文件名示例
Windows	可执行安装程序	res-downloader_3.1.0_win_amd64.exe
macOS	磁盘镜像	res-downloader_3.1.0_darwin_amd64.dmg
Linux	DEB包（Ubuntu/Debian）	res-downloader_3.1.0_linux_amd64.deb
Linux	可执行文件（通用）	res-downloader_3.1.0_linux_x64

4. 分平台部署指南

4.1 Windows系统（以Windows 10为例）

安装步骤：

1. 下载对应架构的.exe安装文件（通常选择win_amd64.exe）
2. 右键安装文件，选择"以管理员身份运行"
3. 遵循安装向导，确保勾选"安装证书"和"允许网络访问" 选项
4. 完成安装后，从开始菜单启动程序

首次运行配置：

# 验证安装路径（默认）
cd "C:\Program Files\res-downloader"
# 查看版本信息
res-downloader --version

⚠️ 关键提示：Windows Defender可能会拦截证书安装，需在弹出窗口中选择"更多信息"→"仍要运行"

4.2 macOS系统（以macOS Monterey为例）

安装步骤：

1. 下载.dmg格式安装包
2. 双击镜像文件，将res-downloader拖入应用程序文件夹
3. 首次启动时，按住Control键点击应用图标，选择"打开"（绕过系统安全限制）

证书信任配置：

# 手动安装根证书（终端执行）
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain \
  ~/Library/Preferences/res-downloader/cert.crt
# 创建安装锁文件
touch ~/Library/Preferences/res-downloader/install.lock

📌 验证方法：打开"钥匙串访问"，在"系统根证书"中确认res-downloader证书状态为"已信任"

4.3 Linux系统（以Ubuntu 22.04为例）

DEB包安装（推荐）：

# 安装依赖
sudo apt update && sudo apt install -y libgtk-3-0 libwebkit2gtk-4.0-37
# 安装软件包
sudo dpkg -i res-downloader_3.1.0_linux_amd64.deb
# 修复依赖问题（如有）
sudo apt install -f

二进制文件运行：

# 下载并赋予执行权限
wget https://gitcode.com/GitHub_Trending/re/res-downloader/releases/download/v3.1.0/res-downloader_3.1.0_linux_x64
chmod +x res-downloader_3.1.0_linux_x64
# 启动程序
./res-downloader_3.1.0_linux_x64

📌 桌面集成：创建.desktop文件放置于~/.local/share/applications/目录实现启动器集成

5. 通用部署流程

5.1 基础使用步骤

flowchart TD
    A[安装并启动程序] --> B[点击"启动代理"按钮]
    B --> C[配置资源过滤规则]
    C --> D[外部访问目标资源页面]
    D --> E[返回软件查看捕获结果]
    E --> F[选择资源点击下载]

5.2 代理配置验证

启动程序后，系统代理会自动配置为：

• 地址：127.0.0.1
• 端口：8899

手动验证（各平台通用）：

# 检查代理监听状态
netstat -tuln | grep 8899

6. 常见问题解决

6.1 跨平台共性问题

问题现象	解决方案
无法拦截资源	1. 检查系统代理是否生效 2. 验证证书是否安装到"受信任的根证书颁发机构" 3. 关闭第三方防火墙/安全软件
关闭软件后无法上网	手动恢复系统代理设置： Windows：设置→网络和Internet→代理 macOS：系统偏好设置→网络→高级→代理 Linux：网络设置→代理配置
下载速度慢	使用外部下载工具加速： - Neat Download Manager - Motrix

6.2 平台特定问题

Windows特有：

• "无法验证发布者"警告：右键程序→属性→勾选"解除锁定"
• Win7兼容性问题：需安装.NET Framework 4.5及KB3063858补丁

macOS特有：

• "已损坏无法打开"：终端执行
  sudo xattr -d com.apple.quarantine /Applications/res-downloader.app
• 权限不足：系统设置→安全性与隐私→隐私→完全磁盘访问权限→添加res-downloader

Linux特有：

• 缺少依赖库：Ubuntu/Debian执行
  sudo apt install libgdk-pixbuf2.0-0 libglib2.0-0 libwebkit2gtk-4.0-37
• Wayland兼容性：编辑启动命令添加--enable-features=UseOzonePlatform --ozone-platform=wayland

7. 验证部署成功

成功部署后，程序启动并完成代理配置，访问任意支持的资源平台（如微信视频号），应能在软件界面看到资源列表。可按以下步骤验证核心功能：

1. 点击"启动代理"按钮，确认状态栏显示"代理运行中"
2. 打开微信视频号播放任意视频
3. 返回res-downloader，检查是否捕获到视频资源
4. 选择资源点击"下载"，验证文件保存到本地指定目录

8. 版本更新与维护

8.1 手动更新流程

# 备份配置文件（各平台通用）
cp ~/.config/res-downloader/config.json ~/config_backup.json
# 下载新版本并覆盖安装

8.2 自动更新配置

在软件"设置"→"高级选项"中勾选"自动检查更新"，程序将每周检查稳定版更新。

9. 总结与展望

res-downloader通过Wails框架实现了真正的跨平台能力，在保持一致用户体验的同时，充分适配各操作系统特性。随着v3.1.0版本的发布，进一步优化了：

• 证书自动信任机制
• 代理恢复逻辑
• 资源解析效率

未来版本计划支持：

• 自定义代理端口
• 多代理实例管理
• 资源自动分类存储

通过本文档的部署指南，用户可在Windows、macOS或Linux系统上快速搭建res-downloader环境，高效获取网络资源。如遇部署问题，可提交issue至GitCode仓库或加入官方交流群获取支持。

提示：定期关注项目更新，及时获取新功能和安全补丁