为飞牛NAS部署KSpeeder，告别Docker镜像下载慢和中断的烦恼

一、 什么是KSpeeder？它能解决什么问题？

在使用飞牛OS或其他NAS系统时，从Docker官方或国内镜像站拉取镜像经常遇到速度慢、链接中断等问题。一旦中断，就必须从头开始下载，非常耗时麻烦。

KSpeeder 是一个强大的Docker镜像加速工具，它能：

• 多镜像并发下载：从多个加速节点同时下载一个镜像的不同部分，极大提升速度。

• 动态负载均衡：自动选择当前最快、最稳定的节点进行下载。

• 断点续传：下载中断后，无需重头开始，从中断处继续下载。

• 一次部署，长期受益：自动配置，无需再手动切换和担心某个镜像站失效。

二、 准备工作

• 一台已安装飞牛OS的NAS设备。

• 确保飞牛OS的Docker服务已启用。

三、 安装部署KSpeeder (三种方法任选其一)

方法一：使用Docker命令（最简单）

1. 登录飞牛OS，打开「终端」应用。

2. 复制并粘贴以下命令，然后按回车执行。

docker stop kspeeder 2>/dev/null; \
docker rm kspeeder 2>/dev/null; \
docker run -d \
  --pull=always \
  --name kspeeder \
  -p 5443:5443 \
  -p 5003:5003 \
  -v /vol1/1000/docker/kspeeder/data:/kspeeder-data \
  -v /vol1/1000/docker/kspeeder/config:/kspeeder-config \
  --restart unless-stopped \
  linkease/kspeeder:latest

这条命令会自动停止并删除旧容器（如果存在），然后拉取最新镜像并启动。

方法二：使用Docker Compose（更易于管理）

1. 使用飞牛OS的「文件管理」应用，进入建议的目录：/vol1/1000/Compose/kspeeder/。

2. 在此目录下创建一个名为 docker-compose.yml 的文件。

3. 用文本编辑器打开该文件，复制粘贴以下 内容并保存：

services:
  kspeeder:
    image: linkease/kspeeder:latest
    container_name: kspeeder
    ports:
      - "5443:5443"
      - "5003:5003"
    volumes:
      - /vol1/1000/docker/kspeeder/data:/kspeeder-data
      - /vol1/1000/docker/kspeeder/config:/kspeeder-config
    restart: unless-stopped

部署完成后，你可以在飞牛OS的「容器管理」中看到名为 kspeeder 的容器正在运行。

四、 配置和使用

1. 访问管理界面：
   打开你的浏览器，输入你的飞牛NAS的IP地址加上端口号 :5003。
   例如：https://192.168.1.100:5003
   你将看到KSpeeder的管理面板，这里展示了可用的加速节点和实时统计信息。

测试加速效果：
打开飞牛OS的终端，尝试拉取一个测试镜像，命令中的地址已经指向了你本地搭建的KSpeeder加速服务。

docker pull registry.linkease.net:5443/library/alpine

如果能够正常下载，说明加速服务部署成功！

2. （可选但推荐）配置Docker默认使用KSpeeder：
   为了让所有 docker pull 命令都默认走KSpeeder加速，需要配置Docker守护进程。

• 在飞牛OS的「系统设置」 -> 「Docker」 -> 「镜像管理」 -> 「镜像加速」中。

删除旧的加速器地址，添加一行新的加速地址：

  https://registry.linkease.net:5443

• 点击「应用」或「确定」，系统会提示需要重启Docker服务才能使配置生效。

五、 享受极速下载

现在，你可以像平常一样使用 docker pull 命令拉取任何镜像了。KSpeeder会在后台自动为你进行多节点加速。

例如，尝试拉取一个大型镜像体验速度飞跃：

docker pull linuxserver/brave

你会从飞牛OS的容器管理界面或者KSpeeder的管理页面 (:5003) 看到，下载速度远超以往，并且是由多个节点并行下载完成的。