longhorn支持四种部署方式：一、helm chart一键部署，自动处理rbac、crd及命名空间；二、kubectl直接应用yaml清单，需确保open-iscsi已安装；三、rancher集成部署，支持多集群统一运维；四、离线环境部署，需预先拉取并加载镜像。
一、使用Helm Chart一键部署
如果您已在Kubernetes集群中安装Helm v3且配置了可用的kubeconfig，Longhorn可通过官方Helm仓库快速部署。该方式自动处理RBAC、CRD及命名空间创建，适合生产环境标准化交付。
1、添加Longhorn Helm仓库并更新索引：
helm repo add longhorn https://charts.longhorn.io
helm repo update
2、创建longhorn-system命名空间并启用自动创建：
helm install longhorn longhorn/longhorn --namespace longhorn-system --create-namespace --set defaultSettings.defaultDataPath="/var/lib/longhorn"
3、验证部署状态：
kubectl -n longhorn-system get pods -l app=longhorn-manager
所有longhorn-manager Pod必须处于Running状态，且Ready为1/1
二、使用kubectl直接应用YAML清单
当集群未安装Helm或需精确控制资源定义时，可直接通过kubectl部署官方发布的longhorn.yaml。该清单已预置所有必需组件，包括CRD、ServiceAccount、RoleBinding及DaemonSet。
1、下载最新稳定版YAML文件（以v1.6.2为例）：
curl -LO https://github.com/longhorn/longhorn/releases/download/v1.6.2/longhorn.yaml
2、修改data-path路径（可选，确保目标路径在所有节点存在且有写权限）：
sed -i 's|/var/lib/longhorn|/data/longhorn|g' longhorn.yaml
3、执行部署：
kubectl apply -f longhorn.yaml
执行前必须确认所有节点已安装open-iscsi且iscsid服务处于active状态
三、Rancher集成部署
若集群由Rancher v2.6+统一纳管，Longhorn可作为Catalog App直接部署。该方式自动注入Rancher特定标签与监控集成，适用于多集群统一运维场景。
1、登录Rancher UI，进入目标集群的Apps页面
2、点击【Launch】→ 搜索“longhorn” → 选择“Longhorn”应用（来源：rancher-charts）
3、在配置界面设置以下关键参数：
namespace: longhorn-system
defaultSettings.taintToleration: "node-role.kubernetes.io/controlplane:NoSchedule"
4、点击【Launch】提交部署
Rancher部署后需手动检查longhorn-system命名空间下DaemonSet是否成功调度至所有worker节点
四、离线环境部署（Air-Gapped）
在无外网访问能力的生产环境中，需预先拉取镜像并构建本地仓库。该方案避免运行时网络依赖，满足金融、政务等高安全等级要求。
1、在可联网机器上执行镜像导出：
docker pull longhornio/longhorn-manager:v1.6.2
docker pull longhornio/longhorn-engine:v1.6.2
docker pull longhornio/longhorn-ui:v1.6.2
docker save longhornio/longhorn-manager:v1.6.2 longhornio/longhorn-engine:v1.6.2 longhornio/longhorn-ui:v1.6.2 > longhorn-images.tar
2、将tar包拷贝至内网集群任一节点，加载镜像：
docker load
3、推送至内网Harbor仓库（假设地址为harbor.internal/longhorn）：
docker tag longhornio/longhorn-manager:v1.6.2 harbor.internal/longhorn/manager:v1.6.2
docker push harbor.internal/longhorn/manager:v1.6.2
4、修改longhorn.yaml中的image字段为内网地址，并执行kubectl apply
离线部署必须同步替换所有组件镜像地址，包括manager、engine、ui、instance-manager
五、Windows节点适配部署
在Linux与Windows混合Kubernetes集群中，Longhorn需额外启用CSI Windows支持模块。Windows节点不运行longhorn-manager DaemonSet，但需配置iSCSI initiator及网络策略以挂载卷。
1、在Windows节点上启用iSCSI发起程序：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-ISCSI-Initiator -All -NoRestart
2、配置Windows防火墙放行Longhorn端口：
New-NetFirewallRule -DisplayName "Longhorn iSCSI" -Direction Inbound -Protocol TCP -LocalPort 3260 -Action Allow
3、在Linux控制节点部署时启用Windows支持：
helm install longhorn longhorn/longhorn --namespace longhorn-system --create-namespace --set windows.enabled=true
Windows节点必须已通过kubeadm或k3s正确加入集群，且Node对象的OS字段为windows
