应使用Docker容器化部署构建强隔离运行沙盒：一、多阶段构建精简镜像；二、用户命名空间映射实现权限隔离；三、只读根文件系统与受限能力集；四、独立持久化卷加SELinux约束；五、cgroup v2限制资源占用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在Qoder环境中运行存在兼容性风险或行为不可控的插件，直接集成可能导致主进程崩溃、记忆污染或权限越界，此时应借助Docker容器化部署构建强隔离运行沙盒。以下是实现该目标的具体操作路径：
一、基于多阶段构建创建精简插件运行镜像
通过分离构建与运行阶段，确保插件仅以二进制或预编译产物形式进入最终容器，杜绝源码残留与开发依赖暴露，同时限制其可调用的系统接口范围。
1、新建Dockerfile，声明构建阶段使用含完整工具链的镜像；
2、在构建阶段复制插件源码，执行编译/打包命令，生成独立可执行文件或wheel包；
3、切换至极简运行时镜像（如python:3.11-slim-bookworm），仅COPY上一阶段输出的dist目录及必要配置；
4、设置非root用户UID 1001并赋予最小文件权限；
5、使用ENTRYPOINT指定插件启动脚本，禁用shell扩展与交互式TTY。
二、启用用户命名空间映射实现宿主机权限隔离
避免插件容器以root身份访问宿主机资源，通过userns-remap机制将容器内root UID映射为宿主机上的非特权UID，即使插件突破容器边界也无法获得真实root权限。
1、在Docker daemon.json中添加：{"userns-remap": "default"}；
2、重启Docker服务使配置生效；
3、创建专用用户映射池：sudo useradd -r -u 20000 qoder-plugin-user；
4、修改/etc/subuid与/etc/subgid，为该用户分配10000个子UID/GID范围；
5、启动容器时显式指定--user 1001:1001，并挂载卷时使用chown -R 1001:1001 /host/mount/path。
三、配置只读根文件系统与受限能力集
强制容器以只读方式加载根文件系统，并显式剥夺CAP_SYS_ADMIN、CAP_NET_RAW等高危Linux能力，从内核层阻止插件执行挂载、原始套接字或系统调用劫持等危险操作。
1、构建镜像时在Dockerfile末尾添加：READONLY_ROOTFS=true；
2、运行容器时添加参数：--read-only --tmpfs /run --tmpfs /tmp --cap-drop=ALL；
3、仅按需添加必要能力：--cap-add=CAP_NET_BIND_SERVICE（若需绑定端口）；
4、禁用ProcFS写入：--security-opt=no-new-privileges；
5、验证容器内无法执行mount、iptables、strace等敏感命令。
四、挂载独立持久化卷并启用SELinux上下文约束
为插件分配专属命名卷，配合SELinux type enforcement限定其仅能读写指定标签路径，防止跨卷数据渗透或日志覆盖主系统关键路径。
1、创建带SELinux标签的卷：docker volume create --opt o=context="system_u:object_r:qoder_plugin_data_t:s0" plugin-data-vol；
2、启动容器时绑定该卷：-v plugin-data-vol:/app/data:z；
3、在容器内确认挂载点SELinux上下文：ls -Z /app/data；
4、编写SELinux策略模块，拒绝plugin_t域对etc_t、var_log_t等系统类型路径的write访问；
5、加载策略：sudo semodule -i qoder-plugin-te.pp。
五、通过cgroup v2限制插件资源占用上限
防止插件因内存泄漏或无限循环耗尽主机资源，利用cgroup v2对CPU时间片、内存页数及PID数量实施硬性限额，确保其异常行为不影响Qoder主服务稳定性。
1、确认宿主机启用cgroup v2：cat /proc/filesystems | grep cgroup2；
2、启动容器时设置内存上限：--memory=512m --memory-reservation=128m；
3、限制CPU使用率：--cpus="0.5" --cpu-quota=50000 --cpu-period=100000；
4、控制进程数量：--pids-limit=32；
5、验证cgroup路径下对应参数已写入：cat /sys/fs/cgroup/qoder-plugin/memory.max。
