Ubuntu下无根Docker容器访问主机串口设备权限问题咨询

你的问题核心是无根Docker的用户命名空间隔离导致主机与容器的组ID映射不匹配，进而无法访问串口设备。以下是具体解决方案：

1. 先确认主机dialout组的实际GID #

主机的dialout组GID可能和容器内的同名组GID不一致，首先在主机上执行：

getent group dialout

输出类似dialout:x:20:your-username，这里的20就是我们需要的主机dialout组GID。

2. 运行容器时指定映射主机的dialout GID #

放弃用--group-add dialout（因为容器内组名对应的GID和主机不匹配），直接使用主机的dialout GID：

docker run -it --entrypoint /bin/sh --device /dev/ttyACM0 --group-add 20 koenkk/zigbee2mqtt -c "ls -halt /dev/ttyACM0 && groups"

这个命令会让容器内的用户加入GID为20的组，和主机串口设备的组权限匹配，从而获得访问权限。

3. 补充：用device-cgroup-rule放宽设备访问权限 #

如果上述方法仍不生效，可以通过--device-cgroup-rule直接授权容器对目标串口设备的访问权限：

docker run -it --entrypoint /bin/sh --device /dev/ttyACM0 --device-cgroup-rule 'c 166:* rmw' koenkk/zigbee2mqtt -c "ls -halt /dev/ttyACM0"

其中166是你串口设备的主设备号（从ls -halt /dev/ttyACM0输出的166, 0获取），rmw代表允许读、写、创建设备操作。

为什么原来的方法无效？ #

• 无根Docker默认启用用户命名空间隔离，容器内的用户/组ID是经过映射的，和主机的ID不直接对应，所以用组名dialout无法正确匹配到主机的权限组。
• 串口设备的权限由主机控制，容器内无法直接修改设备权限，必须通过Docker参数让容器内的用户获得对应主机组的权限映射。

Docker完全支持无根模式下的设备访问，你之前遗漏了主机与容器组ID的显式映射这一步，而非Docker本身不支持该场景。

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