根本原因是容器缺少 cap_sys_ptrace 和 cap_sys_admin 能力，phpEnv 编译、调试、挂载等操作依赖这些系统调用，而默认 Docker 容器严格限制；需通过 --cap-add=SYS_PTRACE --cap-add=SYS_ADMIN 启动容器，而非直接使用 --privileged。
直接说结论：phpEnv 在 Docker 容器里报 Operation not permitted，根本不是 phpEnv 本身的问题，而是容器缺少执行系统调用所需的 Linux capability（能力），尤其是 cap_sys_ptrace 和 cap_sys_admin —— 这俩是调试、进程注入、动态加载扩展等操作的硬性依赖。
为什么 phpEnv 会触发 Operation not permitted？
phpEnv 是一个用于快速切换 PHP 版本和扩展的本地环境工具，它底层依赖 ptrace（如调试器）、mount（挂载临时 overlayfs 或 bind mount）、unshare（用户命名空间隔离）等系统调用。这些操作在默认 Docker 容器中被严格限制。
常见触发场景包括：
- 运行
phpenv install 8.2.10时卡在 configure 阶段，报configure: error: cannot run C compiled programs或直接Operation not permitted - 执行
phpenv rehash后提示sh: ptrace: Operation not permitted - 启用 xdebug 或其他需 JIT/ptrace 的扩展时，PHP 启动失败并抛出权限错误
不推荐但最简单的解法：加 --privileged
加 --privileged 能立刻让 phpEnv 正常工作，但它等于把整个容器变成“root on host”，绕过所有 namespace/cgroups/capability 隔离，生产环境绝对禁用，CI/开发机也应避免。
立即学习“PHP免费学习笔记（深入）”；
如果你只是临时验证或本地单机调试，可以这样启动：
docker run -it --privileged -v $(pwd):/work -w /work php:8.2-cli bash
然后在容器内装 phpEnv、编译 PHP —— 大概率一次成功。但请记住：--privileged 是权限黑洞，不是解决方案，是绕过问题。
真正可控的修复：按需添加 capability
phpEnv 最关键的两个缺失 capability 是：
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
-
cap_sys_ptrace：用于调试、strace、xdebug、gdb、以及某些 PHP 扩展构建时的检测逻辑 -
cap_sys_admin：用于 mount/unshare/mknod 等操作，phpEnv 编译时创建临时 chroot 或 overlay 挂载会用到
启动容器时显式添加即可：
docker run -it \ --cap-add=SYS_PTRACE \ --cap-add=SYS_ADMIN \ -v $(pwd):/work -w /work \ php:8.2-cli bash
注意大小写：SYS_PTRACE 和 SYS_ADMIN 是 Docker 内部 capability 名，不是小写形式。漏掉任一都会在不同阶段报 Operation not permitted。
如果你用 docker-compose.yml，对应写法是：
cap_add: - SYS_PTRACE - SYS_ADMIN
Alpine 镜像下额外要注意：musl + apk 权限链断裂
phpEnv 在 Alpine（比如 php:8.2-cli-alpine）上更容易失败，原因有二：
- Alpine 默认用 musl libc，部分 configure 脚本对
ptrace行为检测更敏感 - apk 包管理器在非 root 用户下无法写
/usr/lib或/usr/include，而 phpEnv 编译时可能尝试写入这些路径
解决办法不是换镜像，而是提前补全构建依赖并确保用户权限：
apk add --no-cache \ autoconf \ automake \ build-base \ curl \ git \ libtool \ linux-headers \ make \ openssl-dev \ pcre2-dev \ sqlite-dev \ zlib-dev
并且确认你当前用户在容器内是 root（别用 --user 启动），否则 phpenv install 会在 make install 阶段因无法写入 /opt/phpenv/versions/... 报 Operation not permitted。
复杂点在于：phpEnv 不是标准 Docker 工具，它没针对容器场景做适配；Operation not permitted 看似统一，背后可能是 ptrace、mount、chroot、mknod 中任意一个失败。真正要稳定用，得结合 --cap-add、基础依赖、用户身份、以及镜像 libc 类型四者一起看——少一个，都可能在某个编译步骤突然崩掉。
