OpenClaw（龙虾）在Docker Compose怎么配置镜像源从零开始

2026-03-19 5

详情

报告

跨境服务

文章

引言

OpenClaw（龙虾）是一个开源的 Docker 镜像代理与缓存工具，常用于加速私有镜像拉取、统一管理镜像源、规避海外 registry 访问不稳定等问题。它本身不是平台、服务或 SaaS，而是一个可本地部署的轻量级代理服务；Docker Compose 是用于定义和运行多容器 Docker 应用的编排工具。

要点速读（TL;DR）

OpenClaw 不是官方镜像仓库，而是自建镜像代理中间件，需自行部署；
通过 docker-compose.yml 启动 OpenClaw 容器，并配置其上游 registry（如 docker.io、quay.io、ghcr.io）；
客户端需将 Docker daemon 的 registry-mirrors 指向 OpenClaw 服务地址（如 http://192.168.1.100:5000）；
配置核心在于 config.yaml + docker-compose.yml + Docker daemon.json 三者联动；
不涉及跨境平台规则、费用或资质，纯技术部署类操作。

它能解决哪些问题

场景痛点：国内服务器拉取 Docker Hub 镜像超时/限速 → 价值：OpenClaw 缓存并代理请求，显著提升拉取成功率与速度；
场景痛点：团队多台机器重复拉取同一镜像浪费带宽 → 价值：本地化镜像缓存，首次拉取后后续请求直走局域网；
场景痛点：需统一管控镜像来源（如禁止直连公网 registry）→ 价值：所有 Docker 客户端强制经 OpenClaw 转发，便于审计与策略拦截。

怎么用：从零配置 OpenClaw 镜像源（Docker Compose 方式）

以下为标准实操路径（基于 OpenClaw v0.8+，Linux 环境）：

准备配置文件：创建 config.yaml，定义 upstream registries（如 https://registry-1.docker.io）、监听地址、缓存路径等；
编写 docker-compose.yml：声明 OpenClaw 服务，挂载 config.yaml 和缓存卷（/var/lib/openclaw），开放端口（默认 5000）；
启动服务：执行 docker-compose up -d，确认容器运行且日志无 panic 错误；
验证代理可用性：用 curl http://localhost:5000/v2/ 或 curl -I http://localhost:5000/v2/library/nginx/manifests/latest 测试响应；
配置 Docker daemon：编辑 /etc/docker/daemon.json，添加 "registry-mirrors": ["http://<openclaw-host>:5000"]（注意：必须为 HTTP，不支持 HTTPS 自签证书直连）；
重启 Docker 并测试：执行 sudo systemctl restart docker，再运行 docker pull nginx，观察 OpenClaw 日志是否记录 pull 请求。

⚠️ 注意：OpenClaw 默认不启用认证，生产环境建议前置 Nginx 做 Basic Auth 或 IP 白名单控制。具体配置项以 GitHub 官方 config.example.yaml 为准。

费用/成本影响因素

部署环境资源消耗（CPU/内存/磁盘 I/O）：缓存镜像体积越大，磁盘占用越高；
网络带宽成本：作为代理节点，会承担上游 registry 下载流量与下游 client 分发流量；
运维复杂度成本：需自行监控服务健康、清理过期缓存、升级版本；
安全加固成本：若需满足等保或企业内网合规，需额外配置 TLS、鉴权、审计日志等。

为了拿到准确部署成本，你通常需要提供：预估并发拉取峰值、常用镜像数量与平均大小、是否要求高可用（多实例）、所在网络环境（VPC/IDC/混合云）。

常见坑与避坑清单

镜像拉取失败但 OpenClaw 日志无记录→ 检查 Docker daemon.json 是否生效（docker info | grep "Registry Mirrors"）及地址是否可被 daemon 进程访问（非 localhost）；
pull 时提示 "no basic auth credentials"→ OpenClaw 当前版本（v0.8）不透传 client 端 auth token，私有 registry 场景需改用 registry-proxy 或 harbor；
缓存目录写满导致服务异常→ 必须配置 cache.max_size 和 cache.gc_interval，并定期巡检磁盘；
跨主机访问不到 OpenClaw 服务→ 检查宿主机防火墙（ufw/iptables）、Docker network 模式（推荐 host 或显式 ports 绑定）及 bind 地址是否为 0.0.0.0。