机制定位
hostPath 把节点上的一个路径直接挂进容器，例如 /var/log、/dev 或自定义数据目录。适用平台是 Kubernetes（Pod 的 volumes.hostPath）。它能访问节点本机资源，代价是没有隔离、没有容量控制、也没有跨节点一致性：Pod 被调度到别的机器后读写的是另一台机器上的目录。能用 local PV 或 CSI 替代时优先替代，hostPath 更适合采集类、设备类这类与节点强绑定的工作负载。
基本信息
| 适用平台 | Kubernetes，Pod 级卷类型 |
|---|---|
| 关键字段 | path 指定节点路径，type 指定校验/创建行为 |
| 常用 type | Directory、DirectoryOrCreate、FileOrCreate、Socket |
| 隔离性 | 无容量限制、无权限隔离，宿主机路径内容对外可见 |
典型使用场景
- 日志采集代理：读取节点的 /var/log 目录汇总日志
- 节点级指标或设备：访问 /dev、/sys 等特殊路径
- 节点本地缓存：把临时缓存放在节点目录上，容忍丢失
- 调试与运维：临时把宿主机文件挂进排查容器查看
- 与 DaemonSet 配合：每台节点都读自己的本地目录
hostPath 示例
hostPath 示例
volumes:
- name: varlog
hostPath:
path: /var/log
type: Directory
- name: data
hostPath:
path: /data/app
type: DirectoryOrCreate核对
核对
kubectl get pod web-x -o jsonpath='{.spec.volumes[*].hostPath}' # 声明的路径与类型
kubectl get pod web-x -o wide # 看落在哪个节点
kubectl exec -it web-x -- mount | grep -i log # 容器内挂载情况
kubectl exec -it web-x -- ls -l /var/log | head # 目录内容与权限常用 type
| type | 行为 | 失败表现 |
|---|---|---|
| Directory | 路径必须已存在且为目录 | 不存在时容器启动失败 |
| DirectoryOrCreate | 不存在则创建（0755、kubelet 属主） | 创建后容器非 root 用户可能写不进 |
| FileOrCreate | 不存在则创建空文件 | 父目录不存在时失败 |
| Socket | 路径必须是 unix socket | 不是 socket 时报错 |
hostPath 数据与节点绑定：Pod 漂移后读写的是另一台机器上的目录，且没有容量隔离，宿主机磁盘写满会连带影响节点上所有 Pod。
使用 hostPath 的工作负载建议配合 nodeAffinity 固定节点，避免调度漂移导致「数据忽然不见了」。
使用边界
- 确认业务能接受节点绑定：Pod 漂移后看到的是另一台机器的目录，不能当持久存储用
- 确认宿主机权限：容器以非 root 运行时要提前把目录属主与权限准备好
- 控制可挂载范围：宿主机的敏感路径与运行时 socket 应禁止出现在业务清单里
- 配套监控节点磁盘：hostPath 无容量隔离，写满会连带影响该节点上所有 Pod