前言说明：本文是在已有k8s集群和私有仓库harbor上进行离线安装kubesphere；官网的离线教程写都很详细，但是在部署部份把搭建集群和搭建仓库也写一起了，跟着做踩了点坑，这里就记录下来希望可以帮助到需要的xdm。

1.根据官网制作离线镜像包

按照官网的教程做离线包- 官网教程链接

做标红的部份

完成了离线包的制作并且上传到master节点后我们继续下面的内容！！！

2.推送镜像到私有仓库

直接生成一个默认的,然后我们只需要改动 registry 部份的内容

./kk create config --with-kubernetes v1.26.12

1. 编辑 config-sample.yaml，只需要改仓库部分 registry:

apiVersion: kubekey.kubesphere.io/v1alpha2
kind: Cluster
metadata:
  name: sample
spec:
  hosts:
  - {name: node1, address: 172.16.0.2, internalAddress: 172.16.0.2, user: ubuntu, password: "Qcloud@123"}
  - {name: node2, address: 172.16.0.3, internalAddress: 172.16.0.3, user: ubuntu, password: "Qcloud@123"}
  roleGroups:
    etcd:
    - node1
    control-plane: 
    - node1
    worker:
    - node1
    - node2
  controlPlaneEndpoint:
    ## Internal loadbalancer for apiservers 
    # internalLoadbalancer: haproxy

    domain: lb.kubesphere.local
    address: ""
    port: 6443
  kubernetes:
    version: v1.28.2
    clusterName: cluster.local
    autoRenewCerts: true
    containerManager: containerd
  etcd:
    type: kubekey
  network:
    plugin: calico
    kubePodsCIDR: 10.233.64.0/18
    kubeServiceCIDR: 10.233.0.0/18
    ## multus support. https://github.com/k8snetworkplumbingwg/multus-cni
    multusCNI:
      enabled: false
  # 只需要改这部份的内容
  registry:
    # 如需使用 kk 部署 harbor, 可将该参数设置为 harbor，不设置该参数且需使用 kk 创建容器镜像仓库，将默认使用 docker registry。
    # type: harbor
    # 如使用 kk 部署的 harbor 或其他需要登录的仓库，需设置对应仓库的 auths，如使用 kk 创建默认的 docker registry 仓库，则无需配置 auths 参数。
    auths:
      "lzz.harbor.com":
        # 部署 harbor 时需指定 harbor 帐号密码
         username: admin
         password: Harbor12345
         skipTLSVerify: true
    # 设置集群部署时使用的私有仓库地址。如果您已有可用的镜像仓库，请替换为您的实际镜像仓库地址。
    # 如果离线包中为原始 dockerhub 镜像（即 manifest 文件中的镜像地址为 docker.io/***），可以将该参数设置为 dockerhub.kubekey.local/ks, 表示将镜像全部推送至名为 ks 的 harbor 项目中。
    privateRegistry: "lzz.harbor.com"
    # 如果构建离线包时 Kubernetes 镜像使用的是阿里云仓库镜像，需配置该参数。如果使用 dockerhub 镜像，则无需配置此参数。
    namespaceOverride: "kubesphereio"
    registryMirrors: []
    insecureRegistries: []
  addons: []

//推送仓库
./kk artifact image push -f config-sample.yaml -a kubesphere.tar.gz

推送成功:

3.安装kubesphere

安装helm

//解压
tar -zxvf helm-v3.14.0-linux-amd64.tar.gz
//移动到bin目录
sudo mv linux-amd64/helm /usr/local/bin/helm
//授权
sudo chmod +x /usr/local/bin/helm

要在上传ks-core-1.1.3.tgz的目录中执行

helm upgrade --install -n kubesphere-system --create-namespace ks-core ks-core-1.1.3.tgz \
     --set global.imageRegistry=lzz.harbor.com/ks \ #替换为自己的镜像仓库
     --set extension.imageRegistry=lzz.harbor.com/ks \ #替换为自己的镜像仓库
     --set ksExtensionRepository.image.tag=v1.1.4 \
     --debug \
     --wait

输入如下就是成功

NOTES:
Thank you for choosing KubeSphere Helm Chart.

Please be patient and wait for several seconds for the KubeSphere deployment to complete.

1. Wait for Deployment Completion

    Confirm that all KubeSphere components are running by executing the following command:

    kubectl get pods -n kubesphere-system
2. Access the KubeSphere Console

    Once the deployment is complete, you can access the KubeSphere console using the following URL:

    http://192.168.6.6:30880

3. Login to KubeSphere Console

    Use the following credentials to log in:

    Account: admin
    Password: P@88w0rd

NOTE: It is highly recommended to change the default password immediately after the first login.
For additional information and details, please visit https://kubesphere.io.

访问可视化页面

#搞定收工！