跳到主内容
智客 ZICQ

技能库 智客分类:运维与云 docker-storage

Docker Storage

Guidance for Docker storage and data persistence. Covers storage types (Volume/Bind Mount/Tmpfs) with comparison and use-case selection, volume lifecycle management (create/ls/inspect/prune), bind mount patterns, tmpfs for ephemeral data, backup and restore strategies, storage driver selection (overlay2), database persistence best practices (PostgreSQL/MySQL/Redis), and NFS/cloud storage integration. Use when the user asks about docker volume, data persistence, bind mount, tmpfs, storage driver, backup, data volume, or needs persistent storage for containers. 使用场景:docker volume、数据持久化、bind mount、tmpfs、存储驱动、数据卷、备份恢复、数据库持久化.

82 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

Docker存储和数据持久性指导. 覆盖存储类型(Volume/Bind Mount/Tmpfs),包括比较和使用大小写选择、总量生命周期管理(创建/ls/inspect/prune)、绑定挂载模式、平面数据tmpfs、备份和恢复策略、存储驱动程序选择(overlay2)、数据库持久性最佳做法(PostgreSQL/MySQL/Redis)和NFS/cloud存储集成

何时用

** 用户提到时总是使用这种技能:**

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Docker Storage — 存储与数据持久化、When to Use、Storage Type Comparison、Visual Comparison、Volume Management、Create & inspect。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。

Docker Storage — 存储与数据持久化When to UseStorage Type ComparisonVisual ComparisonVolume ManagementCreate & inspectUse in containerCleanupNamed vs Anonymous VolumesBind MountRead-write bind mountRead-only (protect host files)

· 许可:Apache-2.0

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
docker-storage
description
Guidance for Docker storage and data persistence. Covers storage types (Volume/Bind Mount/Tmpfs) with comparison and use-case selection, volume lifecycle management (create/ls/inspect/prune), bind mount patterns, tmpfs for ephemeral data, backup and restore strategies, storage driver selection (overlay2), database persistence best practices (PostgreSQL/MySQL/Redis), and NFS/cloud storage integration. Use when the user asks about docker volume, data persistence, bind mount, tmpfs, storage driver, backup, data volume, or needs persistent storage for containers. 使用场景:docker volume、数据持久化、bind mount、tmpfs、存储驱动、数据卷、备份恢复、数据库持久化.
许可
Apache-2.0
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「docker-storage」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-528f2fa25d912585-%E5%B5%8C%E5%85%A5%E5%99%A8%E5%AD%98%E5%82%A8.html
请存为 .cursor/skills/docker-storage/SKILL.md 或 .claude/skills/docker-storage/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/full-stack-skills/docker-skills' --list

npx skills add 'https://github.com/full-stack-skills/docker-skills' --skill 'docker-storage'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: docker-storage description: Guidance for Docker storage and data persistence. Covers storage types (Volume/Bind Mount/Tmpfs) with comparison and use-case selection, volume lifecycle management (create/ls/inspect/prune), bind mount patterns, tmpfs for ephemeral data, backup and restore strategies, storage driver selection (overlay2), database persistence best practices (PostgreSQL/MySQL/Redis), and NFS/cloud storage integration. Use when the user asks about docker volume, data persistence, bind mount, tmpfs, storage driver, backup, data volume, or needs persistent storage for containers. 使用场景:docker volume、数据持久化、bind mount、tmpfs、存储驱动、数据卷、备份恢复、数据库持久化. license: Apache-2.0

Docker Storage — 存储与数据持久化

Comprehensive guidance for managing persistent data in Docker.

When to Use

ALWAYS use this skill when the user mentions:

  • "docker volume", "数据卷", "数据持久化"
  • "bind mount", "tmpfs"
  • "容器数据怎么保存", "数据不丢失"
  • "数据库容器怎么持久化"
  • "备份恢复", "存储驱动"

Storage Type Comparison

| Type | Persistence | Performance | Use Case | |------|:--:|:--:|------| | Volume | ✅ (managed by Docker) | High (native) | Production databases, shared data | | Bind Mount | ✅ (host filesystem) | High | Development (live code sync), config files | | Tmpfs | ❌ (memory only) | Highest | Secrets, temp files, sensitive data |

Visual Comparison

Volume:                       Bind Mount:               Tmpfs:
  Container                     Container                 Container
     │                              │                        │
  Docker-managed               /host/path                 Memory only
  /var/lib/docker/volumes/        ↕                     (no disk)
     ↕                         Container sees:              ↕
  Container sees:              /container/path           Container sees:
  /data                         = host files              /tmp (in RAM)

Volume Management

# Create & inspect
docker volume create mydata
docker volume ls
docker volume inspect mydata

# Use in container
docker run -v mydata:/var/lib/mysql mysql:8
docker run --mount source=mydata,target=/var/lib/mysql mysql:8  # explicit syntax (recommended)

# Cleanup
docker volume prune      # Remove unused volumes
docker volume rm mydata  # Remove specific volume

Named vs Anonymous Volumes

-v mydata:/data      → Named volume  (mydata) — survives container removal ✅
-v /data             → Anonymous volume — hard to identify later ❌

Bind Mount

# Read-write bind mount
docker run -v $(pwd)/app:/app nginx

# Read-only (protect host files)
docker run -v $(pwd)/config:/etc/nginx:ro nginx

# Explicit syntax
docker run --mount type=bind,source=$(pwd)/app,target=/app nginx

Tmpfs (Memory)

# Ephemeral data, never touches disk
docker run --tmpfs /tmp:rw,noexec,nosuid,size=64m nginx
docker run --mount type=tmpfs,destination=/tmp,tmpfs-size=64m nginx

Database Persistence Patterns

PostgreSQL

docker volume create pgdata
docker run -d \
  --name postgres \
  -e POSTGRES_PASSWORD=secret \
  -v pgdata:/var/lib/postgresql/data \
  -p 5432:5432 \
  postgres:16-alpine

MySQL

docker volume create mysqldata
docker run -d \
  --name mysql \
  -e MYSQL_ROOT_PASSWORD=secret \
  -v mysqldata:/var/lib/mysql \
  -v $(pwd)/my.cnf:/etc/mysql/conf.d/my.cnf:ro \
  -p 3306:3306 \
  mysql:8.4

Redis (Persistence)

docker volume create redisdata
docker run -d \
  --name redis \
  -v redisdata:/data \
  -p 6379:6379 \
  redis:7-alpine redis-server --appendonly yes

Backup & Restore

# Backup (using a temporary container)
docker run --rm \
  -v mysqldata:/source \
  -v $(pwd):/backup \
  alpine tar czf /backup/mysqldata-backup.tar.gz -C /source .

# Restore
docker run --rm \
  -v mysqldata:/target \
  -v $(pwd):/backup \
  alpine tar xzf /backup/mysqldata-backup.tar.gz -C /target

Storage Drivers

| Driver | Status | Notes | |--------|:--:|------| | overlay2 | ✅ Default | Best for most use cases; copy-on-write | | devicemapper | Deprecated | - | | aufs | Deprecated | - | | btrfs/zfs | Niche | Use if filesystem matches |

docker info | grep "Storage Driver"  # Check current

Workflow — 推荐配置流程

Step 1: 确定存储类型: 持久化数据 → Volume;开发热加载 → Bind Mount;临时缓存 → tmpfs Step 2: 创建 Volume: docker volume create db_data Step 3: 挂载到容器: docker run -v db_data:/var/lib/mysql mysql Step 4: 验证: docker volume inspect db_data + docker exec mysql ls /var/lib/mysql Step 5: 备份: docker run --rm -v db_data:/source -v $(pwd):/backup alpine tar czf /backup/db.tar.gz -C /source .

Gotchas — Common Pitfalls

  • Anonymous volumes accumulate: Every -v /data (no name) creates a new anonymous volume. → Recovery: docker volume prune cleans all unused; use named volumes: -v mydata:/data.
  • Bind mount paths: Must be absolute. → Recovery: -v $(pwd)/app:/app for docker run; -v ./app:/app works in Compose only.
  • Permission issues with bind mounts: Container UID != host UID → permission denied. → Recovery: --user $(id -u):$(id -g) or RUN chown 1000:1000 /data in Dockerfile entrypoint.
  • Data loss on container removal: Without -v, data is lost when container is removed. --rm flag even worse. → Recovery: Always use named volumes: docker run -v db_data:/var/lib/mysql.
  • macOS bind mount performance: Bind mounts on Docker Desktop Mac are slow. → Recovery: Use :cached or :delegated mount options, or named volumes for better I/O.

Boundary — 能力边界(适用与不适用场景)

| 分类 | 场景 | 说明 | |------|------|------| | ✅ 能做 | 数据持久化配置(Volume/Bind Mount/tmpfs) | 三类存储的创建、挂载、管理 | | ✅ 能做 | 备份与恢复 | tar + --volumes-from 备份恢复 | | ✅ 能做 | 存储驱动选型 | overlay2/btrfs/zfs 对比 | | ⚠️ 需条件 | NFS/云存储 Volume 驱动 | 需安装对应驱动插件 | | ⚠️ 需条件 | macOS 下 Bind Mount 性能 | 使用 :cached/:delegated 或命名 Volume | | ❌ 超范围 | K8s PersistentVolume/PVC | 使用 docker-production + K8s 文档 | | ❌ 超范围 | 分布式文件系统(Ceph/GlusterFS) | 系统管理员范畴 | | ❌ 超范围 | 数据库性能优化 | DBA 专业领域 |

When NOT to Use This Skill

| ❌ Skip | ✅ Use Instead | |---------|---------------| | Running containers (no data concerns) | docker-run | | Multi-container orchestration | docker-compose | | Kubernetes Storage (PV/PVC) | K8s documentation | | Docker basics | docker-basics |

Security & Stability

  • Use :ro for config files that containers should not modify.
  • Never bind mount Docker socket (/var/run/docker.sock) without understanding the security implications.
  • Backup volumes regularly, especially database volumes.
  • No executable scripts bundled. Guidance only.

📚 官方文档参考

| 文档 | 地址 | |------|------| | Docker 存储 | https://docs.docker.com/storage/ | | Volumes | https://docs.docker.com/storage/volumes/ | | Bind Mounts | https://docs.docker.com/storage/bind-mounts/ | | tmpfs | https://docs.docker.com/storage/tmpfs/ | | 存储驱动 | https://docs.docker.com/storage/storagedriver/ | | docker volume 命令 | https://docs.docker.com/reference/cli/docker/volume/ |

🧭 Docker Skills Journey

📍 You are here: docker-storage — 数据持久化

← Previous: docker-run / docker-networking → Next: docker-compose / docker-security

FAQ

Q1: 如何快速上手此技能? A: 参考上方的快速开始章节,按步骤操作即可。

Q2: 遇到版本不兼容问题怎么办? A: 检查依赖版本,使用 lock 文件锁定,参考常见陷阱章节。

Q3: 如何在生产环境使用? A: 参考最佳实践章节,确保配置正确,做好监控和日志。

Q4: 性能如何优化? A: 参考性能优化相关文档,使用缓存、索引等手段。

Q5: 如何贡献或反馈问题? A: 在 GitHub 仓库提交 Issue 或 Pull Request。

Q6: 是否支持中文? A: 支持中文文档和中文注释,详见国内适配章节。

相关技能

运维与云

Docker Essentials

用于容器管理,图像操作,调试的基本道克命令和工作流程.

运维与云

Find Skills

从开放的代理技能生态系统中发现并安装技能. 使用时:(1)用户问"我如何做X",X可能拥有现有技能,(2)用户说"为X找到技能"或"是否为X有技能",(3)用户问"你能否做X",X是专门能力,(4)用户想扩展代理能力,(5)用户想搜索工具,模板,或工作流程,(6)用户提到他们希望…

运维与云

Microsoft Foundry

构建,部署,评价,优化,微调,管理微软创始代理,模型,资源最终结束. 用法:铸造、azd ai代理、azd 提供/部署、托管代理脚手架/开发/运行/部署/拖放、即时代理创建、创建代理、更新代理、添加代理工具、援引代理、代理.yaml、评估代理、批量活化、连续活化、持续监测、代理C…

运维与云

Azure Deploy

执行已有.azure/部署计划.md和基础设施文件的ALREADY-PREPARED应用程序的Azure部署。 当用户向 CREATE 请求新应用程序时, 请不要使用此技能 。 这种技能运行了 azd上行, azd 部署, trarraform 应用, 和 az 部署命令带有内置…