前言

用过 Docker 的朋友基本都遇到过同一个痛点：拉镜像特别慢。官方 Docker Hub 的服务器在海外，国内直连经常只有几 KB/s，拉个大镜像能卡到你怀疑人生，最后只能去网上找各种时好时坏的"加速源"。这是国内玩自托管绕不开的坎。

KSpeeder 就是专门解决这个问题的工具。它是我在 iStoreOS 软路由上必装的一个插件，作用是 Docker 镜像加速，实测拉取镜像速度能到 20MB/s 以上，体验比裸连官方源强太多。最近我发现它还能以 Docker 镜像的形式直接部署在 NAS 上，效果一样很好——这就意味着，即便你没有软路由，只要有台 NAS 也能用上 KSpeeder 加速。

KSpeeder 官网：https://kspeeder.com/

💡 大致原理：KSpeeder 内置了多条经过优化的镜像下载通道，能智能选择最快的链路去拉取 Docker Hub 的镜像层，再把缓存分发给你本机。简单说，就是给"Docker Hub ↔ 你的机器"之间架了条更快的路，并把拉过的镜像缓存下来，二次拉取更快。

为什么拉个镜像会这么慢

"网速慢"只是表象，真实原因有三层，理解了才知道为什么各种加速方案效果差这么多。

① 链路问题：Docker Hub 的镜像存在海外的对象存储上。国内访问要走国际出口，出口带宽是共享的且经常拥塞——不是你家宽带不够，是路上的路太窄。

② 限速问题：Docker Hub 对匿名拉取有速率限制（按 IP 或账号计算单位时间内的拉取次数）。超了就直接拒绝或降速。家用宽带大多是共享公网 IP（NAT），意味着邻居的拉取量也可能算到你头上——这解释了一个诡异现象：同一份配置，有时快有时慢得离谱。

③ 分片问题：镜像不是一个文件，而是多层（layer）叠加，拉取时会并行下载多个层。只要有一层慢，整体就被拖住，最后表现为"卡在某一层不动"。

由此可以推出判断各种加速方案好坏的标准：它是不是把镜像数据缓存在离你更近的地方。这就是下面要讲的原理差异。

三类"加速方案"的本质区别

网上的"镜像加速"其实混着三种完全不同的东西，效果和风险差异很大：

所以别把"加一条 registry-mirrors"和"跑一个 KSpeeder"当成同一件事——前者是"借别人同步好的副本"，后者是"在你和源头之间加一个智能缓存层"。后者更接近"修路"，前者更像"找捷径"。

如果你更想了解公共镜像站那条路线怎么配、有哪些坑，我之前专门写过一篇：Docker 镜像加速方案对比，可以和这篇对照着看。

以飞牛 OS 为例部署 KSpeeder

1. 在飞牛的 Docker 里新建一个 Docker Compose 项目，填入以下内容：

services:
  kspeeder:
    image: registry.kspeeder.com/linkease/kspeeder:latest
    container_name: kspeeder
    ports:
      - "5443:5443"
      - "5003:5003"
    volumes:
      - ./kspeeder-data:/kspeeder-data
      - ./kspeeder-config:/kspeeder-config
    restart: unless-stopped

5443 是它的加速源端口，5003 一般是 Web 管理界面或辅助端口，保持映射即可；两个 volume 用于持久化加速缓存和配置，容器重建不丢。

关于这两个端口，补充一点：5443 是真正的"活"，它在你机器上开了一个类似 registry 的本地服务，Docker 拉镜像时其实是来访问这个端口；5003 是给你看状态用的。所以如果发现拉取还是慢，先确认 5443 是不是真的通了（用端口探测工具试一下），而不是只看 Web 界面是否打开。

注意镜像地址本身：registry.kspeeder.com/linkease/kspeeder:latest 是走它自家源拉取安装包。这个镜像很小（几 MB），所以即使国内直连也不会卡——这是设计上的考虑，避免"装加速器本身就要先加速"的鸡生蛋问题。

2. 添加加速源，让 Docker 走 KSpeeder 中转：

• 进入 KSpeeder 的 镜像仓库 → 设置 → 加速源设置；

• 添加一条加速源，地址填 https://registry.linkease.net:5443；

• 把这条 KSpeeder 加速源移动到第一项（置顶优先使用）；

• 保存并重启 Docker，让新配置生效。

⚠️ 这一步很关键：不重启 Docker 的话，新加的加速源可能不会立刻接管镜像拉取。重启后可以重新拉一次镜像验证速度。

为什么必须重启 Docker？ 因为镜像源的配置是 Docker 守护进程（dockerd）启动时读取的，改配置只改了文件，正在跑的进程不会重新加载。这一点和改 daemon.json 完全一样——凡是"改了 Docker 源不生效"，九成是没重启守护进程。

3. 回到 Docker 的容器/镜像页面，就能看到实际的加速拉取情况，速度上去了说明生效：

4. 关于付费：现阶段 KSpeeder 的免费额度完全够个人用，如果你觉得好用、想支持作者，可以视情况买会员（会员一般有更高带宽/更多并发，普通自用没必要）。

为什么第二次拉同一个镜像几乎瞬间完成

有个现象挺有意思：第一次拉某个镜像可能慢，第二次拉（或者别人在同网络下拉同一个镜像）几乎秒完成。这不是错觉，是两层缓存叠在一起的结果。

第一层：Docker 自己的本地层缓存。镜像由多层组成，Docker 在本地存了哪些层就跳过哪些。所以同一台机器重复拉同一个镜像，大部分层直接命中本地，只需要校验一下。

第二层：KSpeeder 的加速缓存。这一层才是 KSpeeder 的价值所在——它是跨设备共享的。具体是这样：

第 1 次（任意设备）：KSpeeder 回源拉取 → 存进它的缓存
第 2 次（任意设备）：直接由 KSpeeder 从缓存分发 → 不再走海外链路

也就是说，它的缓存命中的范围是"用过这个 KSpeeder 的所有设备"。在家庭或小团队场景下，一个人拉过的基础镜像（比如 redis、nginx、mysql 这些通用镜像），其他人再拉就完全不用等——这是单机装镜像加速站做不到的。

理解了这一点，你也能看出一件重要的事：缓存是有体积的。前面 ./kspeeder-data 那个挂载目录会随着使用变大，如果你的 NAS 系统盘空间紧张，记得把它挂到大容量盘上。同时这也解释了为什么换一台新的 KSpeeder 实例后"速度又回到了最初"——缓存是空的，得重新攒。

使用建议与排错

• 为什么我加了还是慢？ 先确认加速源有没有置顶、Docker 有没有重启；多试几次，加速通道偶尔也有波动，换个时间段再看。

• 软路由（iStoreOS）用户：直接在软路由上装 KSpeeder 插件，相当于给整个局域网内所有设备的 Docker 统一加速，一劳永逸，比在每台 NAS 上单独装更省心——这也是我最推荐的用法。

• NAS 用户：用上面的 Docker Compose 在 NAS 上部署即可，适合只有 NAS、没有软路由的场景。

• 加速源地址和端口如果官方有更新，以官网 / GitHub 最新文档为准。

按"从哪查起"的顺序，把常见故障整理成一张表：

最后一行值得单独说一句：单个设备装 KSpeeder，只加速这一台。如果你家里有好几台机器拉 Docker（比如 NAS + 迷你主机 + 树莓派），别一台台装——让它们共用同一个加速服务更划算，具体做法见我另一篇 局域网内所有设备共用 KSpeeder。

结尾

一句话总结：如果你经常被 Docker 拉镜像的速度折磨，KSpeeder 是个上手快、见效明显的免费加速方案——软路由装插件能覆盖全屋，NAS 上 Docker 部署也能单独提速。装上之后，那种"拉个镜像等到天荒地老"的日子基本就一去不复返了。

有问题，比如加完加速源不生效、速度还是上不去，欢迎评论区留言一起排查。