### 如何使用 Node.js 获取 Docker 容器的资源使用情况 要通过 Node.js 获取 Docker 容器的 CPU、内存等资源使用情况，可以利用 Docker 提供的 API 或者通过 Docker 的命令行工具结合 Node.js 实现。以下是一个详细的实现方法。 #### 使用 Docker API 获取容器资源使用情况 Docker 提供了 RESTful API，允许开发者查询容器的状态信息，包括 CPU 和内存的使用情况。可以通过 `docker stats` 命令或者直接访问 Docker API 来获取这些数据。 1. **安装 Dockerode** Dockerode 是一个用于与 Docker 守护进程交互的 Node.js 模块。可以通过 npm 安装： ```bash npm install dockerode ``` 2. **代码示例：获取容器资源使用情况** 以下代码展示了如何使用 Dockerode 获取指定容器的资源占用情况： ```javascript const Docker = require('dockerode'); const docker = new Docker(); // 获取所有容器的统计信息 async function getContainerStats() { const containers = await docker.listContainers(); for (const container of containers) { const containerInstance = docker.getContainer(container.Id); const statsStream = await containerInstance.stats({ stream: false }); console.log(`Container ID: ${container.Id}`); console.log('Resource Usage:'); console.log(statsStream); } } getContainerStats(); ``` 上述代码中，`stats` 方法返回的是一个流对象，包含容器的实时资源使用情况。如果设置 `stream: false`，则会返回当前的快照数据[^1]。 3. **解析返回的数据** 返回的 JSON 数据中包含以下关键字段： - `cpu_stats`: 包含 CPU 使用情况。 - `memory_stats`: 包含内存使用情况。 - `blkio_stats`: 包含磁盘 I/O 使用情况。 示例输出片段： ```json { "cpu_stats": { "cpu_usage": { "total_usage": 123456789 }, "system_cpu_usage": 987654321 }, "memory_stats": { "usage": 1048576, "limit": 1073741824 } } ``` #### 使用 Shell 命令结合 Node.js 如果不想依赖 Dockerode，也可以通过执行 `docker stats` 命令并解析其输出来获取资源使用情况。 1. **代码示例：使用 `child_process` 执行命令** ```javascript const { exec } = require('child_process'); function getDockerStats(callback) { exec('docker stats --no-stream', (error, stdout, stderr) => { if (error) { console.error(`Error executing command: ${error.message}`); return callback(error); } if (stderr) { console.error(`Stderr: ${stderr}`); return callback(new Error(stderr)); } console.log('Docker Stats Output:'); console.log(stdout); callback(null, stdout); }); } getDockerStats((err, result) => { if (err) { console.error('Failed to retrieve Docker stats.'); } else { console.log('Successfully retrieved Docker stats.'); } }); ``` 上述代码通过 `docker stats --no-stream` 命令获取一次性统计信息，并将其输出到控制台[^4]。 #### 注意事项 - 确保运行 Node.js 应用程序的环境具有访问 Docker 守护进程的权限。通常需要将 Docker 套接字 `/var/run/docker.sock` 挂载到容器中。 - 如果在生产环境中使用，建议遵循最佳安全实践，例如限制对 Docker API 的访问权限[^5]。 --- ###