Skip to content

K3s v1.35.4+k3s1 镜像收集与同步

概述

本目录包含 K3s v1.35.4+k3s1 全部系统镜像的收集清单,以及从国内镜像源同步到内网 Harbor 仓库的自动化脚本。

文件清单

文件说明
k3s-images.txtK3s 官方镜像列表 (来源: GitHub Release)
k3s-images-harbor.txt同步后的 Harbor 内网镜像列表
sync-images.sh镜像同步脚本 (国内源 → Harbor)
README.md本文档

K3s v1.35.4+k3s1 镜像汇总

镜像版本用途
rancher/klipper-helmv0.9.17-build20260422Helm 控制器 Job 镜像
rancher/klipper-lbv0.4.15ServiceLB (内置负载均衡)
rancher/local-path-provisionerv0.0.35本地路径存储供应器
rancher/mirrored-coredns-coredns1.14.2CoreDNS (集群 DNS)
rancher/mirrored-library-busybox1.37.0BusyBox (helper pod)
rancher/mirrored-library-traefik3.6.13Traefik Ingress Controller
rancher/mirrored-metrics-serverv0.8.1Metrics Server
rancher/mirrored-pause3.6Pause 容器 (Pod 沙箱)

Harbor 仓库信息

项目
地址192.168.122.156:30000
协议HTTP
用户admin
项目rancher (自动创建)

国内镜像源

脚本按优先级依次尝试以下镜像源 (2026年8月验证可用):

  1. docker.1ms.run
  2. docker.m.daocloud.io
  3. dockerpull.org
  4. hub.rat.dev
  5. doocker.com

使用方法

1. 同步全部镜像

bash
bash sync-images.sh

2. Dry-run 模式 (仅预览)

bash
bash sync-images.sh --dry-run

3. 指定镜像源

bash
MIRROR=docker.m.daocloud.io bash sync-images.sh

4. 手动同步单个镜像

bash
skopeo copy --src-tls-verify=false --dest-tls-verify=false \
  --dest-creds "admin:xxx" \
  docker://docker.1ms.run/rancher/mirrored-pause:3.6 \
  docker://192.168.122.156:30000/rancher/mirrored-pause:3.6

同步后的使用

K3s 配置 registries.yaml

在 K3s 节点上配置 /etc/rancher/k3s/registries.yaml:

yaml
mirrors:
  docker.io:
    endpoint:
      - "http://192.168.122.156:30000"
  rancher:
    endpoint:
      - "http://192.168.122.156:30000"
configs:
  "192.168.122.156:30000":
    auth:
      username: xxx
      password: xxx
    tls:
      insecure_skip_verify: true

在 Pod 中使用 Harbor 镜像

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: example
spec:
  template:
    spec:
      containers:
      - name: coredns
        image: 192.168.122.156:30000/rancher/mirrored-coredns-coredns:1.14.2

依赖

工具用途安装
skopeo镜像复制 (免 Docker daemon)apt install skopeodnf install skopeo
curlHarbor API 调用系统自带
jqJSON 解析apt install jqdnf install jq

脚本特性

  • ✅ 自动检查/创建 Harbor 项目
  • ✅ digest 对比跳过已存在镜像 (增量同步)
  • ✅ 多镜像源自动容错
  • ✅ 单镜像 10 分钟超时保护
  • ✅ dry-run 预览模式
  • ✅ 同步日志记录 (sync-result.log)
  • ✅ 自动生成功能 Harbor 镜像列表