如何允许 Systemd 守护进程运行 DBus 服务

本文旨在解决 Systemd 守护进程无法提供 DBus 服务的问题。通过分析错误信息，明确问题根源在于守护进程尝试连接错误的 DBus 总线（session bus），以及 Systemd 配置不当。文章将提供详细步骤，指导读者正确配置 Systemd 单元文件和 DBus 配置文件，从而使守护进程能够成功注册并提供 DBus 服务。同时，也会介绍如何配置 DBus 的按需启动服务。

理解问题：Systemd 服务与 DBus 总线

当你在使用 Systemd 管理守护进程，并希望它提供 DBus 服务时，可能会遇到 "Error org.freedesktop.DBus.Error.ServiceUnknown: The name org.example.dirswatcher was not provided by any .service files" 这样的错误。这个错误通常意味着两件事：

1. 没有具有指定名称的服务正在运行。
2. DBus 尝试按需启动该服务，但无法找到正确的 .service 文件来执行此操作。

然而，如果你已经配置了 Systemd 单元文件，并且守护进程处于 "activating" 状态，那么问题可能不是 DBus 无法启动服务，而是服务启动后无法正确注册 DBus 服务。

关键原因：错误的 DBus 总线

最常见的原因是，你的程序试图连接到会话总线（session bus），但你却将其作为系统服务运行。系统服务无法访问会话总线。即使你设置了 User= 参数，也无法解决这个问题。会话总线通常用于用户级别的服务，例如与 GUI 交互的程序，而系统总线则用于运行在 root 或专用守护进程帐户下的系统级服务。

解决方案：选择正确的总线和配置

要解决此问题，你需要确定你的守护进程是用户级别的服务还是系统级别的服务，并进行相应的配置。

1. 用户级别服务

如果你的守护进程是用户级别的服务，例如与 GUI 交互的程序，则应执行以下操作：

• 移除系统总线配置文件： 删除 /etc/dbus-1/system.d/org.example.dirswatcher.conf 文件。会话总线默认情况下没有名称限制，因此不需要此文件。
• 转换 Systemd 单元文件为用户单元文件： 将 .service 文件移动到 /etc/systemd/user 或 ~/.config/systemd/user/ 目录。
• 移除 User= 参数： 从 .service 文件中删除 User= 参数。
• 更改 WantedBy 目标： 将 WantedBy=multi-user.target 更改为 WantedBy=default.target。
• 使用 systemctl --user 控制服务： 使用 systemctl --user start dirswatcher.service 等命令来控制服务。

以下是一个用户级别的 Systemd 单元文件示例：

可图大模型

可图大模型（Kolors）是快手大模型团队自研打造的文生图AI大模型

110

查看详情

[Unit]
Description=Dirs watcher
After=network.target

[Service]
ExecStart=/usr/bin/python3 /home/user/file-manager/daemon/dirswatcherd.py
Restart=always

[Install]
WantedBy=default.target

2. 系统级别服务

如果你的守护进程是系统级别的服务，则应确保你的程序尝试连接到系统总线。这通常需要在你的 Python 代码中进行配置。

注意事项：

• 检查 Systemd 日志：使用 journalctl -b -u dirswatcher 命令检查 Systemd 日志，以了解服务启动失败的原因。
• 修复拼写错误：确保你的 DBus 服务名称在配置文件和代码中一致。例如，将 org.exmaple 更正为 org.example。

可选项：配置 DBus 按需启动服务

如果你希望 DBus 能够按需启动你的服务，则需要创建一个 DBus 服务文件，该文件将 DBus 服务名称与可执行文件或 Systemd 服务关联起来。

• 系统服务： 将服务文件放置在 /usr/[local/]share/dbus-1/system-services/ 目录中。
• 用户服务： 将服务文件放置在 ~/.local/share/dbus-1/services/ 目录中。

以下是一个 DBus 服务文件示例：

~/.local/share/dbus-1/services/org.example.dirswatcher.service
[D-BUS Service]
Name=org.example.dirswatcher
# For direct (non-systemd) start; required but may be /bin/false to require systemd
Exec=/home/user/file-manager/daemon/dirswatcherd.py
# For indirect (systemd) start; optional
SystemdService=dirswatcherd.service

在这个文件中：

• Name 指定了 DBus 服务名称。
• Exec 指定了要执行的可执行文件（如果直接启动服务）。
• SystemdService 指定了要启动的 Systemd 服务（如果使用 Systemd 启动服务）。

总结

通过选择正确的 DBus 总线，并正确配置 Systemd 单元文件和 DBus 配置文件，你可以成功地让 Systemd 守护进程提供 DBus 服务。记住，用户级别的服务应该使用会话总线，而系统级别的服务应该使用系统总线。始终检查 Systemd 日志，以了解服务启动失败的原因。

以上就是如何允许 Systemd 守护进程运行 DBus 服务的详细内容，更多请关注php中文网其它相关文章！