执行graphcool-framework local up时Docker bridge插件未找到问题求助

你碰到的这个报错，核心原因是Docker 18.03.0-ce的插件系统已经过时了。这个版本还在使用官方早已废弃的v1插件注册表，而Graphcool本地启动时依赖的bridge网络插件早就从这个旧注册表中移除了。另外，旧版本Docker的默认网络配置逻辑和Graphcool的期望不匹配，导致它尝试去调用一个不存在的插件，进而抛出这个错误。

我整理了几个可行的方案，按优先级推荐：

方案1：升级Docker到新版本（最推荐） #

Docker 18.03是2018年的版本，已经非常老旧了。后续版本（比如20.10及以上）完全重构了插件系统，默认的bridge网络是内置组件，根本不需要从外部插件注册表获取。升级步骤：

• 根据你的操作系统（Ubuntu/CentOS/macOS等）执行对应命令卸载旧版本Docker
• 安装最新的稳定版Docker，完成后重启Docker服务
• 再执行graphcool-framework local up，问题应该就能解决

方案2：手动重建默认bridge网络（临时 workaround） #

如果暂时没法升级Docker，可以尝试手动重建默认的bridge网络，绕过插件调用的问题：

1. 先停止所有运行中的容器：

   docker stop $(docker ps -aq)
   

2. 删除现有的bridge网络（如果存在）：

   docker network rm bridge
   

3. 重新创建默认的bridge网络：

   docker network create --driver bridge bridge
   

4. 重新执行Graphcool的启动命令：

   graphcool-framework local up
   

方案3：检查Graphcool框架版本 #

确保你使用的Graphcool版本和Docker 18.03兼容。有些旧版Graphcool可能针对旧Docker做了适配，如果你不想升级Docker，可以尝试降级Graphcool到对应兼容的版本（比如查看Graphcool的历史版本发布说明），不过这个方案优先级最低，因为升级Docker能解决更多潜在问题。

内容的提问来源于stack exchange，提问作者P3P5