KSpeeder - Docker 镜像加速神器

什么是 KSpeeder

KSpeeder 是一款专为优化 Docker 镜像仓库访问而设计的工具，它提供了智能镜像源选择、下载加速、状态监控等多项功能。本项目基于轻量级 Alpine Linux 构建，支持多架构部署，能够在各种硬件平台上顺畅运行。

官方网站：https://kspeeder.com/

GitHub 项目：https://github.com/kspeeder/docker_kspeeder

核心特性

1. 带宽叠加技术

KSpeeder 最核心的功能是带宽叠加，能够将 SOCKS5/HTTP 代理以及各种镜像源进行带宽叠加，显著提升下载速度。

2. Cloudflare 优选 IP 加速

支持 Cloudflare 优选 IP 加速功能，自动选择最优的 CDN 节点，提升访问速度。

3. 多场景加速支持

支持日常开发中常用的多种服务加速：

• Docker Hub 镜像加速
• GitHub 克隆与下载加速
• Golang 模块下载加速
• Node.js NPM 加速
• Python PyPI 加速
• Java Maven 加速

4. 节点缓存与测量

accelnodemgr 会持续刷新节点库存、测速结果与 CFIP 信息，减少冷启动时的网络抖动。

5. 多架构支持

提供 buildx 脚本以及 nodes.sample.yaml 模板，支持从 x86_64 到 ARM64 的多种架构构建。

镜像版本选择

kspeeder 镜像支持多种标签（tag），可按稳定性/新特性需求选择：

快速部署

方式一：Docker Compose 部署（推荐）

1
2
3
4
5
6
7
8
9
10
11

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

启动命令：

1

docker-compose up -d

初始化时容器会在 ./kspeeder-config/nodes.yaml 生成示例配置，编辑或替换该文件即可让节点/镜像源生效。

方式二：单容器调试

1
2
3
4
5
6
7

docker run -d \
  --name kspeeder \
  -p 5443:5443 -p 5003:5003 \
  -v "$(pwd)/kspeeder-data:/kspeeder-data" \
  -v "$(pwd)/kspeeder-config:/kspeeder-config" \
  --restart unless-stopped \
  linkease/kspeeder:latest

端口受限场景解决方案

适用场景

• NAS / 群晖 Docker UI 不能填写 :5443（只能填写 https://... 默认走 443），导致镜像源”写不进/不生效”
• 宿主机 :443 已被其它服务占用，无法让 kspeeder 监听 :443

解决思路

• Docker 的 registry-mirrors 目标保持写成 https://registry.linkease.net（不带端口，等价 :443）
• 同时把 Docker daemon 的 HTTP_PROXY/HTTPS_PROXY 指向 kspeeder 管理端口（默认 :5003，支持 CONNECT 隧道）
• kspeeder 会将 registry.linkease.net:443 的 CONNECT 自动转接到本机 kspeeder TLS 端口（默认 :5443）

Docker Compose 部署（只暴露 5003）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

services:
  kspeeder:
    image: linkease/kspeeder:latest
    container_name: kspeeder
    ports:
      - "5003:5003" # Docker HTTP/HTTPS Proxy 指向这里
    volumes:
      - ./kspeeder-data:/kspeeder-data
      - ./kspeeder-config:/kspeeder-config
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
      - KSPEEDER_PORT=5443
      - KSPEEDER_ADMIN_PORT=5003
      - KSPEEDER_CONFIG=/kspeeder-config
      - KSPEEDER_DATA=/kspeeder-data
      - KS_USER_NODES_CONFIG=/kspeeder-config/nodes.yaml
      # 为空会禁用 CONNECT 代理；建议务必设置
      - KSPEEDER_PROXY_AUTH=user:pass

Docker Daemon 代理设置

1. 创建 /etc/systemd/system/docker.service.d/proxy.conf：

1
2
3
4

[Service]
Environment="HTTP_PROXY=http://user:pass@<kspeeder-host>:5003"
Environment="HTTPS_PROXY=http://user:pass@<kspeeder-host>:5003"
Environment="NO_PROXY=127.0.0.1,localhost"

2. 重启 Docker：

1
2

sudo systemctl daemon-reload
sudo systemctl restart docker

配置说明

环境变量

数据卷说明

• /kspeeder-data：保存缓存和测量结果
• /kspeeder-config：保存 kspeeder.yml 和 nodes.yaml 等配置文件

节点配置

• KS_USER_NODES_CONFIG：默认 /kspeeder-config/nodes.yaml，推荐 docker + proxies + domainfold 块联合配置镜像 & proxy 节点
• KS_USER_MIRROR_CONFIG：兼容旧 mirrors.yaml 配置，不建议添加新项；优先写入 nodes.yaml

使用验证

配置节点/镜像源后可通过以下命令验证代理生效：

1

docker info | grep "registry.linkease.net"

更改 nodes.yaml 或镜像源后可运行以下命令快速重载：

1
2
3
4
5

# Docker Compose 方式
docker-compose restart kspeeder

# Docker 单容器方式
docker restart kspeeder

多架构构建

如需自行构建多架构镜像，可参考以下流程：

1
2
3
4
5

docker run --rm --privileged docker/binfmt:a7996909642ee92942dcd6cff44b9b95f08dad64
docker buildx create --name mybuilder --driver docker-container
docker buildx use mybuilder
docker buildx build --platform linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64 \
  -t linkease/kspeeder:latest -f ./Dockerfile.architecture --push .

注意事项

1. 首次启动：请确保配置目录与数据目录可写
2. 端口修改：修改端口或新增环境变量需同步更新 Compose/YAML 配置
3. 服务管理：推荐使用 docker-compose 管理并启用 restart: unless-stopped 保障可用性
4. 代理认证：在端口受限场景下使用 CONNECT 代理模式时，建议务必设置 KSPEEDER_PROXY_AUTH

总结

KSpeeder 是一款功能强大的 Docker 镜像加速工具，特别适合以下场景：

• 国内用户访问 Docker Hub 缓慢
• NAS 用户需要稳定的镜像加速方案
• 开发者需要加速 GitHub、Golang、Node.js 等开发资源

通过带宽叠加、智能节点选择和 Cloudflare 优选等技术，KSpeeder 能够有效提升容器化部署的效率，让开发工作更加顺畅。