0

0

K3s 使用 hostPath 卷的 pod 重启后数据丢失或权限不对

舞夢輝影

舞夢輝影

发布时间:2026-01-19 16:36:15

|

526人浏览过

|

来源于php中文网

原创

K3s中hostPath卷数据“丢失”或权限异常,主因是宿主机路径未预创建、UID/GID不匹配、挂载于临时目录被清理,或多个Pod共享同一hostPath导致冲突;应手动创建并设置正确权限与属主,避免临时路径,单实例场景下锁定节点调度。

k3s 使用 hostpath 卷的 pod 重启后数据丢失或权限不对

K3s 中使用 hostPath 卷的 Pod 重启后数据“丢失”或权限异常,通常不是数据真被删了,而是挂载路径未就绪、权限不匹配、或 K3s 节点重启导致宿主机目录状态变化所致。核心问题在于 hostPath 完全依赖宿主机文件系统状态,而 K3s(尤其单节点轻量部署)默认不保证该路径的自动创建与属主初始化。

宿主机路径未提前创建或属主错误

hostPath 不会自动创建父目录,也不会修改已有目录的权限和属主。若 Pod 启动时路径不存在,Kubernetes 会创建一个空目录,但属主为 root:root,且 umask 可能导致非 root 容器进程无写权限。

  • 手动创建挂载路径,并设为容器内进程所需的 UID/GID(例如 MySQL 常用 999,Nginx 常用 101):
    sudo mkdir -p /var/lib/myapp/data
    sudo chown 999:999 /var/lib/myapp/data
    sudo chmod 755 /var/lib/myapp/data
  • 避免使用 type: DirectoryOrCreate —— 它只建目录,不设权限;优先用 Directory 并确保路径已预置。

Pod 重启时容器用户与宿主目录 UID 不一致

容器镜像中应用常以非 root 用户运行(如 USER 999),但宿主机目录若属主是 root 或其他 UID,就会因 Linux 文件权限机制拒绝写入,表现为“数据没保存”或日志报 Permission denied

MaxAI
MaxAI

MaxAI.me是一款功能强大的浏览器AI插件,集成了多种AI模型。

下载
  • 查清容器内实际运行 UID:
    kubectl exec -- id -u
  • securityContext 中显式指定 runAsUser,并与宿主目录属主对齐:
    securityContext:
    runAsUser: 999
    fsGroup: 999

    fsGroup 确保挂载卷内文件组权限自动适配)

K3s 节点重启后 hostPath 路径被清理或变更

K3s 默认将数据存于 /var/lib/rancher/k3s,但用户自定义的 hostPath 若放在 /tmp/run 或某些 systemd-tmpfiles 清理路径下,节点重启后目录会被清空,造成“数据丢失”假象。

  • 严格避免将 hostPath 指向临时目录(/tmp/var/run/dev/shm 等)。
  • 推荐路径:固定位置如 /opt/myapp/data/srv/myapp/var/lib/myapp,并确保该路径不在任何自动清理策略范围内。
  • 检查是否被 systemd-tmpfiles 清理:
    systemd-tmpfiles --dry-run --verbose | grep "/tmp\|/run"

多副本 Pod 共享同一 hostPath 的风险

若多个 Pod 副本(尤其带 replicas > 1)挂载同一个 hostPath,它们会同时读写同一目录,极易引发数据损坏、覆盖或锁冲突——这不是 K3s 特有,而是 hostPath 的设计限制。

  • 不要在 Deployment 中对有状态服务使用共享 hostPath;应改用 StatefulSet + local PersistentVolume 或外部存储(如 NFS、Longhorn)。
  • 仅当明确是单实例、且无需高可用时,才用 hostPath;此时建议配合 nodeSelector 锁定到特定节点,防止调度漂移。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

663

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

246

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

281

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

514

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

253

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

386

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

529

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

599

2023.08.14

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 801人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号