0

0

DockerDaemon集成外部存储插件的配置流程

舞姬之光

舞姬之光

发布时间:2026-03-15 10:47:02

|

861人浏览过

|

来源于php中文网

原创

dockerd 不直接加载外部存储插件,而是通过监听 /run/docker/plugins/ 下符合权限(0660,root:docker)和命名规范的 Unix socket 及同级 .json 插件配置文件来发现插件;插件需预先启动、正确实现 RPC 接口并处理 Mountpoint 等字段。

dockerdaemon集成外部存储插件的配置流程

dockerd 启动时如何加载外部存储插件

必须通过 --storage-driver--graph 配合插件注册机制,但注意:Docker 20.10+ 默认禁用非内置驱动,外部存储插件(如 zfsbtrfs、自定义 overlay2 变体)实际依赖插件二进制 + Unix socket 注册,而非直接改 dockerd 参数。

  • dockerd 本身不“加载”插件二进制,而是监听 /run/docker/plugins/ 下的 socket 文件;插件需自行启动并监听该路径下的唯一 socket(如 /run/docker/plugins/my-storage.sock
  • 插件进程必须以 root 运行,且 socket 文件权限需为 0660,属主属组为 root:docker,否则 dockerd 拒绝连接
  • 启动顺序关键:先运行插件守护进程,再启动 dockerd;若 dockerd 先启,它只在初始化阶段扫描一次 /run/docker/plugins/,后续新增 socket 不会自动发现

插件 manifest 文件怎么写才被 dockerd 识别

插件必须提供 plugin-spec 格式的 plugin-config.json,放在插件 socket 同级目录下,命名必须是 <plugin-name>.json</plugin-name>(如 my-storage.json),否则 docker plugin ls 看不到。

  • manifest 中 Capability 字段必须包含 "volume""network",但存储类插件要生效,还得在 Interface 里明确声明 "Types": ["docker.volume"]
  • Entrypoint 不是必须的,但若指定,必须是绝对路径;相对路径或未设 Entrypoint 时,dockerd 会尝试执行插件 socket 所在目录的同名可执行文件(易出错)
  • 常见错误:docker plugin installfailed to get plugin config: invalid character,基本是 JSON 缩进用了 tab、末尾多逗号、或字段名拼错(比如写成 Capabilty

为什么 docker volume create --driver=my-storage 失败

绝大多数失败不是配置问题,而是插件实现没响应 GetCreate RPC 请求,dockerd 默认 5 秒超时后静默放弃。

Cutout.Pro抠图
Cutout.Pro抠图

AI批量抠图去背景

下载
  • 检查插件日志:用 journalctl -u my-storage-plugin 或插件自身日志路径,重点看是否收到 /VolumeDriver.Create 请求及返回状态码(必须是 HTTP 200 + JSON body)
  • 插件返回的 JSON body 必须含 Err 字段(即使为空字符串),缺这个字段会被 dockerd 当作协议错误丢弃
  • 不要在 Create 响应里返回绝对路径(如 "/var/lib/my-storage/vol-abc");dockerd 只认 Mountpoint 字段,且该路径需由插件确保已存在、可读写、且挂载上下文正确(例如 bind mount 的源路径必须真实存在)

CentOS 7 和 Ubuntu 22.04 上的兼容性差异

核心差异在 systemd socket 激活和 seccomp 默认策略,不是 Docker 版本问题。

  • CentOS 7 默认 systemd 版本低,不支持 SocketUser/SocketGroup,插件 socket 权限必须靠 ExecStartPost 脚本手动 chown root:docker,否则 dockerd 连不上
  • Ubuntu 22.04 默认启用 seccomp,插件若调用 mount(2)setns(2) 会被拦截;需在插件 service unit 里加 SystemCallFilter=@default @file-system @namespace 或禁用 seccomp(不推荐)
  • 两者都要求内核模块就绪:比如用 zfs 插件,zfs.ko 必须已加载,且 zpool list 能看到池;dockerd 不检查这个,插件自己得报错

最常被跳过的一步:插件进程退出后 socket 文件残留,导致新实例启动时 bind 失败,报 address already in use —— 要么加 RuntimeDirectoryMode=0755,要么在 service 的 ExecStopPostrm -f /run/docker/plugins/*.sock

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

457

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

549

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1570

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

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

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