### 关于 `com.github.docker-java` 的使用与配置 #### 1. 添加 Maven 或 Gradle 依赖 为了在 Java 项目中使用 `docker-java` 库，首先需要将其作为依赖引入到项目的构建工具中。 对于 **Maven** 用户，在 `pom.xml` 文件中添加以下内容： ```xml <dependency> <groupId>com.github.docker-java</groupId> <artifactId>docker-java</artifactId> <version>3.2.12</version> <!-- 版本号可以根据需求调整 --> </dependency> ``` 对于 **Gradle** 用户，在 `build.gradle` 文件中添加以下内容： ```gradle implementation 'com.github.docker-java:docker-java:3.2.12' // 版本号可根据实际需求更改 ``` 以上版本号为最新稳定版之一[^4]，具体版本可以参考官方文档或 Maven 中央仓库获取最新的可用版本。 --- #### 2. 配置 Docker 客户端连接 通过 `DockerClientBuilder` 创建客户端实例来管理 Docker API 调用。以下是基本的连接方式： ##### (a) 使用默认本地 Unix Socket 连接 如果 Docker Daemon 正常运行并监听本地 Unix 套接字，则可以直接初始化客户端而无需额外设置。 ```java import com.github.dockerjava.api.DockerClient; import com.github.dockerjava.core.DockerClientBuilder; public class DockerExample { public static void main(String[] args) { DockerClient dockerClient = DockerClientBuilder.getInstance().build(); try { String infoJson = dockerClient.infoCmd().exec().toString(); System.out.println("Docker Info: " + infoJson); } catch (Exception e) { e.printStackTrace(); } } } ``` ##### (b) 设置远程 TCP/IP 连接 当需要远程访问 Docker 主机时，可以通过修改 Docker 配置文件启用远程接口，并指定 IP 和端口地址（如 `tcp://0.0.0.0:2375`）。随后可以在代码中显式定义 URI 来建立连接。 ```java import com.github.dockerjava.api.DockerClient; import com.github.dockerjava.core.DockerClientBuilder; import java.net.URI; public class RemoteDockerConnection { public static DockerClient connectToRemoteDocker() { return DockerClientBuilder.getInstance(URI.create("http://your-docker-host-ip:2375")).build(); } public static void main(String[] args) { DockerClient remoteClient = connectToRemoteDocker(); try { System.out.println(remoteClient.infoCmd().exec()); } finally { remoteClient.close(); // 确保关闭资源释放 } } } ``` 上述示例展示了如何针对特定 URL 构建自定义化的 Docker Client 实例。 --- #### 3. 基础功能调用 基于已有的 Docker 客户端对象 (`DockerClient`) ，可执行多种常见的操作，例如查询信息、创建/启动容器以及处理镜像等。 - 获取 Docker 环境基本信息： ```java Info infoResponse = dockerClient.infoCmd().exec(); System.out.println(JSONObject.toJSONString(infoResponse)); // JSON 格式的输出便于解析 ``` - 列举当前存在的所有容器及其状态统计： ```java ListContainersCmd listCommand = dockerClient.listContainersCmd() .withShowAll(true); for(Container container : listCommand.exec()) { System.out.printf("ID=%s Name=%s Status=%s%n", container.getId(), container.getNames()[0], container.getStatus()); } ``` - 加载外部镜像至内部存储区： ```java Path imagePath = Paths.get("/path/to/image.tar"); try(InputStream imageStream = Files.newInputStream(imagePath)) { LoadImageResultCallback callback = new LoadImageResultCallback(); dockerClient.loadImageCmd(imageStream).exec(callback); } catch(IOException ex) { throw new RuntimeException(ex.getMessage(), ex); } ``` 这些基础方法覆盖了大部分日常开发场景下的需求[^3]。 --- #### 4. 注意事项 - 如果计划采用 HTTPS 方式的安全通信模式，请提前准备好 CA 证书链及相关密钥材料以便验证身份合法性。 - 对生产环境中涉及敏感数据的操作务必实施严格的权限控制策略，防止未授权行为发生。 - 不同操作系统平台下可能还需要安装额外的支持库或者驱动程序才能顺利完成某些高级特性支持工作。 ---