突破macOS证书限制：res-downloader终端命令速查指南

你是否在使用res-downloader时遇到"证书不信任"错误？还在为终端命令记不住而烦恼？本文整理了macOS系统下证书安装与终端操作的全套解决方案，包含12个核心命令、3种错误排查方法和5个实用场景示例，让你5分钟内搞定所有配置问题。

证书安装基础

res-downloader通过自定义证书实现网络资源嗅探，在macOS系统中需要手动将证书添加到系统信任链。证书文件默认存储位置：

/Users/$(whoami)/Library/Preferences/res-downloader/cert.crt

一键安装命令

最新版(V3+)支持终端自动安装，打开「终端」应用，复制以下命令并回车：

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 "安装完成"

执行过程中需要输入系统密码（输入时不会显示字符，输完直接回车即可）。成功后会显示安装完成提示。

手动安装步骤

如果自动命令失败，可以按照以下步骤操作：

1. 打开证书存放目录：/Users/$(whoami)/Library/Preferences/res-downloader/
2. 双击cert.crt文件，钥匙串访问会自动打开
3. 选择"系统"钥匙串，点击"添加"
4. 右键刚添加的证书，选择"显示简介"
5. 展开"信任"选项，设置"使用此证书时"为"始终信任"

证书安装界面

官方安装文档：docs/installation.md

终端命令大全

核心功能命令

功能	命令	适用场景
启动应用	/Applications/res-downloader.app/Contents/MacOS/res-downloader	从终端启动以便查看日志
证书状态检查	security find-certificate -c "res-downloader" /Library/Keychains/System.keychain	验证证书是否正确安装
创建锁文件	touch /Users/$(whoami)/Library/Preferences/res-downloader/install.lock	解决证书重复提示问题
清除应用缓存	rm -rf /Users/$(whoami)/Library/Preferences/res-downloader/cache	修复资源加载异常
查看代理设置	networksetup -getwebproxy Wi-Fi	检查系统代理是否正确配置

问题修复命令

当遇到"已损坏，无法打开"错误时，执行以下命令解除 quarantine 限制：

sudo xattr -d com.apple.quarantine /Applications/res-downloader.app

修复网络代理问题：

# 关闭系统代理
networksetup -setwebproxy Wi-Fi off
# 恢复res-downloader代理设置
networksetup -setwebproxy Wi-Fi 127.0.0.1 8899

完整故障排除指南：docs/troubleshooting.md

实战场景示例

场景1：首次安装后的配置流程

1. 安装应用到/Applications目录
2. 执行证书自动安装命令
3. 验证代理设置是否生效：

networksetup -getwebproxy Wi-Fi | grep "127.0.0.1"

若显示Server: 127.0.0.1和Port: 8899则配置正确。

场景2：微信视频号下载配置

1. 启动res-downloader
2. 在应用设置中开启"视频号拦截"
3. 打开微信视频号，播放目标视频
4. 在应用主界面查看下载内容

视频下载界面

场景3：证书失效后的重置方案

当浏览器提示"链接不是私密链接"时：

1. 删除旧证书：

sudo security delete-certificate -c "res-downloader" /Library/Keychains/System.keychain

2. 删除应用配置：

rm -rf /Users/$(whoami)/Library/Preferences/res-downloader

3. 重新运行应用并完成证书安装流程

高级配置技巧

自定义下载路径

通过修改配置文件自定义下载目录：

# 编辑配置文件
nano /Users/$(whoami)/Library/Preferences/res-downloader/config.json

修改"download_path"字段为自定义目录，如"~/Movies/res-downloader"

自动化脚本示例

创建一个简单的bash脚本res-downloader.sh管理应用：

#!/bin/bash
case "$1" in
  start)
    /Applications/res-downloader.app/Contents/MacOS/res-downloader &
    ;;
  stop)
    pkill -f res-downloader
    # 关闭代理
    networksetup -setwebproxy Wi-Fi off
    ;;
  status)
    if pgrep -x "res-downloader" > /dev/null; then
      echo "运行中"
    else
      echo "已停止"
    fi
    ;;
  *)
    echo "用法: $0 {start|stop|status}"
    exit 1
    ;;
esac

保存后赋予执行权限：chmod +x res-downloader.sh

常见问题图解

证书安装成功后，系统代理设置应如下所示：

系统代理配置

视频下载示例界面：

下载示例

更多高级功能设置：

高级设置

总结与资源

通过本文介绍的终端命令和配置方法，你可以解决99%的res-downloader使用问题。记住几个核心操作：

1. 证书安装命令解决信任问题
2. 代理设置检查确保网络拦截正常
3. 缓存清理修复资源加载异常

完整用户手册：docs/readme.md
命令行工具源码：core/proxy.go
视频教程示例：docs/examples.md

遇到新问题？请查看故障排除指南或在应用内使用"反馈"功能提交问题报告。