Docker容器以systemd为PID1时，systemctl --user执行失败如何解决？

问题原因 #

• 用户级DBus总线未初始化：systemctl --user依赖用户专属的DBus会话总线，但容器以systemd为PID1启动时，默认仅初始化系统级服务，不会自动启动用户会话的DBus服务，也不会创建对应的套接字文件。
• 缺失用户会话环境变量：docker exec默认不会加载用户的会话环境，关键变量XDG_RUNTIME_DIR未设置——这个变量指向用户运行时文件目录，DBus总线套接字就存放在这里，没有它systemctl --user找不到总线地址。
• 用户级systemd进程未启动：每个用户需要对应一个systemd --user进程来管理用户级服务，容器启动时默认不会为root或普通用户启动这个进程。

解决办法 #

方法1：手动初始化用户会话（临时生效） #

进入容器后依次执行以下命令：

# 创建并设置用户运行时目录权限（以root用户为例，UID为0）
mkdir -p /run/user/0
chmod 0700 /run/user/0

# 导出必要环境变量
export XDG_RUNTIME_DIR=/run/user/0
export DBUS_SESSION_BUS_ADDRESS=unix:path=$XDG_RUNTIME_DIR/bus

# 启动用户级systemd进程
systemd --user &

# 验证是否可用
systemctl --user list-units

方法2：容器启动时自动初始化用户会话（永久生效） #

1. 在容器镜像中创建初始化脚本/usr/local/bin/init-user-session.sh：

#!/bin/bash
# 初始化root用户的运行时环境
mkdir -p /run/user/0
chmod 0700 /run/user/0
export XDG_RUNTIME_DIR=/run/user/0

# 启动用户级systemd
systemd --user &

# 启动系统级systemd（原ENTRYPOINT命令）
exec /lib/systemd/systemd systemd.unit=multi-user.service

2. 给脚本添加执行权限：

chmod +x /usr/local/bin/init-user-session.sh

3. 将容器的ENTRYPOINT改为这个脚本，这样启动容器时会自动完成用户会话初始化。

方法3：通过machinectl进入用户会话 #

如果容器内安装了systemd-container包，可直接用machinectl进入完整的用户会话，自动加载所需环境和服务：

# 在容器内执行
machinectl shell root@.host
# 进入会话后直接使用systemctl --user
systemctl --user status

内容的提问来源于stack exchange，提问作者AnthonyGP