基本框架

docs/03-06-k3s-使用nfs存储.md

@@ -0,0 +1,54 @@
+# 03-07-k3s 使用 NFS 存储
+
+> 本文只讲 K3s 集群侧如何使用已安装好的 NFS。
+
+## 前置条件
+
+- 已完成 `01-06-armv7-nfs服务安装.md`
+- 可从 K3s 节点访问 NFS 服务器与导出目录
+
+## 操作步骤
+
+1. 创建 NFS 类型 `PersistentVolume`
+2. 创建 `PersistentVolumeClaim`
+3. 在业务 Pod 中挂载 PVC
+
+**唯一真源**：[`ansible/files/nfs-demo/nfs-pv-pvc-demo.yaml`](../ansible/files/nfs-demo/nfs-pv-pvc-demo.yaml)（按你的 NFS `server` / `path` 修改）。
+
+## 验证命令（若 YAML 在 manifests 目录，按实际路径选择其一复制执行）
+
+```bash
+# 仓库根直接应用
+kubectl apply -f ansible/files/nfs-demo/nfs-pv-pvc-demo.yaml
+```
+
+```bash
+# 或默认路径（已拷贝到 manifests 时）
+kubectl apply -f /var/lib/rancher/k3s/server/manifests/nfs-pv-pvc.yaml
+kubectl get pv,pvc -A
+kubectl describe pv nfs-pv-demo
+```
+
+```bash
+# 自定义 data-dir（如 /storage）
+kubectl apply -f /storage/server/manifests/nfs-pv-pvc.yaml
+kubectl get pv,pvc -A
+kubectl describe pv nfs-pv-demo
+```
+
+## 预期
+
+- PV/PVC 状态为 `Bound`
+- 业务 Pod 可读写挂载目录
+
+## 失败排查
+
+- 检查 NFS 服务与导出目录权限
+- 检查节点到 NFS 服务器网络
+- 检查 `path` 与 `server` 配置是否正确
+
+## 下一步
+
+- `03-05-k3s-local-path-pvc.md`：单副本应用用 K3s 自带 local-path 即可，无需 NFS
+- `05-06-openlist挂载网盘与自动备份.md`
+