slug: docker-essentials name: docker-essentials version: 1.0.2 displayName: Docker核心操作指南 summary: 涵盖容器生命周期、镜像管理、Compose、网络、数据卷、系统管理等Docker核心操作。Docker核心操作指南，覆盖容器生命周期的完整管理流程. 包含容器调试、镜像构建与管理、Dock summary_zh: 涵盖容器生命周期、镜像管理、Compose、网络、数据卷、系统管理等Docker核心操作。Docker核心操作指南，覆盖容器生命周期的完整管理流程. 包含容器调试、镜像构建与管理、Dock license: MIT description: |-。涵盖容器生命周期、镜像管理、Compose、网络、数据卷、系统管理等Docker核心操作。Docker核心操作指南，覆盖容器生命周期的完整管理流程。Use when 需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于实时流数据处理。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。 功能涵盖: essentials。 包含容器调试、镜像构建与管理、Dock。支持自动化配置和灵活的参数设置，适适用于多种业务场景，提高工作效率和质量。。涵盖容器生命周期、镜像管理、Compose、网络、数据卷、系统管理等Docker核心操作。Docker核心操作指南，覆盖容器生命周期的完整管理流程. 包含容器调试、镜像构建与管理、Dock' tools:

• read
• exec
• write homepage: '' tags:
• 系统运维
• 容器
• Docker
• DevOps
• docker
• container_name
• bash
• docker-compose
• run category: Development homepage: "" pricing_tier: "L2-标准级"

功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

Docker核心操作指南

新手引导

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

涵盖容器生命周期、镜像管理、Compose、网络、数据卷、系统管理等Docker核心操作.

请求格式

环境要求

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力总览

容器生命周期管理（Container Lifecycle）

完整的容器创建、启动、停止、删除管理：

运行容器（Running containers）：

docker run nginx                              # 前台运行
docker run -d nginx                           # 后台运行
docker run --name my-nginx -d nginx           # 指定名称
docker run -p 8080:80 -d nginx                # 端口映射
docker run -e MY_VAR=value -d app             # 环境变量
docker run -v /host/path:/container/path -d app  # 卷挂载
docker run --rm alpine echo "Hello"           # 退出后自动删除
docker run -it ubuntu bash                    # 交互式终端

管理容器（Managing containers）：

docker ps                # 查看运行中容器
docker ps -a             # 查看所有容器（含已停止）
docker stop container_name    # 停止容器
docker start container_name   # 启动容器
docker restart container_name # 重启容器
docker rm container_name      # 删除已停止容器
docker rm -f container_name   # 强制删除容器
docker container prune        # 清理所有已停止容器

容器检查与调试（Container Inspection & Debugging）

查看日志、执行命令、检查容器状态：

查看日志（Viewing logs）：

docker logs container_name           # 查看全部日志
docker logs -f container_name        # 跟踪日志
docker logs --tail 100 container_name  # 最后100行
docker logs -t container_name        # 显示时间戳

执行命令（Executing commands）：

docker exec container_name ls -la              # 执行单条命令
docker exec -it container_name bash            # 交互式shell
docker exec -u root -it container_name bash    # 以root执行
docker exec -e VAR=value container_name env    # 带环境变量

检查（Inspection）：

docker inspect container_name                          # 完整信息
docker inspect -f '<动态配置>' container_name  # 提取IP
docker stats                  # 所有容器资源使用
docker stats container_name   # 指定容器资源使用
docker top container_name     # 容器内进程

镜像管理（Image Management）

构建、拉取、推送、清理镜像：

构建镜像（Building images）：

docker build -t myapp:1.0 .                          # 基本构建
docker build -f Dockerfile.dev -t myapp:dev .        # 指定Dockerfile
docker build --build-arg VERSION=1.0 -t myapp .      # 构建参数
docker build --no-cache -t myapp .                   # 不使用缓存

管理镜像（Managing images）：

docker images                # 列出镜像
docker pull nginx:latest     # 拉取镜像
docker tag myapp:1.0 myapp:latest  # 打标签
docker push myrepo/myapp:1.0      # 推送镜像
docker rmi image_name        # 删除镜像
docker image prune           # 清理悬空镜像
docker image prune -a        # 清理所有未使用镜像

Docker Compose

多容器应用编排与服务管理：

基本操作（Basic operations）：

docker-compose up            # 启动（前台）
docker-compose up -d         # 启动（后台）
docker-compose down          # 停止并删除
docker-compose down -v       # 同时删除卷
docker-compose logs          # 查看所有服务日志
docker-compose logs -f web   # 跟踪指定服务日志
docker-compose up -d --scale web=3  # 扩展服务实例数

服务管理（Service management）：

docker-compose ps            # 查看服务状态
docker-compose exec web bash # 在服务中执行命令
docker-compose restart web   # 重启服务
docker-compose build web     # 重新构建服务
docker-compose up -d --build # 重新构建并启动

网络配置（Networking）

管理Docker网络与容器互联：

docker network ls                            # 列出网络
docker network create mynetwork              # 创建网络
docker network connect mynetwork container_name   # 连接容器到网络
docker network disconnect mynetwork container_name  # 断开连接
docker network inspect mynetwork             # 查看网络详情
docker network rm mynetwork                  # 删除网络

数据卷管理（Volumes）

持久化数据存储管理：

docker volume ls                # 列出卷
docker volume create myvolume   # 创建卷
docker volume inspect myvolume  # 查看卷详情
docker volume rm myvolume       # 删除卷
docker volume prune             # 清理未使用卷
docker run -v myvolume:/data -d app  # 使用卷

系统管理（System Management）

Docker系统级清理与信息查看：

docker system df                # 查看磁盘使用
docker system prune             # 清理未使用资源
docker system prune -a          # 清理所有未使用（含镜像）
docker system prune --volumes   # 同时清理卷
docker info                     # 系统信息
docker version                  # 版本信息

常见工作流（Common Workflows）

预置开发、数据库、调试与构建工作流：

开发容器（Development container）：

docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  -p 3000:3000 \
  node:18 \
  npm run dev

数据库容器（Database container）：

docker run -d \
  --name postgres \
  -e POSTGRES_PASSWORD=secret \
  -e POSTGRES_DB=mydb \
  -v postgres-data:/var/lib/数据库/data \
  -p 5432:5432 \
  postgres:15

快速调试（Quick debugging）：

docker exec -it container_name sh
docker cp container_name:/path/to/file ./local/path
docker cp ./local/file container_name:/path/in/container

多阶段构建（Multi-stage build）：

FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
# ...
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

用法示例

示例1：启动一个带端口的Nginx容器

用户: 帮我启动一个Nginx容器，端口映射8080到80
# ...
Agent: docker run -d --name my-nginx -p 8080:80 nginx
- 容器已在后台启动
- 访问 http://localhost:8080 即可查看Nginx欢迎页
- 使用 docker logs -f my-nginx 查看日志

示例2：使用Docker Compose启动多服务

用户: 用docker-compose启动一个web+redis的应用
# ...
Agent: 以下是docker-compose.yml配置：
version: '3'
services:
  web:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - redis
  redis:
    image: redis:alpine
# ...
执行: docker-compose up -d
- 两个服务已在后台启动
- 使用 docker-compose ps 查看状态
- 使用 docker-compose logs -f 查看日志

示例3：调试运行中的容器

用户: 我的app容器有问题，帮我进去看看
# ...
Agent: 执行调试命令：
1. docker logs --tail 50 app  # 查看最近日志
2. docker exec -it app sh     # 进入容器shell
3. docker stats app           # 查看资源使用
# ...
如需复制文件：
docker cp app:/var/log/app.log ./app.log

疑问解答

Q1: 如何查看容器内发生了什么？

A: 使用 docker logs -f <container> 跟踪日志，使用 docker exec -it <container> sh 进入容器shell，使用 docker stats <container> 查看资源使用情况.

Q2: 如何清理Docker释放空间？

A: 使用 docker system prune -a --volumes 清理所有未使用的镜像、容器、网络和卷。注意此操作不可逆，确保没有需要保留的资源.

Q3: 如何在容器间通信？

A: 创建自定义网络 docker network create mynet，启动容器时使用 --network mynet，容器间可通过容器名互相访问.

Q4: 数据卷和绑定挂载有什么区别？

A: 数据卷（volume）由Docker管理，存储在Docker目录，适合持久化数据。绑定挂载（bind mount）直接映射主机路径，适合开发时挂载代码.

Q5: 如何构建更小的镜像？

A: 使用多阶段构建（multi-stage build），合并RUN命令减少层，使用Alpine等基础镜像，添加 .dockerignore 排除不必要文件.

Q6: docker-compose up和docker-compose up -d有什么区别？

A: docker-compose up 在前台运行，日志直接输出到终端，Ctrl+C停止。docker-compose up -d 在后台运行，需要用 docker-compose logs 查看日志.

注意事项

• 需要Docker Engine运行环境，无Docker环境无法执行命令
• 部分命令在Windows上语法不同（如 $(pwd) 需改为 ${PWD}）
• Docker Compose v1使用 docker-compose，v2使用 docker compose（无连字符）
• 容器内GPU支持需要额外配置NVIDIA Container Toolkit
• 复杂网络拓扑（如overlay网络）需要Swarm模式支持
• 镜像构建性能受网络影响，拉取基础镜像可能较慢

输出规范

{
  "success": true,
  "data": {
    "result": "Docker核心操作指南处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "docker-essentials"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

诊断与修复

安全说明

创新优势

量化评估

特色对比

异常管理

针对Docker核心操作指南使用中可能遇到的常见问题,提供以下排查方案:

Docker核心操作指南通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块