You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在外置硬盘等非主目录位置通过Colima正常运行Ddev

问题根因

报错由两个默认配置的适配问题触发:

  • Colima默认只自动挂载用户主目录下的路径,外置硬盘不在默认挂载范围内,容器无法读取外置盘上的项目文件、以及对应映射的ddev全局脚本
  • ddev默认把全局命令、配置存在~/.ddev目录下,项目放到外置盘后,默认挂载规则没法把全局命令目录正确映射到容器内的/mnt/ddev_config路径,就会触发找不到drush脚本的错误
配置步骤

按以下操作调整后即可让ddev完全在外置硬盘正常运行:

1. 给Colima添加外置硬盘挂载权限

先停掉当前运行的Colima实例:
colima stop
启动Colima时额外加上挂载参数,把你的外置硬盘、ddev全局目录都设为可读写挂载。macOS下外置盘默认挂载在/Volumes路径下,把下面命令里的your-external-drive替换成你自己的外置盘实际名称即可:
colima start --mount "/Volumes/your-external-drive:w" --mount "$HOME/.ddev:w"

参数里的:w代表给挂载路径开读写权限,必须添加,否则ddev没法正常写入配置、存储站点上传文件。
要永久生效的话,直接把这两个挂载规则写到Colima的配置文件里,不用每次启动都手动加参数。

2. (可选)把ddev全局数据迁移到外置盘

如果要实现ddev全量数据(配置、数据库缓存、镜像、命令脚本)都存在外置盘,不占用内置硬盘空间,就在你用的shell配置文件(zsh对应~/.zshrc,bash对应~/.bashrc)里加一行环境变量:

export DDEV_GLOBAL_CONFIG=/Volumes/your-external-drive/.ddev-global

保存后执行source ~/.zshrc(对应你修改的配置文件路径)让环境变量生效,后续ddev所有全局数据都会存到你指定的外置盘目录里。

3. 重建项目容器

进入外置盘上的Drupal9项目目录,先清理之前生成的错误配置容器:
ddev delete -Oy
重新走配置、启动流程:

ddev config
ddev start

启动完成后再执行Drupal安装的drush命令就不会再报找不到文件的错误。

避坑提示
  • 外置盘的项目路径不要带空格、中文或者特殊字符,否则很容易出现挂载识别失败的问题
  • 如果重启后再次出现同类报错,先执行colima ssh进入Colima虚拟机,执行ls /Volumes/your-external-drive确认能看到外置盘里的文件,说明挂载正常,否则重新检查挂载参数
  • 不要加sudo运行ddev相关命令,会导致路径权限错乱,触发新的访问报错

内容的提问来源于stack exchange,提问作者ancient_bonus

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 11:01:07