Docker容器无法读取Serial设备，如何在非privileged模式下解决？

排查前提 #

主机端通过socat能正常获取串口数据，波特率匹配且无报错，问题核心是容器内进程无串口访问权限。以下是无需privileged标志的解决方法：

步骤1：确认主机串口的用户组信息 #

在主机执行命令，查看串口设备的所属组及组ID：

ls -l /dev/ttyS1
# 输出示例：crw-rw---- 1 root dialout 4, 65 ...
getent group dialout
# 输出示例：dialout:x:20:

记下输出中的组名（如dialout）和组ID（如20）。

方法1：在Dockerfile中预配置权限 #

修改镜像构建文件，将容器内用户加入串口所属组：

# 创建与主机串口组ID匹配的用户组
RUN groupadd -g 20 dialout

# 若使用普通用户运行应用，创建用户并添加到组
RUN useradd -m appuser && usermod -aG dialout appuser
USER appuser

# 若直接用root用户，仅需添加到组
# RUN usermod -aG dialout root

重新构建镜像后启动容器，进程将自动获得串口访问权限。

方法2：启动容器时动态添加用户组 #

无需修改镜像，启动时通过--group-add参数指定主机串口的组ID：

docker run -it --device /dev/ttyS1:/dev/ttyS1 --group-add 20 my-image:latest

该命令会将容器内的进程加入指定组，直接获得串口读写权限。

方法3：临时放宽设备映射权限（不推荐） #

启动容器时显式指定设备的权限模式为rwm（读、写、修改）：

docker run -it --device /dev/ttyS1:/dev/ttyS1:rwm my-image:latest

此方法虽能快速解决，但会放宽设备权限，仅适合临时测试场景。

验证操作 #

启动容器后，执行以下命令确认权限：

ls -l /dev/ttyS1

若当前用户对应的权限位包含rw-，则权限配置生效，运行Python代码即可正常读取串口数据。

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