feat: Docker 监控面板

后端 API (routes_docker.py):
- /api/docker/containers - 容器列表(状态+资源stats: CPU/内存/网络I/O/磁盘I/O/进程数)
- /api/docker/container/<id>/stats - 单容器实时资源
- /api/docker/images - 镜像列表(大小/时间/悬空标记)
- /api/docker/system - 系统信息(版本/磁盘占用)
- /api/docker/container/<id>/start|stop|restart - 容器控制
- /api/docker/container/<id>/logs - 容器日志
- /api/docker/prune - 资源清理

前端 Docker 监控 Tab:
- 统计卡片: 总容器/运行中/已停止/镜像数/磁盘占用/可回收
- 容器列表: 状态灯+CPU/内存/NET IO/磁盘IO/端口/运行时间
- 操作按钮: 启动/停止/重启/查看日志
- 镜像列表: 有效镜像+悬空镜像分区显示
- 清理: 容器/镜像/全部一键清理

app.py

@@ -13,6 +13,7 @@ from routes_system import register_system_routes
 from routes_config import register_config_routes
 from routes_email import register_email_routes
 from routes_project import register_project_routes
+from routes_docker import register_docker_routes
 from templates import get_html_template
 
 
@@ -31,6 +32,7 @@ def init_app():
     register_config_routes(app)
     register_email_routes(app)
     register_project_routes(app)
+    register_docker_routes(app)
     
     # 主页路由
     @app.route('/')

routes_docker.py

@@ -0,0 +1,243 @@
+#!/usr/bin/env python3
+"""
+Docker 监控 API 路由
+"""
+
+import subprocess
+import json
+from flask import jsonify, request
+from utils import log_message
+
+
+def _run_docker(cmd, timeout=10):
+    """执行 docker 命令并返回解析结果"""
+    try:
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout)
+        if result.returncode != 0:
+            return None, result.stderr.strip()
+        return result.stdout.strip(), None
+    except subprocess.TimeoutExpired:
+        return None, '命令超时'
+    except FileNotFoundError:
+        return None, 'Docker 未安装'
+    except Exception as e:
+        return None, str(e)
+
+
+def register_docker_routes(app):
+    """注册 Docker 监控相关路由"""
+    
+    @app.route('/api/docker/containers')
+    def api_docker_containers():
+        """获取所有容器列表（含资源使用）"""
+        # 获取容器列表
+        fmt = '{{.ID}}|{{.Names}}|{{.Image}}|{{.State}}|{{.Status}}|{{.Ports}}|{{.CreatedAt}}|{{.RunningFor}}'
+        out, err = _run_docker(['docker', 'ps', '-a', '--format', fmt, '--no-trunc'])
+        if out is None:
+            return jsonify({'error': err, 'containers': []})
+        
+        containers = []
+        for line in out.split('\n'):
+            if not line.strip():
+                continue
+            parts = line.split('|')
+            if len(parts) < 8:
+                continue
+            cid = parts[0][:12]  # 缩短ID
+            containers.append({
+                'id': cid,
+                'name': parts[1],
+                'image': parts[2],
+                'state': parts[3],
+                'status': parts[4],
+                'ports': parts[5],
+                'created': parts[6],
+                'runningFor': parts[7]
+            })
+        
+        # 批量获取运行中容器的stats
+        running = [c for c in containers if c['state'] == 'running']
+        if running:
+            try:
+                stats_out, _ = _run_docker([
+                    'docker', 'stats', '--no-stream', '--no-trunc',
+                    '--format', '{{.Name}}|{{.CPUPerc}}|{{.MemPerc}}|{{.MemUsage}}|{{.NetIO}}|{{.BlockIO}}|{{.PIDs}}'
+                ], timeout=15)
+                if stats_out:
+                    stats_map = {}
+                    for line in stats_out.split('\n'):
+                        if not line.strip():
+                            continue
+                        sp = line.split('|')
+                        if len(sp) >= 7:
+                            stats_map[sp[0]] = {
+                                'cpuPercent': sp[1],
+                                'memPercent': sp[2],
+                                'memUsage': sp[3],
+                                'netIO': sp[4],
+                                'blockIO': sp[5],
+                                'pids': sp[6]
+                            }
+                    for c in containers:
+                        if c['name'] in stats_map:
+                            c['stats'] = stats_map[c['name']]
+            except:
+                pass
+        
+        return jsonify({'containers': containers})
+    
+    @app.route('/api/docker/container/<container_id>/stats')
+    def api_docker_container_stats(container_id):
+        """获取单个容器实时资源统计"""
+        out, err = _run_docker([
+            'docker', 'stats', '--no-stream', '--no-trunc',
+            '--format', '{{.CPUPerc}}|{{.MemPerc}}|{{.MemUsage}}|{{.NetIO}}|{{.BlockIO}}|{{.PIDs}}',
+            container_id
+        ], timeout=10)
+        if out is None:
+            return jsonify({'error': err}), 500
+        if not out:
+            return jsonify({'error': '容器不存在或未运行'}), 404
+        
+        parts = out.split('|')
+        return jsonify({
+            'cpuPercent': parts[0] if len(parts) > 0 else '0%',
+            'memPercent': parts[1] if len(parts) > 1 else '0%',
+            'memUsage': parts[2] if len(parts) > 2 else '',
+            'netIO': parts[3] if len(parts) > 3 else '',
+            'blockIO': parts[4] if len(parts) > 4 else '',
+            'pids': parts[5] if len(parts) > 5 else '0'
+        })
+    
+    @app.route('/api/docker/images')
+    def api_docker_images():
+        """获取所有镜像列表"""
+        fmt = '{{.Repository}}|{{.Tag}}|{{.ID}}|{{.Size}}|{{.CreatedAt}}|{{.Containers}}'
+        out, err = _run_docker(['docker', 'images', '--format', fmt, '--no-trunc'])
+        if out is None:
+            return jsonify({'error': err, 'images': []})
+        
+        images = []
+        for line in out.split('\n'):
+            if not line.strip():
+                continue
+            parts = line.split('|')
+            if len(parts) < 6:
+                continue
+            repo = parts[0] if parts[0] != '<none>' else ''
+            tag = parts[1] if parts[1] != '<none>' else ''
+            images.append({
+                'repository': repo,
+                'tag': tag,
+                'id': parts[2][:12],
+                'size': parts[3],
+                'created': parts[4],
+                'containers': parts[5],
+                'dangling': not repo and not tag
+            })
+        
+        return jsonify({'images': images})
+    
+    @app.route('/api/docker/system')
+    def api_docker_system():
+        """获取 Docker 系统信息"""
+        # 版本信息
+        ver_out, _ = _run_docker(['docker', 'version', '--format', '{{.Server.Version}}|{{.Server.Os}}|{{.Server.Arch}}'], timeout=5)
+        
+        # 磁盘使用
+        df_out, _ = _run_docker(['docker', 'system', 'df', '--format', '{{.Type}}|{{.TotalCount}}|{{.Active}}|{{.Size}}|{{.Reclaimable}}'], timeout=10)
+        
+        system_info = {
+            'version': '',
+            'os': '',
+            'arch': '',
+            'diskUsage': []
+        }
+        
+        if ver_out:
+            ver_parts = ver_out.split('|')
+            if len(ver_parts) >= 3:
+                system_info.update({
+                    'version': ver_parts[0],
+                    'os': ver_parts[1],
+                    'arch': ver_parts[2]
+                })
+        
+        if df_out:
+            for line in df_out.split('\n'):
+                if not line.strip():
+                    continue
+                parts = line.split('|')
+                if len(parts) >= 5:
+                    system_info['diskUsage'].append({
+                        'type': parts[0],
+                        'total': parts[1],
+                        'active': parts[2],
+                        'size': parts[3],
+                        'reclaimable': parts[4]
+                    })
+        
+        return jsonify(system_info)
+    
+    @app.route('/api/docker/container/<container_id>/logs')
+    def api_docker_container_logs(container_id):
+        """获取容器日志（最近200行）"""
+        lines = int(request.args.get('lines', 200))
+        lines = max(10, min(1000, lines))
+        
+        out, err = _run_docker(['docker', 'logs', '--tail', str(lines), container_id], timeout=10)
+        if out is None:
+            return jsonify({'error': err}), 500
+        
+        return jsonify({'logs': out, 'lines': lines})
+    
+    @app.route('/api/docker/container/<container_id>/start', methods=['POST'])
+    def api_docker_container_start(container_id):
+        """启动容器"""
+        out, err = _run_docker(['docker', 'start', container_id])
+        if out is None and err:
+            return jsonify({'error': err}), 500
+        log_message(f"Docker 容器启动: {container_id}")
+        return jsonify({'message': f'容器 {container_id} 已启动'})
+    
+    @app.route('/api/docker/container/<container_id>/stop', methods=['POST'])
+    def api_docker_container_stop(container_id):
+        """停止容器"""
+        out, err = _run_docker(['docker', 'stop', container_id])
+        if out is None and err:
+            return jsonify({'error': err}), 500
+        log_message(f"Docker 容器停止: {container_id}")
+        return jsonify({'message': f'容器 {container_id} 已停止'})
+    
+    @app.route('/api/docker/container/<container_id>/restart', methods=['POST'])
+    def api_docker_container_restart(container_id):
+        """重启容器"""
+        out, err = _run_docker(['docker', 'restart', container_id])
+        if out is None and err:
+            return jsonify({'error': err}), 500
+        log_message(f"Docker 容器重启: {container_id}")
+        return jsonify({'message': f'容器 {container_id} 已重启'})
+    
+    @app.route('/api/docker/prune', methods=['POST'])
+    def api_docker_prune():
+        """清理Docker资源"""
+        target = request.json.get('target', 'all') if request.json else 'all'
+        results = {}
+        
+        # 清理停止的容器
+        if target in ('all', 'containers'):
+            out, _ = _run_docker(['docker', 'container', 'prune', '-f'], timeout=30)
+            results['containers'] = out or '已清理'
+        
+        # 清理悬空镜像
+        if target in ('all', 'images'):
+            out, _ = _run_docker(['docker', 'image', 'prune', '-f'], timeout=60)
+            results['images'] = out or '已清理'
+        
+        # 清理构建缓存
+        if target in ('all', 'build'):
+            out, _ = _run_docker(['docker', 'builder', 'prune', '-f'], timeout=60)
+            results['build'] = out or '已清理'
+        
+        log_message(f"Docker 资源清理完成: {target}")
+        return jsonify({'message': '清理完成', 'results': results})

templates_full.txt

@@ -119,6 +119,9 @@
             <button onclick="switchTab('cron')" class="tab-btn px-4 py-2 text-gray-300 hover:text-white" data-tab="cron">
                 <i class="ri-timer-line"></i> Cron 管理
             </button>
+            <button onclick="switchTab('docker')" class="tab-btn px-4 py-2 text-gray-300 hover:text-white" data-tab="docker">
+                <i class="ri-ship-line"></i> Docker 监控
+            </button>
         </div>
 
         <!-- 项目服务 Tab -->
@@ -485,6 +488,72 @@
                 <div class="text-center py-12 text-gray-400"><i class="ri-loader-4-line text-4xl animate-spin"></i><p class="mt-2">加载中...</p></div>
             </div>
         </div>
+
+        <!-- Docker 监控 Tab -->
+        <div id="dockerTab" class="hidden">
+            <!-- Docker 统计卡片 -->
+            <div class="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-6 gap-3 mb-6">
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">总容器数</p>
+                    <p id="dockerContainersTotal" class="text-xl font-bold text-blue-400">-</p>
+                </div>
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">运行中</p>
+                    <p id="dockerContainersRunning" class="text-xl font-bold text-green-400">-</p>
+                </div>
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">已停止</p>
+                    <p id="dockerContainersStopped" class="text-xl font-bold text-red-400">-</p>
+                </div>
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">总镜像数</p>
+                    <p id="dockerImagesTotal" class="text-xl font-bold text-purple-400">-</p>
+                </div>
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">磁盘占用</p>
+                    <p id="dockerDiskSize" class="text-xl font-bold text-yellow-400">-</p>
+                </div>
+                <div class="card rounded-xl p-3">
+                    <p class="text-gray-400 text-xs">可回收</p>
+                    <p id="dockerReclaimable" class="text-xl font-bold text-orange-400">-</p>
+                </div>
+            </div>
+
+            <!-- 操作按钮 -->
+            <div class="flex gap-2 mb-4 flex-wrap">
+                <button onclick="loadDockerData()" class="btn bg-blue-600 hover:bg-blue-700 px-3 py-2 rounded-lg text-sm flex items-center gap-1">
+                    <i class="ri-refresh-line"></i> 刷新
+                </button>
+                <button onclick="dockerPrune('containers')" class="btn bg-yellow-600 hover:bg-yellow-700 px-3 py-2 rounded-lg text-sm flex items-center gap-1">
+                    <i class="ri-delete-bin-line"></i> 清理容器
+                </button>
+                <button onclick="dockerPrune('images')" class="btn bg-orange-600 hover:bg-orange-700 px-3 py-2 rounded-lg text-sm flex items-center gap-1">
+                    <i class="ri-image-line"></i> 清理镜像
+                </button>
+                <button onclick="dockerPrune('all')" class="btn bg-red-600 hover:bg-red-700 px-3 py-2 rounded-lg text-sm flex items-center gap-1">
+                    <i class="ri-broom-line"></i> 全部清理
+                </button>
+                <span class="text-gray-500 text-xs flex items-center ml-2">版本: <span id="dockerVersion" class="text-gray-300 ml-1">-</span></span>
+            </div>
+
+            <!-- 容器列表 -->
+            <h3 class="text-sm font-semibold text-gray-300 mb-2 flex items-center gap-2">
+                <i class="ri-computer-line text-blue-400"></i> 容器列表
+                <span id="dockerContainerCount" class="text-xs text-gray-500"></span>
+            </h3>
+            <div id="dockerContainersList" class="space-y-2 mb-6">
+                <div class="text-gray-500 text-sm py-4 text-center">加载中...</div>
+            </div>
+
+            <!-- 镜像列表 -->
+            <h3 class="text-sm font-semibold text-gray-300 mb-2 flex items-center gap-2">
+                <i class="ri-stack-line text-purple-400"></i> 镜像列表
+                <span id="dockerImageCount" class="text-xs text-gray-500"></span>
+            </h3>
+            <div id="dockerImagesList" class="space-y-1">
+                <div class="text-gray-500 text-sm py-4 text-center">加载中...</div>
+            </div>
+        </div>
     </div>
 
     <!-- 日志模态框 -->
@@ -855,6 +924,9 @@
             document.getElementById('projectsTab').classList.toggle('hidden', tab !== 'projects');
             document.getElementById('systemTab').classList.toggle('hidden', tab !== 'system');
             document.getElementById('cronTab').classList.toggle('hidden', tab !== 'cron');
+            document.getElementById('dockerTab').classList.toggle('hidden', tab !== 'docker');
+            
+            if (tab === 'docker') loadDockerData();
             
             // 切换Tab时关闭实时监控
             if (tab !== 'system' && realtimeTimer) {
@@ -2665,6 +2737,130 @@
         setInterval(() => {
             fetch('/api/projects').then(() => updateConnectionStatus(true)).catch(() => updateConnectionStatus(false));
         }, 10000);
+
+        // ==================== Docker 监控 ====================
+        
+        async function loadDockerData() {
+            try {
+                const [containersRes, imagesRes, systemRes] = await Promise.all([
+                    fetch('/api/docker/containers'),
+                    fetch('/api/docker/images'),
+                    fetch('/api/docker/system')
+                ]);
+                const containers = (await containersRes.json()).containers || [];
+                const images = (await imagesRes.json()).images || [];
+                const system = await systemRes.json();
+                renderDockerStats(containers, images, system);
+                renderDockerContainers(containers);
+                renderDockerImages(images);
+                document.getElementById('dockerVersion').textContent = system.version || '-';
+            } catch (e) {
+                console.error('Docker数据加载失败:', e);
+            }
+        }
+        
+        function renderDockerStats(containers, images, system) {
+            const total = containers.length;
+            const running = containers.filter(c => c.state === 'running').length;
+            const stopped = total - running;
+            const imgTotal = images.length;
+            document.getElementById('dockerContainersTotal').textContent = total;
+            document.getElementById('dockerContainersRunning').textContent = running;
+            document.getElementById('dockerContainersStopped').textContent = stopped;
+            document.getElementById('dockerImagesTotal').textContent = imgTotal;
+            document.getElementById('dockerContainerCount').textContent = `(${running}运行 / ${total}总计)`;
+            document.getElementById('dockerImageCount').textContent = `(${imgTotal}个)`;
+            const imagesDisk = system.diskUsage?.find(d => d.type === 'Images');
+            if (imagesDisk) {
+                document.getElementById('dockerDiskSize').textContent = imagesDisk.size;
+                document.getElementById('dockerReclaimable').textContent = imagesDisk.reclaimable;
+            }
+        }
+        
+        function renderDockerContainers(containers) {
+            const list = document.getElementById('dockerContainersList');
+            if (containers.length === 0) {
+                list.innerHTML = '<div class="text-gray-500 text-sm py-4 text-center">暂无容器</div>';
+                return;
+            }
+            list.innerHTML = containers.map(c => {
+                const isRunning = c.state === 'running';
+                const s = c.stats || {};
+                const portsDisplay = c.ports ? c.ports.split(',').slice(0, 3).join(', ') : '';
+                return `<div class="card rounded-lg p-3 ${isRunning ? 'border-green-500/30' : 'border-red-500/30'}">
+                    <div class="flex items-center justify-between mb-2">
+                        <div class="flex items-center gap-2">
+                            <div class="w-2 h-2 rounded-full ${isRunning ? 'bg-green-400' : 'bg-red-400'}" style="${isRunning ? 'box-shadow: 0 0 8px #4ade80;' : ''}"></div>
+                            <span class="font-semibold text-sm text-gray-200">${c.name}</span>
+                            <span class="text-xs ${isRunning ? 'text-green-400' : 'text-red-400'}">${isRunning ? '运行中' : '已停止'}</span>
+                        </div>
+                        <div class="flex items-center gap-1">
+                            ${isRunning ? `<button onclick="dockerControl('${c.id}','stop')" class="btn bg-red-600/50 hover:bg-red-600 px-2 py-0.5 rounded text-xs">停止</button><button onclick="dockerControl('${c.id}','restart')" class="btn bg-yellow-600/50 hover:bg-yellow-600 px-2 py-0.5 rounded text-xs">重启</button>` : `<button onclick="dockerControl('${c.id}','start')" class="btn bg-green-600/50 hover:bg-green-600 px-2 py-0.5 rounded text-xs">启动</button>`}
+                            <button onclick="showDockerLogs('${c.id}','${c.name}')" class="btn bg-gray-600/50 hover:bg-gray-600 px-2 py-0.5 rounded text-xs">日志</button>
+                        </div>
+                    </div>
+                    <div class="grid grid-cols-2 md:grid-cols-4 gap-2 text-xs">
+                        <div><span class="text-gray-500">镜像:</span> <span class="text-gray-300">${c.image}</span></div>
+                        ${isRunning ? `<div><span class="text-gray-500">CPU:</span> <span class="text-blue-400">${s.cpuPercent || '-'}</span></div><div><span class="text-gray-500">内存:</span> <span class="text-green-400">${s.memUsage || '-'} (${s.memPercent || '-'})</span></div><div><span class="text-gray-500">进程:</span> <span class="text-gray-300">${s.pids || '-'}</span></div><div><span class="text-gray-500">网络I/O:</span> <span class="text-cyan-400">${s.netIO || '-'}</span></div><div><span class="text-gray-500">磁盘I/O:</span> <span class="text-purple-400">${s.blockIO || '-'}</span></div>` : ''}
+                        ${portsDisplay ? `<div class="col-span-2"><span class="text-gray-500">端口:</span> <span class="text-yellow-400">${portsDisplay}</span></div>` : ''}
+                        <div class="col-span-2"><span class="text-gray-500">运行时间:</span> <span class="text-gray-400">${c.runningFor || '-'}</span></div>
+                    </div>
+                </div>`;
+            }).join('');
+        }
+        
+        function renderDockerImages(images) {
+            const list = document.getElementById('dockerImagesList');
+            if (images.length === 0) {
+                list.innerHTML = '<div class="text-gray-500 text-sm py-4 text-center">暂无镜像</div>';
+                return;
+            }
+            const valid = images.filter(i => !i.dangling);
+            const dangling = images.filter(i => i.dangling);
+            let html = '';
+            if (valid.length > 0) {
+                html += valid.map(i => `<div class="flex items-center justify-between bg-gray-700/30 px-3 py-1.5 rounded text-xs"><div class="flex items-center gap-2 flex-1 min-w-0"><span class="text-gray-200 truncate">${i.repository}:${i.tag || 'latest'}</span><span class="text-gray-500">${i.size}</span></div><span class="text-gray-500 ml-2 shrink-0">${(i.created || '').substring(0, 19)}</span></div>`).join('');
+            }
+            if (dangling.length > 0) {
+                html += `<div class="text-yellow-400/70 text-xs mt-2 mb-1"><i class="ri-error-warning-line"></i> 悬空镜像 (${dangling.length}个)</div>`;
+                html += dangling.map(i => `<div class="flex items-center justify-between bg-yellow-500/10 px-3 py-1.5 rounded text-xs opacity-70"><div class="flex items-center gap-2 flex-1 min-w-0"><span class="text-gray-400 truncate">&lt;none&gt;:&lt;none&gt;</span><span class="text-gray-500">${i.size}</span><span class="text-gray-500">${i.id}</span></div><span class="text-gray-500 ml-2 shrink-0">${(i.created || '').substring(0, 19)}</span></div>`).join('');
+            }
+            list.innerHTML = html;
+        }
+        
+        async function dockerControl(containerId, action) {
+            const names = { start: '启动', stop: '停止', restart: '重启' };
+            if (!confirm(`确定要${names[action]}容器吗？`)) return;
+            try {
+                const res = await fetch(`/api/docker/container/${containerId}/${action}`, { method: 'POST' });
+                const data = await res.json();
+                if (data.error) { alert(`操作失败: ${data.error}`); return; }
+                setTimeout(loadDockerData, 1000);
+            } catch (e) { alert('操作失败: ' + e.message); }
+        }
+        
+        async function showDockerLogs(containerId, name) {
+            const m = document.getElementById('logModal');
+            document.getElementById('logTitle').textContent = `${name} - 日志`;
+            document.getElementById('logContent').textContent = '加载中...';
+            m.classList.add('flex'); m.classList.remove('hidden');
+            try {
+                const res = await fetch(`/api/docker/container/${containerId}/logs?lines=200`);
+                const data = await res.json();
+                document.getElementById('logContent').textContent = data.logs || data.error || '无日志';
+            } catch (e) { document.getElementById('logContent').textContent = '加载失败: ' + e.message; }
+        }
+        
+        async function dockerPrune(target) {
+            const names = { all: '所有资源(停止的容器+悬空镜像+构建缓存)', containers: '停止的容器', images: '悬空镜像', build: '构建缓存' };
+            if (!confirm(`确定清理${names[target]}？不可撤销。`)) return;
+            try {
+                const res = await fetch('/api/docker/prune', { method: 'POST', headers: {'Content-Type':'application/json'}, body: JSON.stringify({target}) });
+                alert((await res.json()).message || '完成');
+                setTimeout(loadDockerData, 1000);
+            } catch (e) { alert('失败: ' + e.message); }
+        }
+
     </script>
 </body>
 </html>