CentOS 上 Dolphin 常见问题与解决方案
先确认所指的 Dolphin 类型
- Dolphin 文件管理器（KDE）：图形环境下的文件管理工具，常见于 KDE Plasma 桌面。
- DolphinDB（数据库）：分布式时序数据库，常以服务方式运行，默认端口 8848。
- DolphinScheduler（工作流调度平台）：大数据场景的任务编排系统，部署依赖较多。
- Dolphin Emulator（模拟器）：GameCube/Wii 模拟器，涉及用户目录与路径配置。
下文按这四类分别给出高频问题与处理要点。
Dolphin 文件管理器（KDE）
- 安装与启用
- 安装与启动：sudo yum install -y dolphin；终端输入 dolphin 启动。
- 设为默认文件管理器：xdg-mime default dolphin.desktop inode/directory application/x-gnome-saved-search（不同桌面可能需要微调）。
- 常见故障
- 启动报错或“kioslave5 已经意外关闭”、标签协议错误：多与用户配置损坏相关。处理思路：备份后清理 ~/.config 下相关配置或新建测试用户验证；必要时重装 dolphin 与相关 KDE 组件。
- 与其他文件管理器冲突或默认程序异常：用 yum/dnf check 检查冲突，必要时 yum/dnf remove 冲突包后重装；也可临时改用 Nautilus/Thunar 并设为默认以规避问题。
DolphinDB（数据库）
- 安装与启动
- RPM 安装：sudo yum install -y dolphindb-.rpm；启动与自启：sudo systemctl start|enable dolphindb。
- Docker 运行：docker run -d --name dolphindb -p 8848:8848 dolphindb/dolphindb。
- 配置与排错
- 配置文件：/usr/local/dolphindb/conf/dolphindb.cfg（如 listenPort=8848、dataDir、logDir 等）；修改后重启服务生效。
- 端口冲突：ss -tunlp | grep 8848 定位占用进程并释放或调整端口。
- 权限与目录：确保运行用户对 dataDir/logDir 具备读写权限（chown/chmod）。
- 日志与诊断：journalctl -xe 查看服务日志；必要时使用 dolphindb -check-config 校验配置。
DolphinScheduler（工作流调度）
- 兼容性要点
- 驱动/运行环境：如涉及 CUDA/NVIDIA 需核对驱动与 CUDA 版本匹配。
- 权限问题：容器或脚本执行权限不足时，核对用户、组与 sudo 策略。
- 依赖库：按官方文档补齐 Python/Java/数据库驱动 等依赖版本。
- 版本兼容：部分功能可能依赖特定组件版本，部署前以官方兼容矩阵为准。
Dolphin Emulator（模拟器）
- 路径与权限
- 用户目录：默认在 ~/.dolphin-emu；确保目录存在并可写（mkdir -p 创建缺失目录）。
- 存档与配置：常见子目录如 GC/USA|EUR|JAP、Wii/title；权限建议：chmod 755 ~/.dolphin-emu；chmod -R 644 ~/.dolphin-emu/*。
- 路径规范：避免路径包含空格或非 ASCII 字符，减少异常与崩溃概率。
- 自定义路径与便携模式
- 命令行指定用户目录：./dolphin-emu --user=“/path/to/your/dolphin/data”。
- 环境变量：export DOLPHIN_EMU_USERPATH=“/path/to/your/dolphin/data”。
- 便携模式：在可执行文件同级创建 portable.txt（内容可为空），自动使用当前目录下的 User 子目录。
