https://squareuncle.com/tags/docker/ Recent content in Docker on Square Uncle Hugo -- 0.147.7 zh-cn Thu, 02 Apr 2026 21:15:00 +0800 https://squareuncle.com/posts/2026-04-02-sovereign-youtube-downloader-architecture/ Thu, 02 Apr 2026 21:15:00 +0800 https://squareuncle.com/posts/2026-04-02-sovereign-youtube-downloader-architecture/ <p><img alt="YouTube 下载器架构封面" loading="lazy" src="https://squareuncle.com/images/youtube_downloader_architecture.png"></p> <p>[!TIP]</p> <blockquote> <p><strong>受众</strong>：对自托管工具感兴趣、经常与各种“限制”博弈的开发者。 <strong>核心目标</strong>：构建一个完全受控的 YouTube 媒体采集系统，解决 <code>n challenge</code> 签名挑战。 <strong>问题-方案映射</strong>：</p> <ul> <li>登录墙/Cookie $\rightarrow$ Manifest v3 浏览器插件同步</li> <li>动态签名 (n-sig) $\rightarrow$ Docker 内置 External JS Solver (node)</li> <li>实时观测 $\rightarrow$ Socket.io 流式转发 stdout</li> </ul></blockquote> <p>最近在折腾自己的“数字主权”基础设施，其中一个刚需就是 YouTube 下载。市面上的工具很多，但随着 YouTube 对 <code>n-sig</code>（一种通过混淆 JS 动态生成的签名）的限制加码，很多开源项目开始在大音轨下载上“翻车”。</p> <p>作为一个写了 20 年代码的老兵，我最受不了的就是“工具不可控”。于是，我把这套老伙计重新打磨了一下，做了一个“主权级”的架构。</p> <h2 id="1-架构为什么非要搞这么复杂">1. 架构：为什么非要搞这么复杂？</h2> <p>很多人觉得 <code>yt-dlp</code> 一行命令能解决的事，为什么要搞插件、Docker 和后端？</p> <p>答案是：<strong>骨感现实</strong>。</p> <ul> <li><strong>Cookie 维护</strong>：手动导 <code>cookies.txt</code> 太脏。我写了一个 Manifest v3 插件，点一下直接同步到云端。</li> <li><strong>环境隔离</strong>：我的开发机是 Windows，但下载器必须部署在 Linux Docker 里，且需要精准控制 <code>ffmpeg</code> 和 <code>yt-dlp</code> 的版本。</li> </ul> <p>这就是我们的“三足鼎立”：</p> <ul> <li><strong>插件 (Bridge)</strong>：负责打通浏览器会话。</li> <li><strong>后端 (Engine)</strong>：Node.js + Socket.io，负责进程管理和实时日志。</li> <li><strong>容器 (Infra)</strong>：解决一切环境依赖。</li> </ul> <h2 id="2-泥地打滚解决-n-sig-的深层逻辑">2. 泥地打滚：解决 n-sig 的深层逻辑</h2> <p>前阵子，我的下载器突然报错：<code>n challenge solving failed</code>。这是 YouTube 升级了混淆逻辑，<code>yt-dlp</code> 默认的 Python 模拟器解不动了。</p>