首页/云/Kubernetes 速查/hostPath 挂载节点目录
配置与存储54 条

hostPath 挂载节点目录

直接挂载节点上的路径(如 /var/log、/dev),用于采集节点日志或访问设备;对调度与权限有强约束,能用 local PV 或 CSI 替代时优先替代。

Kubernetes 速查云更新于 2026-10-12

hostPath 示例

hostPath 示例
volumes:
  - name: varlog
    hostPath:
      path: /var/log
      type: Directory
  - name: data
    hostPath:
      path: /data/app
      type: DirectoryOrCreate

常用 type

行为说明
Directory路径必须已存在且为目录
DirectoryOrCreate不存在则创建(0755、kubelet 属主)
FileOrCreate不存在则创建空文件
Socket路径必须是 unix socket
hostPath 数据与节点绑定:Pod 漂移后读写的是另一台机器上的目录,且没有容量隔离。

易错点

  • 未做 nodeAffinity 时 Pod 可调度到任意节点,各节点 /var/log 内容不同,排查容易被误导
  • DirectoryOrCreate 创建的目录权限固定,容器以非 root 用户运行时可能写不进去

数据来源与参考

  • Kubernetes 官方文档 · Volumes(hostPath)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌