01快速开始
铁锚是一个 macOS 原生下载工具，所有解析与下载都在你自己的电脑上完成。安装包已经内置全部依赖，不需要你另外安装 Homebrew、Python、ffmpeg 或 yt-dlp。
安装
- 下载 DMG 后双击打开，把 铁锚 拖进「应用程序」文件夹。
- 从「应用程序」里启动。首次启动可能需要几秒完成系统校验。
关于安全提示：铁锚已经过 Apple 公证（Notarization），正常情况下不会出现「无法打开，因为无法验证开发者」。如果你是从非官网渠道拿到的安装包而出现该提示，请不要绕过它，回到 官网 重新下载。
下载你的第一个视频
- 复制视频页面的链接。
- 回到铁锚，链接会被自动识别；或者点顶部输入框手动粘贴。
- 选清晰度和保存位置，点「开始下载」。
默认保存到「下载」文件夹。首次写入时 macOS 会请求访问权限，点「允许」即可。
02四种下载方式，分别适合什么
| 方式 | 适合场景 |
|---|---|
| 粘贴链接 | 最常用。绝大多数公开视频页直接粘贴就行。 |
| 内置浏览器 | 需要登录才能看的内容。在铁锚内置的浏览器里登录一次，登录状态会自动带入下载，无需导出 Cookie。这也是遇到解析失败时最值得先试的办法。 |
| 浏览器扩展 | 习惯用 Chrome / Edge 浏览的人。在原来的浏览器里点一下就推送到铁锚队列，见下一节。 |
| 拖拽 / 批量 | 把多个链接一次粘进批量输入框，或直接拖入文本文件。 |
一条经验：任何「解析失败」，先用内置浏览器打开同一个页面试试。很多站点对未登录访客限制画质甚至完全不给数据，登录后问题就消失了。
03浏览器扩展：安装与配对
扩展会在你浏览的页面里探测媒体流，一键推送到铁锚的下载队列，并把你在浏览器里的登录态一起带过去——登录墙后面的内容因此也能下。支持 Chrome、Edge、Brave、Vivaldi 与 Firefox。
扩展已经在铁锚安装包里了，不用另外下载。打开铁锚 → 设置 → 浏览器 → 点「在访达中显示」，就能定位到扩展文件夹。这样做还有一个好处：以后铁锚更新时扩展跟着一起更新，你不用再操心。
第一步：装到浏览器里
Chrome / Edge / Brave / Vivaldi
- 在铁锚的设置里点「在访达中显示」，记下这个
Extension文件夹的位置。 - 浏览器地址栏输入
chrome://extensions（Edge 为edge://extensions）。 - 打开右上角开发者模式，点加载已解压的扩展程序，选中那个
Extension文件夹。
我们不上架 Chrome 应用商店，所以需要用「加载已解压」的方式安装。浏览器每次启动可能提示「请停用开发者模式扩展程序」，点取消即可继续使用。
Firefox 115 及以上
- 地址栏输入
about:debugging#/runtime/this-firefox。 - 点临时载入附加组件，选择
Extension文件夹里的manifest.json。
Firefox 只允许经 Mozilla 签名的扩展常驻，所以每次重启浏览器后需要重新载入一次。这是 Firefox 对未签名扩展的限制，长期使用建议用 Chrome 或 Edge。
第二步：什么都不用做
装好之后打开扩展弹窗，看到「已连接铁锚」就可以用了。配对是自动完成的——铁锚会通过原生通道把令牌直接发给扩展，你不需要手抄任何东西。
随便打开一个视频页面，点工具栏上的铁锚助手图标，就能看到这一页有什么可下。
还没装铁锚，想先看看扩展
这个压缩包和铁锚安装包里带的是同一份。单独装它也能用，但推送目标（铁锚本体）还是要装的；而且这样装的扩展不会跟着铁锚一起更新，需要你自己回来下新版。
扩展旧了会怎样。浏览器不会自动更新这类扩展，而旧扩展不会报错——它照样连得上、照样能推任务，只是少了新版才认识的网站。所以铁锚会在设置 → 浏览器里显示你装的是哪个版本，旧了会直接说出来。遇到「某个网站在浏览器里下不了、在铁锚内置浏览器里能下」，先来这里看一眼版本。
手动配对（备用）：设置页里那串令牌只在原生通道用不上时才需要——比如你用的浏览器我们没覆盖到，或者宿主清单被安全软件清掉了。令牌等同于「允许外部程序往铁锚提交下载」的钥匙，怀疑泄露就点「重新生成」，旧令牌立即失效；清空令牌则彻底关闭这个入口。
04下载国外网站的内容
铁锚的解析和下载全部在你的电脑上执行，走的是你自己的网络。所以能不能下载国外站点，取决于你的电脑能不能访问它。
如果你在使用代理工具，请在代理软件里开启全局模式、系统代理或 TUN 模式。铁锚会自动跟随系统代理设置，解析与下载都会走同一条线路，无需在铁锚里单独配置。
为什么必须是同一条线路：很多站点（YouTube 尤其明显）给出的媒体地址是绑定请求方 IP 的。如果解析走一条线路、下载走另一条，服务器会直接拒绝。让两步都走系统代理就不会有这个问题。
YouTube 提示「Sign in to confirm you're not a bot」
这是 YouTube 对陌生 IP 的人机验证，不是铁锚的故障。用内置浏览器打开并登录你的 Google 账号，登录状态会自动带入，之后正常下载即可。
05免费档与会员的区别
免费档可以正常下载，不限制数量、不加水印。会员解锁的是这些能力：
| 能力 | 免费档 | 会员 |
|---|---|---|
| 单个下载 | ✅ 不限量 | ✅ |
| 最佳可用画质 | ✅ 自动选最佳 | ✅ |
| 内置浏览器嗅探 | ✅ | ✅ |
| 仅音频提取 | ✅ | ✅ |
| 自选清晰度 | — | ✅ |
| 批量下载 | — | ✅ |
| 音频母带级处理 | — | ✅ |
| 格式转码 | — | ✅ |
| 多线程加速 | — | ✅ |
| 直播录制 | ✅ 从当前时间点开始 | ✅ 可从直播起点回溯 |
直播录制免费档也能用，区别只在于能不能回溯到开播位置。
账号与订阅在 账号中心 管理。
06故障排查
提示「该内容需要登录 / 会员权限」
指的是来源网站需要登录，不是铁锚的会员。用内置浏览器登录该网站后重试。
提示「资源不存在或已被删除」
链接本身已失效。用浏览器打开确认一下页面是否还在。
下载很慢，或者卡住不动
- 先确认是不是来源站限速——同一个链接在浏览器里直接播放看看流畅度。
- 如果在用代理，试试切换节点。
- 会员可以开启多线程加速。
「全部下载完成后睡眠 / 关机」没有生效
这个功能需要控制系统事件的权限。第一次触发时 macOS 会弹出授权请求，如果当时点了「不允许」，请到系统设置 → 隐私与安全性 → 自动化里，允许铁锚控制「系统事件」。
任务显示「部分完成」
主文件下载成功了，但某个附加步骤（字幕、封面、章节、转码等）没成功。展开任务可以看到具体原因，主文件是可以正常播放的。
还是不行？导出诊断报告
在设置里导出诊断报告发给我们。报告在生成时会自动去除链接中的签名与令牌等敏感参数，但仍建议你发送前自己扫一眼。
07更新与卸载
铁锚会检查新版本并在有更新时提示你。它不会在后台自行替换程序——是否更新由你决定，点击后会引导你下载新版本安装包。
卸载：把「应用程序」里的铁锚拖到废纸篓即可。若要一并清除配置与缓存，删除以下位置中带 com.matou.dock 的项目：
~/Library/Preferences/
~/Library/Application Support/08隐私
- 解析与下载在本机完成，你的下载链接不会被上传。
- 你在内置浏览器里的登录信息保存在本地，仅用于向对应站点发起请求。
- 联网行为仅限：你要下载的站点、检查软件更新、以及登录时的账号服务。