
在 Eclipse Che 中运行 Delve(dlv)调试 Go 程序时出现 “operation not permitted” 错误,根本原因在于容器缺乏 CAP_SYS_PTRACE 等必要能力;仅对 Che 主容器使用 --privileged 无效,需通过环境变量 CHE_DOCKER_PRIVILEGED=true 启用工作区容器的特权模式。
在 eclipse che 中运行 delve(dlv)调试 go 程序时出现 “operation not permitted” 错误,根本原因在于容器缺乏 `cap_sys_ptrace` 等必要能力;仅对 che 主容器使用 `--privileged` 无效,需通过环境变量 `che_docker_privileged=true` 启用工作区容器的特权模式。
Delve 依赖 Linux 的 ptrace 系统调用实现进程调试,而默认 Docker 容器因安全限制被剥夺了 CAP_SYS_PTRACE 能力,导致执行 dlv debug main.go 时抛出:
could not launch process: fork/exec /projects/desktop-go-simple/debug: operation not permitted
⚠️ 注意:问题不在 Che 主服务容器(即你用 docker run --privileged 启动的那个),而在于 Che 动态创建的工作区容器(workspace container)——Delve 正是在该容器内运行并尝试调试 Go 进程。因此,向 Che CLI 容器添加 --privileged 标志完全无效。
✅ 正确解决方案是启用 Che 工作区容器的特权模式,方法如下:
Eclipse IDE 是一款由 Eclipse 基金会管理的开源、跨平台集成开发环境。其核心基于 Java 构建,通过强大的插件架构可扩展支持 C/C++、Python、PHP 等多种编程语言。它提供丰富的代码编辑、调试和重构工具,并紧密集成 Git、Maven 等现代开发工具链,是全球众多开发者首选的 Java 开发利器。
- 编辑 Che 数据目录(挂载至
/data)下的che.env文件(若不存在则新建); - 添加以下行并保存:
CHE_DOCKER_PRIVILEGED=true
- 重启 Che 服务(如已运行,先
eclipse/che stop再start); - 重新打开工作区,进入终端,确认权限生效:
# 在工作区终端中检查是否可 ptrace(Delve 依赖) cat /proc/1/status | grep CapBnd # 应包含 0000000000000400(对应 CAP_SYS_PTRACE) dlv debug main.go # 此时应正常启动调试会话
? 补充说明:
-
CHE_DOCKER_PRIVILEGED=true会使 Che 在启动每个工作区容器时自动添加--privileged参数,从而赋予其完整 capabilities(包括CAP_SYS_PTRACE,CAP_SYS_ADMIN等); - 若仅需最小权限,高级用户可改用
CHE_DOCKER_CAP_ADD=SYS_PTRACE(需 Che ≥7.50+),但兼容性和稳定性不如CHE_DOCKER_PRIVILEGED=true; - 生产环境中启用特权模式需评估安全影响,建议仅在可信开发环境中使用。
完成配置后,Delve 即可正常编译、注入调试符号并 attach 到目标进程,Eclipse Che 的 Go 开发调试流程将完全可用。

















