res-downloader 配置与排障指南:3 个高频卡点逐个拆通
【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader
res-downloader 把视频号、小程序、抖音、m3u8 等网络资源抓下来,存成本地文件。跑起来后最常见的坎就三个:系统不认证书、代理参数填错、列表抓不到东西。照本文逐节操作,你能独立装好证书、调对代理端口,让资源列表正常出图出视频。
🩺 对号入座:你的症状是哪一种
- 如果你装完证书,浏览器打开网页仍提示"不安全"或"链接不是私密链接"
- 如果你点了"启动代理",资源列表却一直停在"无数据"
- 如果视频下载完成了,双击却放不出画面
- 如果改过 Host 或端口之后,浏览器反而上不了网
- 如果重启电脑,之前的代理设置又全没了
命中2条以上,往下逐节处理。
证书安装后浏览器仍提示不安全:正确做法
先做这一步
这个症状的原因很单纯:系统还没把 res-downloader 的证书当成可信根。钥匙串(系统存放受信任证书的地方)分"登录"和"系统"两本账,前者只对你当前登录的账号生效,必须装进后者。
- 打开"终端"(macOS 自带命令行工具,在 访达 → 应用程序 → 实用工具 里)
- 粘贴命令回车。输入开机密码时屏幕不显示字符,属正常现象
# 把证书装进系统钥匙串并标记"始终信任",install.lock 是"装完了"的标记文件 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 && echo "安装完成"预期输出:最后一行打印安装完成,全程没有error字样。
- 回到 res-downloader,左上角点"启动代理"
访达里浏览文件的位置示意:cert.crt 在~/Library/Preferences/res-downloader目录下。
[!WARNING] 踩坑提醒:
- 证书只装进"登录"钥匙串的话,重启、切换账号就失效,必须进"系统"钥匙串
- 信任级别只勾"使用时信任"不选"始终信任",警告过阵子又回来
走不通?换这条路
不想碰命令行,就用鼠标点:
- 访达按
Command+Shift+G,粘贴/Users/你的用户名/Library/Preferences/res-downloader回车 - 双击
cert.crt,钥匙串访问(管理证书的官方小应用)弹窗里目标选"系统"钥匙串 - 在钥匙串访问左侧选中"系统",双击 res-downloader 证书 → 展开"信任" → 选"始终信任",关窗时输入密码确认
怎么算修好了
# 查这条证书在系统钥匙串里的信任状态 security find-certificate -c "res-downloader" -a /Library/Keychains/System.keychain成功标志:输出里出现Trust Settings: trustRoot一行。刷新浏览器页面,"不安全"提示消失即算通过。
代理参数怎么配:Host、端口与全量拦截
先做这一步
代理(帮你中转网络流量的中间窗口)填错,流量就进不了 res-downloader。默认 Host127.0.0.1、端口8899,不动最稳。
- 打开 res-downloader,点左侧设置图标
- 高级设置里核对:Host 填
127.0.0.1,Port 填8899 - 基础设置里选一个常用文件夹当"保存路径";打开"全量拦截"开关(默认只拦微信系流量,打开后网页、小程序都拦)
- 保存并重启应用,回主界面点"启动代理"
- 重启一次浏览器——系统代理对已经开着的浏览器进程不生效
配置界面一览,四个关键项都在这一屏。
[!WARNING] 踩坑提醒:
- Host 别填
localhost,个别系统解析不到,统一写127.0.0.1- 改了端口却没同步系统代理,流量还走旧端口,等于白改
走不通?换这条路
应用自动设置代理没生效时,直接命令行设系统代理:
# 把 Wi-Fi 的 HTTP / HTTPS 流量都指到 res-downloader 的代理端口 networksetup -setwebproxy Wi-Fi 127.0.0.1 8899 networksetup -setsecurewebproxy Wi-Fi 127.0.0.1 8899说明:Wi-Fi换成你实际网卡名,跑networksetup -listallnetworkservices可查。
怎么算修好了
# 查看 Wi-Fi 当前的 HTTP 代理设置 networksetup -getwebproxy Wi-Fi成功标志:输出里Enabled: Yes、Server: 127.0.0.1、Port: 8899三项齐全。
资源捕获失败怎么排查:从空列表到抓到视频
先做这一步
列表空白通常不是软件坏了,是流量没走到那个窗口。三步走:
- 主界面确认"全量拦截"是绿色开启状态。资源列表上方出现"关闭代理"按钮,说明代理已激活。空列表长这样:
- 打开微信,把目标视频转发给自己再点开;视频号直接播放也行。抓小程序内容时,先完全退出微信再重开,并删掉对应小程序重新进入
- 怀疑进程没起来?终端确认一下:
# 看 res-downloader 进程是否还在运行 ps aux | grep res-downloader预期输出:有一行包含res-downloader的进程记录。抓到成功后列表会多出这样的条目:
[!WARNING] 踩坑提醒:
- 微信这类应用不会热加载代理,必须完全退出再重开
- 浏览器隐私窗口可能绕过系统代理,换普通窗口再试
走不通?换这条路
macOS 防火墙会挡掉入站的代理流量。打开 系统设置 → 网络 → Wi-Fi → 详情 → 防火墙,临时关闭后重启应用再试;验证完记得开回来。
怎么算修好了
# 播放一个视频号视频,看本地 8899 端口有没有流量 sudo tcpdump -i lo0 port 8899成功标志:终端滚动出包记录,同时资源列表出现目标视频条目,状态"就绪"。
故障速查表
| 现象 | 最可能原因 | 一句话处置 |
|---|---|---|
| 资源显示"解密失败",视频放不了 | 证书只进了"登录"钥匙串,没到系统级 | 先sudo security delete-certificate -c "res-downloader" -t /Users/$(whoami)/Library/Keychains/login.keychain-db删掉旧证书,再按上一章重装 |
启动代理后秒退,日志报address already in use | 8899 端口被别的进程占着 | lsof -i:8899查到 PID(进程号)后执行kill -9 1234(1234 换成查到的进程号),或把端口改成 8900 |
| 只能抓到部分网站的资源 | 全量拦截没开,或上游代理挡了域名 | 打开"全量拦截";仍不行就删掉~/Library/Caches/res-downloader缓存目录再重启应用 |
| 装完证书,软件还反复提示要装证书 | 缺 install.lock 标记文件 | 终端执行touch /Users/$(whoami)/Library/Preferences/res-downloader/install.lock |
| 关掉软件后反而上不了网 | 系统代理忘了关 | 到 系统设置 → 网络 里关闭 Wi-Fi 的 HTTP/HTTPS 代理 |
📋 验收清单
- 证书在"系统"钥匙串里,信任级别为"始终信任"
- 浏览器打开任意 https 页面,不再弹"不安全"
- Host 是
127.0.0.1,端口8899,且没被别的进程占用 - "全量拦截"处于打开状态
networksetup -getwebproxy Wi-Fi显示的端口与应用内设置一致- 视频号视频被抓到,状态显示"就绪"
- 网页图片被抓到,能正常打开
- 下载下来的视频用播放器打开,画面声音都正常
到这里,证书、代理、捕获三关全部通过,res-downloader 可以当日常工具用了。想深挖细节,看 官方故障排除文档 和 快速上手;带着报错去提 Issue,解决得快。配置只是开头,抓到想存的东西才是目的。
【免费下载链接】res-downloader视频号、小程序、抖音、快手、小红书、直播流、m3u8、酷狗、QQ音乐等常见网络资源下载!项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考