企业官网建设流程全解析

res-downloader 配置完整指南：从安装到捕获视频号资源的五步走

【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader

res-downloader 是一款跨平台网络资源下载器，能捕获并下载视频号、小程序、抖音、快手、小红书、直播流、m3u8 等常见网络资源。这篇文章带你用"安装 → 证书 → 代理"三个阶段完成一次完整的 res-downloader 配置，最后附上一份按现象查的排障手册。不需要任何基础，跟着做就行。

阶段一｜安装与证书：打好地基

先说清楚它是怎么工作的：res-downloader 靠本地代理抓包（默认 127.0.0.1:8899），系统流量经过它时被筛选出可用资源；证书则是打开 HTTPS 加密内容的"钥匙"，没有它，加密流量一律显示不了。所以第一阶段只做两件事：装上应用，装好证书。

各系统安装应用

• Windows：双击 exe 安装。安装前先关掉所有安全管家、杀毒软件（它们容易误杀代理进程）；首次打开记得右键"以管理员身份运行"。Win7 用户请下载 2.3.0 版本。
• Mac：双击 dmg，把图标拖进 Applications。
• Linux：Ubuntu 可用sudo apt install安装 deb 包，或给执行文件加执行权限后运行。

预期结果：应用能打开，首次启动时弹出安装证书的提示。

Mac 证书安装：一条终端命令搞定

安装时务必同意安装证书文件、允许网络访问。如果装完后还要手动装证书，在终端执行下面这条命令（会提示输入管理员密码）：

# 把证书装进系统钥匙串并设为信任，同时创建锁文件 sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /Users/$(whoami)/Library/Preferences/res-downloader/cert.crt && touch /Users/$(whoami)/Library/Preferences/res-downloader/install.lock

预期结果：终端无报错。证书文件就放在/Users/你的用户名/Library/Preferences/res-downloader/cert.crt。

Windows 用户在安装过程中会自动把证书写入系统"受信任的根证书颁发机构"，跟着向导点"是"即可，之后每次首次使用仍需右键管理员打开。

阶段二｜核心配置：四个代理参数

点开应用左侧的设置图标，进入设置页。除下列四项外，其余参数保持默认即可：

改完一定要点底部的"保存"，否则不生效 ⚠️

然后回首页，点"启动代理"（较新版本叫"启动抓取"）。

预期结果：按钮变成"关闭代理"，说明代理已生效。如果点了又自动停掉，多半是 8899 端口被占了，用下面命令查是谁：

# 查看占用 8899 端口的进程 lsof -i:8899

找到后停掉那个程序，或把设置里的代理端口改成别的值再保存。

阶段三｜验证捕获生效：做两个小测试

配置对不对，跑一遍就知道。

测试一：抓一张网页图片

浏览器随便打开一个网页（百度就行）。预期结果：资源列表里出现 baidu.com 的图片资源，状态"就绪"。

测试二：抓一条视频号视频

在微信里把目标视频转发给一位好友，再点开好友发来的视频播放。预期结果：列表里出现 qq.com 的视频条目，状态"就绪"。

两个都"就绪"，说明配置完成，勾选资源点"直接下载"就能存到本地。

按现象排障：最常碰到的 6 个问题

每个问题都按"原因 → 修复动作 → 怎么确认修好"写，对号入座即可。

现象一：资源列表空的，什么都抓不到

原因：通常是三件事之一——证书没被系统信任、系统代理没指到 127.0.0.1:8899、代理根本没启动；Mac 用户还要检查防火墙。修复：

1. 确认代理按钮显示"关闭代理"，不是就重新启动代理；
2. Mac 关闭系统防火墙；
3. 按阶段一的命令重装一次证书。

确认：再打开一个网页，列表里出现资源即修好。

现象二：下载提示"链接不是私密链接"、视频放不了

原因：证书没有装到受信任的根证书位置，视频链接是加密的，拿到的文件无法播放。修复：按阶段一的 Mac 命令重装证书（Windows 用户从应用左下角"？"里获取最新证书重装，或直接重装应用）。确认：重新捕获并下载后，视频能直接播放。

现象三：装完证书后仍反复提示安装

原因：缺少锁文件 install.lock，应用判断不出证书已装好。修复：用终端方式打开应用，找到输出里lockfile:后面的路径并创建该文件。Mac 可直接执行：

# 在证书目录创建锁文件 touch /Users/你的用户名/Library/Preferences/res-downloader/install.lock

确认：重启应用不再弹证书提示。

现象四：关掉软件后全网断网

原因：应用启动时会写系统代理，异常退出后没有清掉，流量全指向了不存在的代理。修复：手动关掉系统代理——Windows 在"设置 → 网络 → 代理"里关掉手动代理，Mac 在"系统设置 → 网络"里关闭代理。确认：网页能正常打开。预防：用完先在应用里点"关闭代理"，再退出软件。

现象五：软件打不开了（之前能打开）

原因：本地配置文件损坏。修复：删掉配置目录后重启应用。三个系统的位置分别是：

• Mac：/Users/你的用户名/Library/Preferences/res-downloader
• Windows：C:\Users\你的用户名\AppData\Roaming\res-downloader
• Linux：~/.config/res-downloader

确认：应用能正常启动，重新走一遍阶段一的证书流程。

现象六：Mac 提示"已损坏，无法打开"

原因：macOS 给下载的应用打了隔离属性。修复：终端执行：

# 移除隔离属性 sudo xattr -d com.apple.quarantine /Applications/res-downloader.app

确认：双击能正常启动。

进阶：下载失败、慢速与其他资源类型

• 大视频下载失败或很慢：在资源操作列点"复制链接"，交给 Motrix、Neat Download Manager 这类第三方工具下载，完成后回 res-downloader 点"视频解密"即可。
• m3u8 与直播流：应用负责抓到链接，预览和录制建议配合 OBS 或在线 m3u8 播放器完成。
• 手机上的应用：手机与电脑同一网络，手机端装上 res-downloader 证书、把代理指向电脑 IP:8899；注意安卓 7.0 以上不再信任用户证书，加密流量抓不到。
• 个别网站就是拦截不了：它的原理和 Charles、Fiddler 一样，都是代理抓包，不走代理的流量天然抓不到，这属于正常现象。更多场景可查官方故障排除文档。

配置完成后，日常使用就只剩两步：打开应用、启动代理，然后正常使用即可。再遇到问题，回到上面的"现象排障"一节对照处理。

【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader