sbx/paperclip-image

镜像概述

sbx/paperclip-image 是专为Docker AI沙箱设计的Paperclip代理管理套件基础镜像，基于官方docker/sandbox-templates:claude Code镜像构建，默认以非根agent用户身份运行，内置预配置的启动入口，开箱即可运行Paperclip服务。

核心功能

1. 内置适配Claude Code运行环境，支持Paperclip的claude_local适配器调用
2. 预装Node 22版本，满足Paperclip的版本依赖要求
3. 全局安装固定版本的paperclipai组件，包含@paperclipai/server服务、编译完成的React UI界面以及sharp预构建资源
4. 提供系统级预装的PostgreSQL服务，规避沙箱微虚拟机16KB页内核下arm64架构嵌入式PostgreSQL二进制加载失败的问题
5. 自带默认启动入口/usr/local/bin/paperclip-start，自动执行初始化引导并启动服务

使用场景

• Docker AI沙箱环境中快速部署Paperclip代理管理套件
• 本地AI代理开发调试场景下的标准化运行环境搭建
• 多架构兼容的Paperclip服务容器化部署

配置说明

镜像默认执行用户为非根agent，默认启动命令为/usr/local/bin/paperclip-start，启动流程会自动执行paperclipai onboard --yes完成初始化后启动服务。若需要自定义启动逻辑，可覆盖入口点指令。

部署示例

docker run 方式

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/sbx/paperclip-image

docker-compose 方式

yaml
version: "3.8"
services:
  paperclip:
    image: docker.xuanyuan.run/sbx/paperclip-image
    ports:
      - "8080:8080"
    restart: unless-stopped

关联完整套件镜像可访问docker.io/sbx/paperclip-kit获取。