Docker中/dev/tty*权限问题：Arduino开发镜像串口通信失败排查

我之前在做Arduino相关的Docker镜像时也踩过这个串口权限的坑，核心问题就是Docker容器里的进程默认没有权限访问宿主机的串口设备（比如/dev/ttyUSB0这类），下面给你几个实用的解决办法：

方法1：启动容器时动态映射用户组权限 #

这是最灵活且推荐的方式，因为宿主机的dialout用户组（串口设备默认归属的组）ID可能因系统而异：

1. 先在宿主机上查询dialout组的ID：

getent group dialout | cut -d: -f3

比如你会得到类似20的数字。

2. 启动容器时，挂载串口设备并添加对应组权限：

docker run -it --device=/dev/ttyUSB0 --group-add [你的dialout组ID] your-arduino-image

替换[你的dialout组ID]为第一步得到的数字，这样容器内的进程就拥有访问串口的权限了。

方法2：在Dockerfile中预配置用户组 #

如果你想把权限配置整合到镜像里，可以在Dockerfile中添加以下步骤（假设你要创建一个普通用户来操作Arduino）：

# 创建与宿主机dialout组ID匹配的用户组（这里以20为例，需根据实际调整）
RUN groupadd -g 20 dialout
# 创建普通用户并加入dialout组
RUN useradd -m -u 1000 -g dialout arduino
# 若需要sudo权限，可添加这一步
RUN echo "arduino ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
# 切换到该用户运行后续命令
USER arduino

启动容器时依然需要挂载串口设备：

docker run -it --device=/dev/ttyUSB0 your-arduino-image

⚠️ 注意：这里的组ID必须和宿主机的dialout组ID一致，否则权限问题依然存在，所以更推荐方法1的动态映射。

方法3：临时放宽宿主机串口权限（不推荐） #

如果只是临时测试，也可以直接修改宿主机上串口设备的权限：

sudo chmod 666 /dev/ttyUSB0

之后启动容器挂载设备即可正常访问。但这种方法安全性差，设备重启后权限会重置，且所有用户都能访问串口，不适合生产环境。

验证串口连通性 #

容器启动后，你可以用已安装的picocom测试串口是否正常：

picocom /dev/ttyUSB0 -b 9600

如果能进入串口终端，说明权限问题已经解决。

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