Linux安装Longhorn存储教程

本文全面详解了在Linux环境下为Kubernetes集群部署Longhorn分布式块存储的五种主流方式——从适合生产环境快速落地的Helm一键部署、灵活可控的kubectl YAML清单部署，到与Rancher深度集成的统一运维方案，再到满足高安全要求的离线环境部署，以及对Windows混合节点的适配支持；每种方式均配有清晰的操作步骤、关键配置说明和注意事项，帮助运维人员根据实际网络条件、工具链成熟度和安全合规要求，精准选择并高效完成Longhorn的安装与验证。

一、使用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

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Linux安装Longhorn存储教程》文章吧，也可关注golang学习网公众号了解相关技术文章。