开源免费 · 轻量级 · 功能完整

Docker 可视化管理
从未如此简单

轻量级、功能完整的 Docker 可视化管理面板。支持容器、Compose、镜像、网络、存储卷一站式管理，内置实时监控告警、Web 终端、多工作区分组。

快速部署 GitHub
10+ 功能页面
22+ 交互组件
7 Compose 操作
6 内置模板
4 种告警规则
2 CPU 架构

核心功能

覆盖 Docker 日常运维的方方面面，提供一站式可视化管理体验

容器管理

启动、停止、重启、暂停、删除容器，支持卡片和表格双视图模式，批量操作一应俱全

Compose 编排

创建、编辑、部署 Compose 项目，支持多文件项目、环境变量、模板系统，完美处理相对路径卷挂载

实时监控告警

CPU、内存、磁盘、网络实时图表展示，可配置多级告警阈值，容器排名一目了然

Web 终端

WebSocket 驱动的交互式容器终端，支持多标签切换，无需 SSH 即可直接操作容器内部

日志与文件管理

实时流式日志查看，支持暂停/继续、搜索过滤。项目文件在线浏览、编辑，管理更高效

容器更新

自动检测镜像更新，支持 Docker Hub、GHCR 等多注册表，批量流式更新，安心升级

国际化与主题

完整中英文双语支持，一键切换深色/浅色主题，无论何时何地都有最佳体验

安全可靠

JWT 认证 + httpOnly Cookie 存储，滑动过期自动续期，自我保护防止误操作导致面板中断

为什么选择 Docker Dashboard？

  • 轻量级单体架构，一条命令即可部署，零额外依赖
  • 支持 amd64 和 arm64 双架构，树莓派也能完美运行
  • 自主可控，数据存储于本地 SQLite，不上传任何信息
  • 完整的 Compose 项目生命周期管理，超越 Portainer 的便捷体验
  • 内置 Web 终端和日志流，无需额外工具即可完成运维操作
docker-dashboard 部署终端
$ mkdir -p ~/docker-dashboard && cd ~/docker-dashboard
$ nano docker-compose.yml
# 粘贴官网提供的配置模板，修改3个关键路径
$ cat docker-compose.yml
image: yinheng1989/docker-dashboard:latest
network_mode: host
volumes: # 同路径挂载
- /mnt/data/projects:/mnt/data/projects
environment:
- PROJECTS_DIR=/mnt/data/projects
$ docker compose pull
→ Pulling yinheng1989/docker-dashboard:latest...
$ docker compose up -d
✔ Container docker-dashboard started
→ Dashboard available at http://localhost:3000
_

快速开始

选择适合你的部署方式

01

创建配置文件

创建项目目录和 docker-compose.yml，填入下方模板

mkdir -p ~/docker-dashboard && cd ~/docker-dashboard
nano docker-compose.yml （粘贴下方模板）
02

按需修改配置

打开 docker-compose.yml，修改以下 3 个关键配置

  • 将 /your/projects/path 替换为你存放 Compose 项目的宿主机路径
    volumes:
    − - /your/projects/path:/your/projects/path
    + - /mnt/data/projects:/mnt/data/projects
    environment:
    − - PROJECTS_DIR=/your/projects/path
    + - PROJECTS_DIR=/mnt/data/projects
  • 将 JWT_SECRET 替换为一个随机字符串（生产环境务必修改）
    environment:
    − - JWT_SECRET=change-me-to-a-random-string
    + - JWT_SECRET=$(openssl rand -base64 32)
  • 将 /your/data/path 替换为面板数据存储路径
    volumes:
    − - /your/data/path:/your/data/path
    + - ./data:./data
    environment:
    − - DB_DIR=/your/data/path
    + - DB_DIR=./data
03

拉取镜像并启动

拉取 Docker Hub 镜像并启动，支持 amd64 / arm64 双架构

拉取最新镜像
docker compose pull
启动服务
docker compose up -d
04

开始使用

浏览器访问面板地址，首次使用会引导你设置管理员密码

http://localhost:3000

配置模板 (docker-compose.yml)

docker-compose.yml 
services:
  dashboard:
    image: yinheng1989/docker-dashboard:latest
    container_name: docker-dashboard
    restart: unless-stopped
    network_mode: host
    volumes:
      #  关键：左右路径必须一致
      - /your/projects/path:/your/projects/path
      - /your/data/path:/your/data/path
      - /var/run/docker.sock:/var/run/docker.sock
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
    environment:
      #  生产环境务必修改
      - JWT_SECRET=change-me-to-a-random-string
      #  必须与volume挂载路径一致
      - PROJECTS_DIR=/your/projects/path
      - DB_DIR=/your/data/path

重要注意事项

部署前务必了解以下关键配置，否则 Compose 项目可能无法正常工作

同路径挂载（最关键）

Volume 挂载的宿主机路径必须与容器内路径一致（左=右）。这是为了让 Compose 文件中的相对路径卷（如 ./data:/data）正常工作。如果你不需要支持相对路径卷，可以不挂载 PROJECTS_DIR。

JWT_SECRET 安全密钥

生产环境务必修改 JWT_SECRET 为随机字符串（可使用 openssl rand -base64 32 生成），否则存在安全风险。

Docker Socket 权限

挂载 /var/run/docker.sock 相当于赋予面板完整的 Docker 控制权限。请确保面板端口不暴露在公网，或配置反向代理 + HTTPS。

网络模式选择

示例使用 host 网络模式（最简配置），如果你的环境有端口冲突，可改为 bridge 模式并暴露端口：ports: - "8070:3000"。

系统监控依赖

CPU/内存/磁盘监控需要挂载 /proc:/host/proc:ro 和 /sys:/host/sys:ro（只读），缺失将导致监控数据为空。

Compose V2 要求

面板使用 docker compose 命令（非 docker-compose），请确保已安装 Docker Compose V2。

无需手动配置，两条命令即可启动

01

下载配置文件

创建目录并下载一键部署版 docker-compose.yml

创建目录
mkdir -p ~/docker-dashboard && cd ~/docker-dashboard
下载 Compose 文件
wget https://raw.githubusercontent.com/yinheng1989/docker-dashboard/main/docker-compose%20copy.yml -O docker-compose.yml
02

一键启动

拉取镜像并启动，Docker 命名卷自动创建，零配置

拉取镜像并启动
docker compose up -d
03

开始使用

浏览器访问面板，首次使用会引导你设置管理员密码

http://localhost:8070

一键部署配置 (docker-compose.yml)

docker-compose.yml 
services:
  dashboard:
    image: yinheng1989/docker-dashboard:latest
    container_name: docker-dashboard
    restart: unless-stopped
    ports:
      - "8070:3000"
    volumes:
      # Docker 命名卷，自动创建，无需手动配置路径
      - dashboard-projects:/projects
      - dashboard-data:/data
      - /var/run/docker.sock:/var/run/docker.sock
      # 系统监控数据源（只读）
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
    environment:
      # 默认密钥，生产环境请修改
      - JWT_SECRET=${JWT_SECRET:-docker-dashboard-default-change-me}

volumes:
  dashboard-projects:
  dashboard-data:

适合场景

适合快速体验、测试环境或个人使用。如需管理已有的 Compose 项目并支持相对路径卷挂载，请使用「手动部署教程」方案。

使用 Docker 命名卷 存储数据

Docker 自动创建和管理，无需手动配置路径，升级迁移更简单。

零配置启动

下载即用，一条命令拉起全套服务，无需关心路径挂载和权限问题。

支持 amd64 / arm64

Docker 自动拉取匹配架构的镜像，树莓派也能完美运行。

技术架构

简洁高效的单体架构，兼顾性能与可维护性

前端 SPA
React 18 TypeScript Vite 6 Tailwind CSS 3 Recharts i18next Lucide Icons
后端服务 (:3000)
Express.js WebSocket JWT SQLite Unix Socket Docker CLI
Docker Engine
Docker Socket Docker CLI
数据存储
SQLite (WAL)