docker system prune 是 Docker CLI 命令，非 Java 内置命令；Java 可通过 ProcessBuilder 或 docker-java SDK 调用，但需注意权限、安全参数（如 --dry-run）及清理边界（默认删已停容器、悬空镜像、孤立网络、构建缓存）。

docker system prune 不是 Java 的命令，它属于 Docker CLI 工具，运行在宿主机的终端中，与 Java 语言本身无关。Java 应用可以调用该命令（例如通过 Runtime.exec() 或 ProcessBuilder），但实际执行清理的是 Docker 守护进程，不是 JVM。所以问题核心其实是：如何在 Java 环境下安全、可控地触发 Docker 的 system prune 清理操作。

下面从实践角度分几块讲清楚：

如何在 Java 中调用 docker system prune

Java 本身不提供 Docker 操作能力，需借助系统命令或 SDK。推荐两种方式：

• 方式一：直接执行 shell 命令（轻量、适合脚本化运维）
  使用 ProcessBuilder 执行命令，更健壮（比 Runtime.exec() 更易处理参数和错误）：

  ProcessBuilder pb = new ProcessBuilder("docker", "system", "prune", "-f");
  pb.redirectErrorStream(true);
  try {
      Process p = pb.start();
      String output = new String(p.getInputStream().readAllBytes());
      System.out.println("清理结果：" + output);
  } catch (Exception e) {
      System.err.println("执行失败：" + e.getMessage());
  }

  ⚠️ 注意：

  立即学习“Java免费学习笔记（深入）”；

  • 必须确保运行 Java 进程的用户有 docker 命令权限（通常需加入 docker 用户组）；

  • -f 参数跳过确认，生产环境慎用，建议先加 --dry-run（Docker 24.0+ 支持）预览：

    ProcessBuilder pb = new ProcessBuilder("docker", "system", "prune", "--dry-run");

• 方式二：使用 Docker Java SDK（推荐用于服务集成）
  引入 docker-java 库（Maven）：

  <dependency>
      <groupId>com.github.docker-java</groupId>
      <artifactId>docker-java</artifactId>
      <version>3.4.0</version>
  </dependency>

  调用示例（注意：SDK 不直接封装 system prune，需调用 /system/prune API）：

  

  OpenClaw Docker Setup

  在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

  下载

  DockerClient docker = DockerClientBuilder.getInstance().build();
  PruneReport report = docker.pruneCmd()
      .withFilters(ImmutableMap.of("label", "env=dev")) // 可选过滤
      .exec();
  System.out.println("清理释放：" + report.getSpaceReclaimed() + " bytes");

  ✅ 优势：类型安全、可捕获结构化返回、支持超时/重试、便于与 Spring Boot 等框架集成。

怎样才算“安全”清理？

安全 ≠ 完全自动化，而是可控 + 可逆 + 可追溯。关键动作包括：

• 提前评估影响范围
  在执行前，用以下命令检查将删什么：

  docker system df -v        # 查看各资源占用与可回收量
  docker system prune --dry-run  # 预览（Docker ≥24.0）
  docker container ls -f status=exited  # 确认待删容器确实已停
  docker network ls --filter "driver=bridge" --format "{{.Name}}" | xargs -I{} docker network inspect {} 2>/dev/null | grep -q '"Containers":{}' && echo "孤立网络：{}"

• 避免误删的关键原则

  • ✅ 默认 docker system prune 不删：正在运行的容器、有标签的镜像、已挂载的卷、默认网络（bridge/host/none）；
  • ❌ 加 -a 会删所有未被引用镜像（含你手动 docker pull nginx:alpine 后没启动容器的镜像）；
  • ❌ 加 --volumes 会删所有未被容器使用的 volume（数据可能永久丢失，除非你确认这些卷是测试生成的临时卷）；
  • ? 自定义网络只删“无容器连接”的，不影响 docker-compose up/down 正常管理的网络。

• Java 中实现安全流程建议

  // 示例：带 dry-run 校验 + 人工确认环节
  if (isDryRunMode()) {
      runPruneCommand("--dry-run");
      System.out.println("请检查上述列表，确认无关键资源后，再运行正式清理。");
      return;
  }
  if (!userConfirmed("确认执行彻底清理？此操作不可逆！")) {
      return;
  }
  runPruneCommand("-f"); // 或加 -a/--volumes（按需）

清理对象到底包括哪些？

docker system prune（不含额外参数）默认清理四类孤立资源：

• 所有已停止（exited）的容器
• 所有悬空镜像（dangling images）：无标签、且不被任何镜像或容器引用的中间层（如 sha256:abc123...）
• 所有未被任何容器使用的自定义网络（docker network create mynet 创建的，非 bridge 等默认网络）
• 所有构建缓存（BuildKit 缓存或传统 builder cache）

? 补充说明：

• “废弃容器”即 docker ps -a 中状态为 Exited 的条目；
• “残留网络”指 docker network ls 中 DRIVER 为 bridge 但 SCOPE 为 local 且 CONTAINERS 列为 0 的网络；
• “孤立分层”就是 dangling images，它们是多阶段构建或反复 build 产生的冗余 layer，不占业务功能，纯属空间浪费。

基本上就这些。Java 只是调度者，真正干活的是 Docker；安全的核心在于理解 prune 的边界，而不是写多复杂的 Java 代码。