记一次 Docker 容器内存占用异常排查：从 docker system df 到容器级内存定位

docker system df

docker stats --no-stream --format "table {{.Name}}\t{{.MemUsage}}\t{{.MemPerc}}"

# 查看容器创建时间
docker inspect unknown-random-container --format '{{.Created}}'

# 查看容器启动命令
docker inspect unknown-random-container --format '{{.Config.Cmd}}'

# 查看容器入口点
docker inspect unknown-random-container --format '{{.Config.Entrypoint}}'

# 查看容器对应的镜像
docker inspect unknown-random-container --format '{{.Config.Image}}'

# 查找 4 月 28 日前后的相关提交
git log --oneline --since="2026-04-27" --until="2026-04-29"

# 查看 4 月 28 日的变更
git show 2026-04-28 --stat

# 查看整体内存使用
free -h

# 查看内存详细分布
cat /proc/meminfo | grep -E "MemTotal|MemFree|MemAvailable|Cached|SReclaimable"

# 按进程排序查看内存占用前 10
ps aux --sort=-%mem | head -10

# 查看所有容器（包括已停止的）
docker ps -a

# 停止容器
docker stop unknown-random-container

# 删除容器
docker rm unknown-random-container

# 验证删除
docker ps -a | grep unknown-random-container

# 查看所有镜像
docker images -a

# 删除悬挂镜像（<none>:<none>）
docker image prune -f

# 删除所有未使用的镜像
docker image prune -a -f

# 如果想删除指定镜像
docker rmi <镜像ID>

# 查看构建缓存
docker builder ls

# 清理构建缓存
docker builder prune -a -f

# 清理所有未使用的构建资源（包括构建缓存和构建历史）
docker builder prune --all -f

# 查看 Docker 资源占用
docker system df

# 对比清理前后
docker system df -v  # -v 参数显示更详细信息

# 查看系统内存
free -h

# 编辑 crontab
crontab -e

# 添加以下行：
# 每天凌晨 3 点清理 72 小时前创建的未使用资源
0 3 * * * /usr/bin/docker system prune -f --filter "until=72h"

# 每周日凌晨 4 点深度清理（清理所有未使用的镜像和构建缓存）
0 4 * * 0 /usr/bin/docker system prune -a -f --filter "until=168h"

# 创建 systemd service
cat > ~/.config/systemd/user/docker-cleanup.service << 'EOF'
[Unit]
Description=Docker cleanup service

[Service]
Type=oneshot
ExecStart=/usr/bin/docker system prune -f --filter "until=72h"
StandardOutput=journal
StandardError=journal
EOF

# 创建 systemd timer
cat > ~/.config/systemd/user/docker-cleanup.timer << 'EOF'
[Unit]
Description=Docker cleanup timer

[Timer]
OnCalendar=daily
Persistent=true

[Install]
WantedBy=timers.target
EOF

# 启用并启动 timer
systemctl --user enable --now docker-cleanup.timer

# 查看 timer 状态
systemctl --user list-timers

# 编辑 daemon.json
sudo mkdir -p /etc/docker
sudo cat > /etc/docker/daemon.json << 'EOF'
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "50m",
    "max-file": "3"
  },
  "storage-driver": "overlay2",
  "live-restore": true,
  "default-ulimits": {
    "nofile": {
      "Name": "nofile",
      "Hard": 65536,
      "Soft": 65536
    }
  }
}
EOF

# 重启 Docker 服务使配置生效
sudo systemctl restart docker

# 运行容器时指定内存限制
docker run -d --name my-app --memory="512m" --memory-swap="1g" my-image

# docker-compose.yml 示例
services:
  my-app:
    image: my-image
    deploy:
      resources:
        limits:
          memory: 512M
        reservations:
          memory: 256M

# 为已有容器更新内存限制（需要重新创建）
docker update --memory="512m" --memory-swap="1g" <容器ID>

#!/bin/bash
# docker-memory-fix.sh - Docker 内存异常一键修复脚本

set -e

echo "========== Docker 内存异常修复 =========="
echo "执行时间：$(date '+%Y-%m-%d %H:%M:%S')"
echo ""

# 0. 查看修复前的资源占用
echo "[修复前] Docker 资源占用："
docker system df
echo ""

# 1. 找出内存占用异常高的容器
echo "[1/6] 分析容器内存占用..."
docker stats --no-stream --format "table {{.Name}}\t{{.MemUsage}}\t{{.MemPerc}}" | head -10
echo ""

# 2. 停止并删除已停止的容器
echo "[2/6] 清理已停止容器..."
stopped_containers=$(docker ps -a -f status=exited -q)
if [ -n "$stopped_containers" ]; then
    echo "  发现已停止容器：$(echo "$stopped_containers" | wc -l) 个"
    docker container prune -f
else
    echo "  无已停止容器"
fi
echo ""

# 3. 清理未使用镜像
echo "[3/6] 清理未使用镜像..."
docker image prune -a -f
echo ""

# 4. 清理构建缓存
echo "[4/6] 清理构建缓存..."
docker builder prune -a -f
echo ""

# 5. 清理系统缓存（可选，谨慎使用）
echo "[5/6] 清理系统缓存..."
sync
echo 3 > /proc/sys/vm/drop_caches 2>/dev/null || true
echo ""

# 6. 验证修复结果
echo "[6/6] 验证修复结果..."
echo ""
echo "[修复后] Docker 资源占用："
docker system df
echo ""

echo "[修复后] 系统内存："
free -h | grep Mem
echo ""

echo "========== 修复完成 =========="

# 方法一：定时记录 docker system df 输出到文件
*/30 * * * * /usr/bin/docker system df >> /var/log/docker-resource.log

# 方法二：使用 Prometheus + cAdvisor 监控
# cAdvisor 会自动收集 Docker 容器级别的资源指标
docker run \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --publish=8080:8080 \
  google/cadvisor

# 方法三：使用 Grafana 可视化
# 导入 Docker 监控面板（Docker Host and containers 模板 ID: 193）