cwspear/docker-local-persist-volume-plugin

Docker本地持久化卷插件

镜像概述

该插件是Docker的本地持久化卷驱动，解决默认local驱动删除卷时数据丢失的问题，允许用户创建指定存储位置的命名卷，支持容器间灵活挂载和数据持久化，适用于中小型项目的状态容器需求。

核心功能

1. 创建指定挂载路径的命名本地卷
2. 卷删除后数据仍保留在指定位置
3. 支持将同一卷挂载到不同容器的不同路径
4. 提供容器内/外两种运行方式（适配Linux、macOS、Windows）

使用场景

• 持久化数据库（如MySQL、PostgreSQL）数据
• 共享静态资源（图片、文件）给多个容器
• 保存应用配置文件或日志文件
• 需要跨容器共享数据且保持数据持久化的场景

配置说明

容器外运行（Linux）

快速安装

shell
curl -fsSL https://raw.githubusercontent.com/CWSpear/local-persist/master/scripts/install.sh | sudo bash

手动安装

1. 从https://github.com/CWSpear/local-persist/releases%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E7%B3%BB%E7%BB%9F%E6%9E%B6%E6%9E%84%E7%9A%84%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6
2. 重命名为docker-volume-local-persist并移动到/usr/bin
3. 赋予执行权限：chmod +x /usr/bin/docker-volume-local-persist
4. 设置Systemd服务自动启动（参考官方脚本）

容器内运行（macOS/Windows/Linux）

shell
docker run -d \
    -v /run/docker/plugins/:/run/docker/plugins/ \
    -v /var/lib/docker/plugin-data/:/var/lib/docker/plugin-data/ \
    -v /data/:/data/ \
    cwspear/docker-local-persist-volume-plugin

说明：

• /run/docker/plugins/：挂载插件socket路径
• /var/lib/docker/plugin-data/：持久化插件元数据（重启后恢复卷信息）
• /data/：指定卷数据存储的根路径（可添加多个路径）

使用示例

创建卷

shell
docker volume create -d local-persist -o mountpoint=/data/images --name=images

容器挂载卷

shell
docker run -d -v images:/app/images nginx
docker run -d -v images:/web/static/images php-fpm

Docker Compose示例（需Compose 1.6+）

yaml
version: '2'
services:
  web:
    image: nginx
    volumes:
      - images:/usr/share/nginx/html/images
  db:
    image: mysql
    volumes:
      - mysql_data:/var/lib/mysql
volumes:
  images:
    driver: local-persist
    driver_opts:
      mountpoint: /data/images
  mysql_data:
    driver: local-persist
    driver_opts:
      mountpoint: /data/mysql