讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

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

大浩君_2271

大浩君_2271

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

|

881人浏览过

|

来源于php中文网

原创

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

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

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

必须通过 --storage-driver 或 --graph 配合插件注册机制,但注意:Docker 20.10+ 默认禁用非内置驱动,外部存储插件(如 zfs、btrfs、自定义 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 install 报 failed to get plugin config: invalid character,基本是 JSON 缩进用了 tab、末尾多逗号、或字段名拼错(比如写成 Capabilty)

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

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

  • 检查插件日志:用 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 的 ExecStopPost 里 rm -f /run/docker/plugins/*.sock。

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

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

2295

2023.08.07

json是什么
json是什么

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

3742

2023.08.23

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

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

1236

2023.10.13

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

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

4339

2025.09.10

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

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

1898

2023.08.03

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

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

3104

2023.09.04

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

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

6344

2023.10.24

字符串介绍
字符串介绍

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

6389

2023.11.24

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn