Docker 部署 KSpeeder 镜像加速器 🚀

KSpeeder

📋 目录导航

🎯 项目简介

KSpeeder 是一款由 iStoreOS 团队开发的智能 Docker 镜像加速器服务。它通过先进的缓存技术和代理机制，显著提升 Docker 镜像的拉取速度，特别针对国内网络环境访问 Docker Hub 等海外镜像仓库进行了深度优化。🚀

使用 KSpeeder 可以：

  • ⚡ 加速 CI/CD 流程 - 减少构建等待时间
  • 🌐 优化开发体验 - 快速获取所需镜像
  • 📉 降低失败率 - 减少因网络波动导致的拉取失败
  • 💰 节省带宽成本 - 通过智能缓存减少重复下载

🐳 一、Docker 部署 KSpeeder

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
mkdir -p /mnt/mydisk/home/kspeeder && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  kspeeder:
    image: linkease/kspeeder:latest
    container_name: kspeeder
    ports:
      - "5443:5443"  # 镜像加速服务端口
      - "5003:5003"  # Web 管理界面端口
    volumes:
      - ./kspeeder-data:/kspeeder-data  # 数据持久化目录
      - ./kspeeder-config:/kspeeder-config  # 配置持久化目录
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 时区设置
      - CACHE_SIZE=20G  # 缓存大小限制（可选）
EOF

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

⚙️ 二、服务端使用配置

说明：此部分针对 运行 KSpeeder 的服务端设备 进行配置。

1. 配置服务端 Docker 使用加速器 ⚙️

在部署了 KSpeeder 的服务器上，需要配置 Docker 使用本地加速器：

  1. 修改或创建 Docker 配置文件 /etc/docker/daemon.json：
1
2
3
4
5
cat > /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": ["https://registry.linkease.net:5443"]
}
EOF
  1. 重启 Docker 服务使配置生效：
1
sudo systemctl restart docker

💡 提示：如果您的服务器需要通过 localhost 访问，确保 registry.linkease.net 在服务器上解析为 127.0.0.1 或服务器的局域网 IP。

2. 验证加速器是否生效 ✅

  1. 拉取测试镜像验证加速效果：
1
docker pull hello-world
  1. 检查 Docker 配置：
1
docker info | grep -i mirror

应该能看到配置的加速器地址。

3. 访问管理界面 📊

  1. 打开浏览器访问 http://服务器IP:5003
  2. 查看缓存统计、带宽节省情况和性能指标
  3. 监控服务状态和缓存命中率

🌐 三、局域网其他设备使用加速器

说明：此部分针对 局域网内其他需要加速的设备 进行配置。

1. 环境准备与说明 📝

先决条件：

  • KSpeeder 服务已在服务器（例如 10.10.10.251）上正常运行
  • 客户端设备与服务器在同一局域网内
  • 客户端设备上已安装 Docker

网络信息示例：

  • KSpeeder 服务器：IP 地址为 10.10.10.251
  • 客户端设备：IP 地址为 10.10.10.246

重要：局域网设备需要将 registry.linkease.net 解析到 KSpeeder 服务器的 IP 地址，才能使用加速服务。

2. 配置局域网设备使用加速器 ⚙️

方法一：客户端独立修改（推荐单设备）

此方法仅在需要加速的单个客户端设备上修改，不影响局域网其他设备。

步骤：

  1. 配置 Docker 镜像源：

    1
    2
    3
    4
    5
    6
    7
    cat > /etc/docker/daemon.json <<'EOF'
    {
      "registry-mirrors": ["https://registry.linkease.net:5443"]
    }
    EOF

    sudo systemctl restart docker

  2. 修改 /etc/hosts 文件（使域名解析到 KSpeeder 服务器）：

    1
    2
    # 使用一键追加命令
    echo "10.10.10.251 registry.linkease.net" | sudo tee -a /etc/hosts

  3. 验证域名解析：

    1
    ping registry.linkease.net

    应该显示解析到 10.10.10.251。

方法二：局域网全局修改（推荐多设备）

此方法在局域网的路由器或主 DNS 服务器上进行配置，所有接入该网络的设备无需单独设置即可使用 KSpeeder 加速服务。

方案 A：修改路由器 Hosts 文件
适用于支持自定义 Hosts 文件的路由器系统（如 OpenWrt, LEDE 等）。

1
2
3
4
5
6
7
8
# 通过 SSH 登录路由器
ssh admin@路由器IP

# 使用一键追加命令
echo "10.10.10.251 registry.linkease.net" | sudo tee -a /etc/hosts

# 重启 DNS 服务
/etc/init.d/dnsmasq reload

方案 B：配置 Dnsmasq 解析规则
如果路由器使用 Dnsmasq 作为 DNS 服务器，可通过 Web 界面配置：

  1. 登录路由器 Web 管理界面
  2. 导航到 网络 → DHCP/DNS 设置页面
  3. 在 域名重写 或 自定义 DNS 解析记录 区域添加：
    • 域名：/registry.linkease.net/
    • IP 地址：10.10.10.251
1
/registry.linkease.net/192.168.31.100

3. 配置验证与测试 ✅

完成配置后，在局域网客户端设备上进行测试：

  1. 基础连通性测试：

    1
    2
    3
    4
    5
    # 验证域名解析
    ping registry.linkease.net

    # 测试 HTTPS 端口
    curl -I https://registry.linkease.net:5443

  2. Docker 镜像拉取测试：

    1
    docker pull hello-world

🌐 四、Nginx 反向代理配置

管理后台地址示例：https://kspeeder.example.com:666

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/kspeeder.conf <<'EOF'
server {
    listen 666 ssl;
    listen [::]:666 ssl;
    server_name kspeeder.example.com;   # 替换为你的域名

    # SSL 证书
    ssl_certificate /etc/nginx/keyfile/cert.pem;
    ssl_certificate_key /etc/nginx/keyfile/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:5003;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 错误页
    error_page 404 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 五、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航加速，效率无限

通过本文档，您已经掌握了 KSpeeder 的完整部署和使用方法：

🖥️ 服务端配置：

  • 部署 KSpeeder 容器服务
  • 配置本地 Docker 使用加速器
  • 通过管理界面监控服务状态

🌐 局域网共享：

  • 为单个设备配置独立加速（修改 hosts）
  • 为整个局域网配置全局加速（路由器 DNS）
  • 验证加速效果和性能提升

🚀 核心优势：

⚡ 极速拉取 - 享受飞一般的镜像下载体验
💾 智能缓存 - 一次拉取，全网共享，节省 70% 带宽
🔧 灵活部署 - 支持单机、局域网和多集群环境
📊 实时监控 - 可视化界面查看缓存状态和性能指标

加速之路，是一场与时间赛跑的技术竞赛。愿 KSpeeder 成为您的得力助手，陪伴您在每一次构建和部署的挑战中。

从现在开始，极速下载，高效部署——构建您无缝流畅的开发体验吧！🚀

📌 持续迭代：建议关注 KSpeeder 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝您加速愉快，部署有成！🎉