CentOS 上 Dolphin 的常见问题整理
在 CentOS 环境中，Dolphin 一词常见有三种指代：
- Dolphin（KDE 文件管理器）
- DolphinDB（分布式数据库）
- DolphinScheduler（工作流调度平台）
以下按这三类分别梳理高频问题与处理要点，便于快速定位与解决。
Dolphin 文件管理器
- 安装与启动
- 在 CentOS 7/8 的桌面环境（如 GNOME/KDE）中，先启用 EPEL 仓库后安装：sudo yum install -y epel-release && sudo yum install -y dolphin；无图形界面时无法使用 GUI。
- 常用命令：启动 dolphin；打开目录 dolphin /path；内置终端 dolphin --terminal；查看帮助 dolphin --help。
- 常见故障
- 命令未找到：多为未安装或 PATH 问题，确认已安装并在桌面会话中调用。
- 无法启动或界面异常：检查是否安装了完整的 KDE/Qt 依赖；查看系统日志（如 journalctl）获取报错线索。
- 作为默认文件管理器：执行 xdg-mime default dolphin.desktop inode/directory application/x-gnome-saved-search（不同桌面可能需要微调）。
DolphinDB 数据库
- 安装与端口
- RPM 安装：sudo yum install dolphindb-.rpm；启动/自启/状态：sudo systemctl start|enable|status dolphindb；默认监听 8848。
- Docker 运行：docker run -d --name dolphindb -p 8848:8848 dolphindb/dolphindb。
- 配置与数据目录
- 配置文件路径：/usr/local/dolphindb/conf/dolphindb.cfg；常见项：listenPort、maxConnections、dataDir、logDir。
- 持久化建议：将数据/日志/配置挂载到宿主机目录，便于备份与迁移。
- 常见故障
- 端口冲突：ss -tunlp | grep 8848 查占用，kill 或调整 listenPort。
- 权限问题：确保运行用户对配置、数据、日志目录具备读写权限（chown/chmod）。
- 依赖/启动失败：检查系统更新、依赖包，查看日志（journalctl -xe 或服务日志）。
DolphinScheduler 工作流调度
- 兼容性与版本
- CentOS 7.x 对 DolphinScheduler 3.2.0 的适配度更好；
- CentOS 8.x 部署早期版本（如 1.2.1）时常见 Python 2.7/3.x 不匹配，需按官方要求安装对应版本或做兼容改造。
- 常见故障
- 依赖缺失/版本冲突：按官方文档补齐依赖，避免随意升级导致运行期异常。
- 权限/运行问题：特别是 Docker 场景，注意用户命名空间、目录挂载权限与 SELinux 策略。
- 升级/迁移问题：跨小版本或跨系统迁移时，易出现 数据库连接 与元数据不一致，需提前备份并充分回归测试。
快速排查清单
- 明确对象：先确认是 文件管理器 / 数据库 / 调度平台，避免命令与文档错配。
- 看日志：优先查看服务日志与系统日志（如 journalctl -xe），定位报错时间点与模块。
- 查端口与进程：ss -tunlp | grep <端口>；必要时 kill 占用进程后重启服务。
- 校验配置与权限：核对关键配置（如 8848、dataDir、logDir）与目录权限（chown/chmod）。
- 依赖与环境：桌面组件、Qt/KDE、Python 版本、容器与存储驱动等是否满足版本要求。
- 持久化与备份：数据库与调度平台的配置、数据与元信息务必定期备份，变更前先快照/导出。