★ FEATURED ARTICLE 说真的我见过不少刚接触 Docker 的人第一反应不是“容器好神奇”而是“这命令行也太劝退了吧”。我自己用了好几年 Docker Compose依然得承认日常管理服务器最花时间的不是写配置而是在终端里反复确认“这个容器到底起来没有”“日志报了什么错”。标题里说的 Docker Compose UI其实是这一类工具的统一叫法——它把 docker compose 项目的启动、停止、日志查看、状态检查从黑乎乎的终端搬到了网页按钮上。这篇文章会讲清楚它解决了什么问题、有哪些主流方案然后带你在服务器上从零部署一套并跑通一个 WordPress 项目。适合刚接触容器的小白也适合想给团队降低容器使用门槛的工程师。先说结论Docker Compose UI 能让你不用再去背 docker compose up、docker compose ps、docker compose logs 这些命令但它不能替你理解 Compose 文件本身。这就像开车切到自动挡换挡动作确实变简单了但交通规则和路况判断你仍然得学。所以这篇文章的后半部分我还会把 Compose 文件怎么组织、怎么排查错误一起讲明白确保你就算离开 UI也不至于手忙脚乱。1. 为什么非要在命令行之外加一层 UI1.1 命令行的真正痛点不是“记不住命令”而是状态不直观很多人以为小白怕的是命令长其实不是。docker compose up -d这种命令背几次就会了真正麻烦的是“状态信息很难一眼看懂”。拿我自己的一台测试服务器举例上面跑着 WordPress、Nginx 反代、监控栈三个 Compose 项目每个项目有三四个容器。每次想确认服务是否正常我得先docker ps在几十行输出里找容器名再靠记忆力把容器和项目对应起来。更难受的是docker ps默认只显示运行中的容器。如果某个服务已经挂了你得加-a参数想看某个项目的日志得先cd到对应的 Compose 文件目录再执行docker compose logs -f。一旦项目多了目录路径记不清整个排查过程就变成“猜谜游戏”。对于只是偶尔部署一个博客、一个小应用的人来说这个学习成本完全没必要。UI 层能解决的核心问题就是把这些分散的命令行操作收敛成可视化页面。你不必记住每个容器属于哪个项目因为界面会按项目分组展示你不必盯着 Status 列猜 Restarting 是什么意思因为界面会用颜色、标签把异常状态标出来。说白了UI 的价值不是让你少打字而是让你少做“信息检索”。1.2 UI 层到底改变了哪些日常操作先列四个最直观的变化一是项目级的状态总览所有 Compose 项目在同一个页面里列出来运行中、停止、异常一眼可见二是日志查看从“找文件、敲命令”变成“点开项目、点日志”还能直接看最近几百行三是启停操作从输入命令变成按钮部署时也不用担心遗漏--build、-d这些参数四是错误提示更友好Compose 文件语法有问题时UI 会直接提示而不是让命令行输出一大段晦涩报错。但这里有一个必须说清楚的地方UI 只是把命令封装好了它不会替你“诊断”。如果 WordPress 容器一直重启UI 能告诉你状态是 Restarting但为什么重启它不会自动告诉你答案。最终你还是要看容器日志甚至要看应用日志才能定位。所以我的建议是UI 解决“看状态”的问题自己保留“查原因”的能力两者组合才是最佳状态。1.3 一个更实在的类比UI 是仪表盘不是自动驾驶拿开车类比Compose 文件相当于变速箱的档位逻辑UI 只是把手动挡换成了自动挡。自动挡让你不用频繁操作离合器但你不能一边开车一边问“为什么松油门会减速”。容器技术也一样你最终要懂的是镜像、端口、数据卷、依赖关系而不是背命令。我在帮朋友搭服务器时最常讲的一句话是用 UI 管理 Compose 项目但永远把 Compose 文件当作“唯一事实来源”。因为无论用哪个 UI 工具它背后管理的都是一份文本文件。文件在项目就在文件丢了UI 再好看也没有用。抱着这个心态去学你会发现自己即使切回命令行也不会慌。2. UI 方案选型先分清哪种才是你要的“Docker Compose UI”2.1 市面上常见方案对比标题里的“Docker Compose UI”并不是某一个软件而是一类工具。我在不同场景下试过四种比较有代表性的方案这里列成一个表方便你对号入座。工具形态核心优势适合谁Portainer网页 UI功能全面能管镜像、网络、卷、多环境带应用模板想用一个页面管理整台 Docker 宿主机的人Dockge网页 UI专门面向 Compose 文件按项目目录管理界面直观主要用 docker compose 部署业务项目的小团队或个人Lazydocker终端 TUI在终端里用鼠标/快捷键交互轻量快速已经熟悉命令行只是想要更好状态的开发者Yacht网页 UI界面简洁部署简单只跑一两个应用、不想折腾环境的小白Portainer 是老牌工具能力最全但它的定位偏向“Docker 管理器”Compose 只是其中一个模块。Dockge 是这两年很受折腾党喜欢的方案它把“Compose 项目”当成一等公民一个目录对应一个项目界面直接展示 Compose 内容还能从目录倒着导入已有项目。Lazydocker 严格来说不是网页 UI但对喜欢留在终端里的人确实很顺手。Yacht 轻量只是生态和更新频率不如前两者。2.2 为什么我这次选 Dockge如果你的需求就是“用 Docker Compose 管理几个网站、几个服务”我的推荐是直接从 Dockge 开始。原因不复杂它不会把 Docker 的所有概念一次性甩到你脸上而是围绕 Compose 项目来做文章。启动之后你看到的是一个项目列表点进去就是 Compose 文件编辑器和容器状态区非常贴合“小白也能轻松上手”这个场景。Dockge 的另一个好处是“不锁死你的数据”。它把所有项目放在一个根目录下比如/opt/stacks每个项目就是里面一个子文件夹。哪怕哪天你不想用 Dockge 了直接跑到那个目录执行docker compose up -d服务照样能起来。这种“可迁移性”对小白非常重要因为你不会被某一个 UI 绑架。它也有短板如果你想精细管理 Docker 网络、批量清理镜像、查看多个宿主机状态Dockge 并不擅长。这种时候 Portainer 更合适。所以选型原则很简单——先问自己到底是在管“Docker”还是在管“Compose 项目”。答案偏向后者的用 Dockge 就是最顺手的。2.3 选型前想清楚三件事比看功能列表更重要第一Compose 文件是否还在我的掌控范围内UI 可以帮你生成文件但你不能连文件在哪都不知道。第二UI 服务挂掉会不会影响现有业务好的设计是UI 只是“控制端”业务容器由 Docker 自己管理。所以 UI 容器挂掉业务容器照常运行这才合格。第三能不能独立备份恢复我见过一些人把配置全存在某个 SaaS 平台里一旦平台出问题项目也跟着遭殃。自托管的 UI 就没有这个风险。我实际踩过一个坑有个项目为了图省事所有配置都存在 UI 的网页配置中心里没有落到磁盘文件。结果 UI 容器数据卷损坏整个部署配置全部丢失只能凭记忆重建。从那以后我再也不碰“纯数据库存储配置”的方案。Dockge 这类“文件即配置”的软件反而给了我安全感。3. 实操从零部署 Docker Compose UI并跑通第一个项目3.1 环境准备先确认 Docker 和 Compose 都就位在部署 UI 之前我建议先在一台干净的 Ubuntu 22.04 或 24.04 服务器上操作。登录后先检查环境执行以下命令docker --version docker compose version如果命令不存在说明 Docker 还没装好。现在主流安装方式是通过 Docker 官方 apt 仓库安装安装完成后再确认docker compose可用。这里特别提一句早期很多人用的是docker-compose带横杠的独立二进制现在官方推荐的是docker compose带空格的 Docker 插件功能上面基本兼容但新项目建议直接用插件版本。确认安装后顺便执行一下sudo systemctl status docker确保 Docker 服务处于运行状态。这一步看起来多余真到排查问题的时候能帮你少走很多弯路。3.2 用一条 docker run 把 Dockge 跑起来Dockge 安装非常轻量本质就是运行一个容器并把三个关键目录挂进去。我在服务器上实际执行的命令如下sudo mkdir -p /opt/stacks /opt/dockge cd /opt/dockge sudo docker run -d \ --name dockge \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /opt/dockge:/app/data \ -v /opt/stacks:/opt/stacks \ -e DOCKGE_STACKS_DIR/opt/stacks \ -p 5001:5001 \ --restart unless-stopped \ lscr.io/linuxserver/dockge:latest我把每个参数拆开说明一下。-v /var/run/docker.sock:/var/run/docker.sock是让它能调用 Docker 引擎的 API这是所有容器管理类 UI 的通用做法-v /opt/dockge:/app/data是保存 Dockge 自身的配置-v /opt/stacks:/opt/stacks则是让你的 Compose 项目文件都落到宿主机目录里方便备份和命令行兜底。DOCKGE_STACKS_DIR指定项目根目录-p 5001:5001把网页端口映射出来。执行完后浏览器访问http://服务器IP:5001第一次会要求设置用户名密码。如果你在国内服务器上拉取镜像很慢可以配置 Docker registry 镜像加速或者用已经配置好加速器的云主机。反正镜像不大耐心等一下就行。3.3 在 UI 里创建第一个 Compose 项目WordPress MySQL登录 Dockge 之后主页面会显示空的项目列表。点击新建 Stack输入名称blog然后在编辑器里粘贴下面这份 Compose 文件services: db: image: mysql:8.0 container_name: blog-db restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: change-me MYSQL_DATABASE: wordpress MYSQL_USER: wp_user MYSQL_PASSWORD: change-me-too volumes: - db_data:/var/lib/mysql wordpress: image: wordpress:latest container_name: blog-wp restart: unless-stopped depends_on: - db ports: - 8080:80 environment: WORDPRESS_DB_HOST: db:3306 WORDPRESS_DB_USER: wp_user WORDPRESS_DB_PASSWORD: change-me-too WORDPRESS_DB_NAME: wordpress volumes: - wp_data:/var/www/html volumes: db_data: wp_data:粘贴完成后点击部署按钮。Dockge 实际做的事情就是在/opt/stacks/blog目录下生成 Compose 文件然后执行docker compose up -d。如果部署成功你会在项目详情页看到两个容器blog-db和blog-wp状态都是 Running。这份 Compose 文件值得逐行理解。services定义了要启动的两个服务image指定镜像来源environment是传给容器的环境变量相当于在容器内部设置参数volumes定义数据卷保证容器删了数据还在ports把容器的 80 端口映射到宿主机 8080depends_on表示两个服务之间的启动依赖。你只要把这种结构套到别的项目上会发现所有 Compose 文件长得都很像。3.4 同一套操作的命令行等价流程不是要让你舍近求远去敲命令而是为了让你理解 UI 的“底牌”是什么。刚才那套操作在命令行里等价于sudo mkdir -p /opt/stacks/blog cd /opt/stacks/blog sudo vim compose.yaml # 把上面的 Compose 内容粘贴进去保存 sudo docker compose up -d sudo docker compose ps sudo docker compose logs -f如果以后遇到 UI 无法启动、或者想临时查看某个项目状态你可以直接 SSH 到服务器按这套流程操作。UI 的确是自动挡但你要知道发动机在哪儿。我见过有的小白在 UI 里把项目删了以为数据也没了实际上 Docker 的数据卷还留在宿主机里。反过来如果你把数据卷删了UI 里再点多少次部署都救不回来。理解底层逻辑才能避免这种误操作。4. 日常维护日志、更新、备份我都是怎么处理的4.1 在 UI 里看日志和容器状态的小技巧Dockge 的项目详情页做得很直观下方直接列出这个 Compose 项目内的所有容器包括容器名、镜像、端口、状态。点日志按钮界面会弹出日志窗口默认显示最近一段时间的输出相当于docker compose logs --tail200。对于小白来说这一步已经把排查门槛降低了一大截。不过我要给一个实用建议不要一上来就刷整个日志先看状态。如果容器状态是Up但访问网站仍然 500再去看应用日志。比如 WordPress 连不上数据库日志里通常会出现database connection errorMySQL 起不来日志里会输出Cant connect to local MySQL server。日志是给人看的不是用来吓人的静下心读前几行大多数问题都能定位。4.2 更新镜像的正确姿势别被“重新部署”骗了很多小白以为点了 Deploy 就会自动拉取最新镜像这是一个很大的误区。docker compose up -d的默认行为是如果本地有镜像就用本地镜像启动只有你明确指定了新的镜像标签它才会去拉新版本。换句话说如果你在 UI 里看到镜像有更新但 Compose 文件里写的是image: wordpress:latest重新部署也不一定会拉到最新版。正确姿势是先在服务器终端执行拉取和更新再回到 UI 点部署cd /opt/stacks/blog sudo docker compose pull sudo docker compose up -dpull会把配置里用到的镜像拉取到最新版本up -d会重建容器。如果你希望完全自动化也可以手动把这步写成定时任务但我的建议是先手动跑几遍确认流程没问题再谈自动化。还有一个细节生产环境尽量不要依赖latest标签因为它会让回滚变得非常困难。用明确的版本号比如mysql:8.0.40出问题能切回旧版本。4.3 备份和恢复真正该保护的是 Compose 文件和数据卷UI 可以随时用一行命令重新部署不值得备份。真正珍贵的是两部分一是/opt/stacks里的 Compose 文件二是 Docker 命名卷里的业务数据。Compose 文件备份很简单直接打成 tar 包就行。数据卷备份稍微绕一点要用一个临时容器把卷内容打包比如sudo docker run --rm -v blog_db_data:/data -v $(pwd):/backup alpine tar czf /backup/blog_db_data.tar.gz -C /data .这条命令的意思是把名为blog_db_data的 Docker 卷内容打包到当前目录。恢复时先创建同名卷再把 tar 包解进去。我们用 Docker Compose 声明了命名卷db_data和wp_data所以数据不会因为容器重建而丢。但“不会丢”不等于“不用备份”服务器硬盘损坏、误删卷照样能毁掉整个网站。我个人的习惯是每周做一次 Compose 目录加数据卷的双重备份备份文件放到另一台机器或对象存储上。这个习惯不复杂但能让你在灾难发生时从“焦虑”变成“有备无患”。4.4 给新手的几条“不要”清单第一不要直接在 ssh 里改正在运行的 Compose 文件然后又去 UI 里点部署这样 UI 和文件容易不同步。要么都用 UI要么都在命令行不要混着来。第二不要把 5001 端口裸奔到公网Dockge 只有登录密码没有多因素认证暴露出去风险很高。第三不要在图演示里把 MySQL root 密码写死正式环境建议用.env文件配合环境变量。第四不要忽略restart: unless-stopped它可以有效减少“服务器重启之后容器没起来”的尴尬。这些规则都不是什么高深理论只是我踩过坑之后总结出来的经验。UI 是工具工具越顺手越容易让人放松警惕。保持一点敬畏心容器管理才会更稳定。5. 常见问题与排查技巧实录5.1 UI 页面打不开第一反应别去重装这是最常被问的问题之一。遇到页面打不开我的排查顺序很固定先看容器状态再查端口监听最后看容器日志而不是一上来就删掉重装。sudo docker ps | grep dockge sudo ss -lntp | grep 5001 sudo docker logs dockge --tail 50第一条命令确认容器是否在运行第二条确认端口是否被监听第三条看有没有报错信息。如果容器根本没起来比如故意用docker ps -a查看发现它是 Exited说明启动时就出了问题。如果容器正常但浏览器打不开九成是云服务器安全组没放行 5001 端口去控制台加一条入站规则就好。这个坑几乎每个新手都会踩一遍。5.2 点了 Deploy 报错但 UI 不显示具体原因怎么办Dockge 在部署失败时有时只显示一个很笼统的提示比如invalid compose project。这时候不要反复在 UI 里瞎点回到命令行用 Compose 自带的校验功能更高效cd /opt/stacks/blog sudo docker compose config -qdocker compose config -q会检查配置文件语法不通过就把具体行号错误打印出来。我遇到过一次缩进错误UI 只提示文件不合法命令行直接告诉我第 18 行存在缩进问题一改就好。如果语法没问题再执行docker compose ps看状态用docker compose logs看应用日志。这条排查链路比你在 UI 里截图问人要快得多。5.3 为什么服务器重启后有些容器没有自动起来最常见的原因是 Compose 文件里漏写restart: unless-stopped或者写了但 UI 部署时被你误删了。另一个常见场景数据库容器起来了但应用容器依赖它数据库还没初始化完成应用启动几次失败进入 backoff 状态。这时候即使有restart策略容器也会不断重启但最终可能永远起不来。更稳妥的做法是在 Compose 里给 db 服务加健康检查并让 WordPress 依赖健康状态启动。这个配置稍复杂但对有状态的业务非常有用。小白阶段可以不用一步到位但要记住看到容器状态一直 Restarting不要反复点重启先看日志看它到底因为什么退出。docker inspect里 ExitCode 和 Error 字段也能提供线索。5.4 Docker socket 权限与安全这个必须单独说只要容器管理类 UI 挂载了/var/run/docker.sock它理论上就拥有 Docker 的全部权限等于宿主机 root 级别权限。这不是工具本身有问题而是架构使然。所以你把 UI 端口暴露在公网上就等于把一把钥匙插在门锁上。我的建议是服务器上用防火墙只允许内网 IP 或自己办公 IP 访问 5001 端口如果一定要公网访问就在前面套 Nginx 反向代理加上基本认证或更复杂的身份校验再启用 HTTPS。写到这里我再补一个自己的体会。给家里和几台云服务器装上 Dockge 之后我维护项目的频率反而变高了因为之前每次要看一眼状态都得 ssh 登录敲命令心理门槛太高现在打开浏览器就能看顺手就点几下。UI 并没有让我停止学习 compose反而因为在界面里能直接看到文件结构学得更快了。所以如果你还在犹豫“用了 GUI 是不是就不硬核了”我的答案是工具本来就是为了降低重复劳动硬核的是你理解原理的能力而不是你打字的速度。把 UI 当日常入口把命令行当排查底牌这套组合足够支撑你从小白一路玩到进阶。
阅读完成 · 觉得有帮助？
