# 03-07-k3s 使用 NFS 存储

> 本文只讲 K3s 集群侧如何使用已安装好的 NFS。

## 前置条件

- 已完成 `01-05-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`