重启后Docker容器无法访问串口/dev/ttyACM0问题求助

以下是针对系统重启后Docker容器无法访问/dev/ttyACM0问题的排查和修复方向：

1. 解决设备延迟加载导致容器启动过早的问题 #

系统重启后，USB串口设备（如ttyACM0）需要几秒时间才能被udev识别并创建设备节点。而你的容器设置了restart: always，会在系统启动后立刻拉起，此时设备可能还未就绪，导致映射失效。

修改容器启动命令，先等待设备就绪再执行ROS启动脚本：

command: /bin/bash -c "until [ -c /dev/ttyACM0 ]; do sleep 1; done && source devel/setup.bash && roslaunch ugv2 ugv_bringup.launch"

该命令会循环检查/dev/ttyACM0是否为有效字符设备，直到设备就绪后再继续执行后续操作。

2. 为串口设备设置固定别名（避免动态命名变化） #

重启后USB串口设备的命名可能因枚举顺序变化而改变（比如从ttyACM0变成ttyACM1），导致固定的设备映射失效。可以通过udev规则为设备绑定固定别名：

1. 在主机上查看设备的厂商和产品ID：

lsusb

找到目标串口设备，记录类似ID xxxx:yyyy的信息。

2. 创建udev规则文件/etc/udev/rules.d/99-ugv-serial.rules，内容如下：

SUBSYSTEM=="tty", ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="yyyy", SYMLINK+="ugv_serial", MODE="0666"

将xxxx和yyyy替换为你设备的实际ID，MODE="0666"确保所有用户都能访问该设备。

3. 重新加载udev规则并触发设备重识别：

sudo udevadm control --reload-rules
sudo udevadm trigger

之后设备会生成固定软链接/dev/ugv_serial，修改docker-compose.yml中的设备映射：

devices:
  - "/dev/ugv_serial:/dev/ugv_serial"

同时将ROS启动脚本中的串口路径改为/dev/ugv_serial。

3. 验证容器内设备权限 #

即使设置了privileged: true，也可能存在权限问题：

• 在主机上执行ls -l /dev/ttyACM0，确认设备所属组为dialout，并将主机用户加入该组：

sudo usermod -aG dialout $USER

• 可以临时修改容器启动命令来调试设备状态：

command: /bin/bash -c "ls -l /dev/ttyACM0 && source devel/setup.bash && roslaunch ugv2 ugv_bringup.launch"

查看容器日志中的设备权限信息，确认是否存在访问限制。

4. 替换Privileged模式为精细权限控制 #

全特权模式虽能解决大部分权限问题，但可以尝试更安全的配置，仅添加串口访问所需的Linux能力：

privileged: false
cap_add:
  - CAP_SYS_RAWIO
devices:
  - "/dev/ttyACM0:/dev/ttyACM0"

这种方式比privileged: true更安全，同时能满足串口访问的权限需求。

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