5分钟极速上手！Docker部署DolphinScheduler单机版（standalone）

哈喽各位开发者、运维小伙伴👋

日常开发、测试、个人学习场景中，我们经常需要一款轻量易用的任务调度框架，用来定时执行脚本、调度数据同步、运行自动化任务。Apache DolphinScheduler 作为开源分布式、高可靠的工作流调度平台，功能完全不输传统调度工具，而它的standalone 单机版 更是为轻量化场景量身打造。

相比于复杂的集群部署，dolphinscheduler-standalone-server 无需单独部署数据库、Zookeeper，一键即可启动，非常适合本地测试、小型服务调度、新手入门学习。

今天这篇博文，就带大家通过 Docker 极简部署 DolphinScheduler 单机版，全程无复杂配置、无踩坑，新手也能一次成功！

一、为什么选择 Standalone 单机版？

很多小伙伴疑惑：调度工具为什么不选轻量的定时工具，非要部署 DolphinScheduler？这里给大家说下核心优势，以及单机版的适用场景：

• 极简架构：Standalone 模式整合了 Master、Worker、UI、数据库、注册中心，无需额外依赖组件，单容器即可运行
• 开箱即用：省去集群搭建、节点配置、组件联动调试，部署效率提升10倍
• 功能完整：保留工作流编排、定时调度、任务监控、日志查看、失败重试等核心功能
• 场景适配：完美适配本地开发调试、个人学习、小型项目调度、测试环境使用

⚠️ 注意：standalone 单机版仅适用于测试、开发、轻量生产场景，高并发、高可用的正式生产环境，建议使用集群模式部署。

二、部署前置环境

本次部署适配 Linux、Mac、Windows(WSL2) 全平台，仅需满足一个基础条件：

✅ 服务器/本地电脑已安装 Docker（推荐20.10及以上版本）

执行以下命令验证 Docker 环境，正常输出版本号即可：

docker -v

Windows 用户务必开启 WSL2 后端，Mac 用户建议分配4GB以上内存，避免容器启动内存不足。

三、Docker 一键部署完整步骤

我们采用官方镜像部署，稳定无魔改，全程仅需3步，超级简单！

1. 拉取官方镜像

DolphinScheduler 官方提供 standalone 专属镜像，我们选择稳定版（本文以最新稳定版 3.2.1 为例，可按需替换版本号）：

# 拉取dolphinscheduler单机版镜像
docker pull apache/dolphinscheduler-standalone-server:3.2.1

等待镜像拉取完成，网络较慢的小伙伴可耐心等待，镜像大小适中。

2. 启动容器服务

执行以下启动命令，一键运行容器，同时完成端口映射、数据持久化配置，避免容器删除数据丢失：

# 创建数据持久化目录（避免数据丢失）
mkdir -p ~/dolphinscheduler/data ~/dolphinscheduler/logs

# 启动DolphinScheduler单机容器
docker run -d \
  --name dolphinscheduler-standalone \
  -p 12345:12345 \
  -v ~/dolphinscheduler/data:/opt/dolphinscheduler/data \
  -v ~/dolphinscheduler/logs:/opt/dolphinscheduler/logs \
  --restart always \
  apache/dolphinscheduler-standalone-server:3.2.1

命令参数详解（新手必看）：

• -d：后台守护进程运行容器
• –name：自定义容器名称，方便后续管理
• -p 12345:12345：端口映射，12345 为 DolphinScheduler UI 访问端口
• -v 挂载目录：将容器内数据、日志挂载到本地，实现数据持久化
• –restart always：开机自启、容器异常自动重启，保证服务稳定

3. 查看容器启动状态

执行命令查看容器是否正常运行：

docker ps | grep dolphinscheduler

若看到容器状态为 Up，说明启动成功。首次启动需要初始化数据库、加载配置，等待30秒-1分钟再访问页面，避免连接失败。

四、访问Web管理控制台

容器启动完成后，直接通过浏览器访问UI界面：

🌐 访问地址：http://服务器IP:12345 本地访问：http://localhost:12345

默认登录账号密码

• 用户名：admin
• 密码：dolphinscheduler123

登录成功后，即可看到干净简洁的调度控制台，支持创建项目、定义工作流、配置定时任务、查看运行日志、监控任务状态，所有核心功能全部可用。

五、常用运维命令（收藏备用）

部署完成后，日常运维常用命令整理好了，直接复制使用：

# 查看容器日志（排查启动异常、任务报错）
docker logs -f dolphinscheduler-standalone

# 重启服务
docker restart dolphinscheduler-standalone

# 停止服务
docker stop dolphinscheduler-standalone

# 进入容器内部
docker exec -it dolphinscheduler-standalone bash

# 删除容器（保留本地数据，不会丢失任务数据）
docker rm -f dolphinscheduler-standalone

六、常见问题排查

1. 端口12345被占用无法启动

修改启动命令的端口映射，例如改为 -p 12346:12345，访问时使用新端口即可。

2. 浏览器访问页面空白/无法连接

大概率是服务未初始化完成，等待1分钟后重试；若依旧无法访问，查看容器日志排查报错，同时检查服务器防火墙、安全组是否放行12345端口。

3. 任务运行失败、日志异常

优先查看本地挂载的 ~/dolphinscheduler/logs 目录日志，精准定位脚本错误、权限不足、资源缺失等问题。

七、总结

通过 Docker 部署 dolphinscheduler-standalone-server，真正实现了 零配置、5分钟极速部署，彻底告别传统集群部署的繁琐配置。

对于新手学习、本地开发、小型项目调度场景，单机版完全够用，轻量化、稳定、易维护，是入门 DolphinScheduler 的最佳方式。后续熟悉功能后，再按需升级为集群模式适配生产高可用场景即可。

✨ 码字不易，欢迎点赞收藏！后续会持续更新DolphinScheduler工作流编排、定时任务配置、实战场景教程，感兴趣可以关注一波～