群晖Docker部署Mosquitto无法访问日志文件的求助

问题概述 #

在群晖上通过Docker部署Mosquitto broker，已创建目标目录结构且手动生成mosquitto.log，但容器始终无法访问日志文件，调整目录所有权与权限后问题依旧。

部署命令 #

sudo docker run --name="mqtt" --restart=always --net=host -p 1883:1883 -p 9001:9001 -v /volume1/docker/mqtt/config:/mosquitto/config -v /volume1/docker/mqtt/log:/mosquitto/log -v /volume1/docker/mqtt/data:/mosquitto/data -tid eclipse-mosquitto

容器错误日志 #

Error: Unable to open log file /mqtt/log/mosquitto.log for writing.
Error: No such file or directory.

本地目录结构及权限 #

docker
|_ drwxrwxrwx  1     1883  1883  26 Jan  8 14:33 mqtt
|  |_ drwxrwxrwx 1 1883 1883 28 Jan 14 16:57 config
|  |  |_ -rwxrwxrwx 1 1883 1883 280 Jan 14 17:02 mosquitto.conf
|  |_ drwxrwxrwx 1 1883 1883  0 Jan  8 14:33 data
|  |_ drwxrwxrwx 1 1883 1883 26 Jan 14 17:09 log

Mosquitto配置文件内容 #

persistence true
persistence_location /mqtt/data/

log_dest stdout
log_dest file /mqtt/log/mosquitto.log
log_type warning
log_timestamp true
connection_messages true

注：未手动创建UID/GID为1883的用户或组。

解决方案 #

1. 修正配置文件路径映射错误 #

部署命令中将本地日志目录映射到了容器内的/mosquitto/log，但配置文件里写的日志路径是/mqtt/log/mosquitto.log——容器内不存在/mqtt目录，这是核心问题。
修改mosquitto.conf中的路径配置：

persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log

2. 验证容器内用户写入权限 #

Mosquitto容器默认以UID/GID为1883的mosquitto用户运行，虽然本地目录权限已设为1883:1883，但群晖DSM的权限机制可能存在特殊限制。可临时以root用户启动容器测试：

sudo docker run --name="mqtt" --restart=always --net=host -p 1883:1883 -p 9001:9001 -v /volume1/docker/mqtt/config:/mosquitto/config -v /volume1/docker/mqtt/log:/mosquitto/log -v /volume1/docker/mqtt/data:/mosquitto/data -u root -tid eclipse-mosquitto

如果测试正常，改回1883用户后，需在群晖DSM文件管理器中右键目标目录，通过「属性→权限」设置确保1883用户拥有写入权限。

3. 清理旧容器重新部署 #

停止并删除旧容器：

sudo docker stop mqtt && sudo docker rm mqtt

使用修正后的配置文件重新执行部署命令即可。

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