Node-RED Docker部署：flows.json与settings.js加载异常排查

问题1：Dockerfile复制文件后挂载卷无法加载自定义流 #

当运行容器时挂载/data卷（命名卷或本地目录），Docker会将容器内的/data目录替换为卷的内容。若卷为空，Docker会复制容器内/data的初始内容到卷，但你在Dockerfile中复制文件时是以root用户执行的，导致文件权限为root，而Node-RED以node-red用户运行，无读写权限，因此无法加载自定义流。

修复方案：调整Dockerfile确保文件权限正确 #

修改Dockerfile，在复制文件后将所有权更改为node-red用户：

FROM nodered/node-red:latest

# Set working directory
WORKDIR /usr/src/node-red

# Copy package.json and install dependencies (if any)
COPY package.json .
RUN npm install --unsafe-perm --no-update-notifier --no-fund --only=production

# Copy your flows.json and settings.js, then fix permissions
COPY flows.json /data/flows.json
COPY settings.js /data/settings.js
RUN chown -R node-red:node-red /data

# Set the user to node-red
USER node-red

# Expose port 1880 for Node-RED
EXPOSE 1880

# Start Node-RED
CMD ["npm", "start", "--", "--userDir", "/data"]

注意：如果之前已创建过node_red_data命名卷，卷内已有旧配置文件，Docker不会自动覆盖。需先删除旧卷再重新构建运行：

docker volume rm node_red_data
docker build -t my-node-red .
docker run -d -p 1880:1880 -v node_red_data:/data --name mynodered my-node-red

问题2：本地目录挂载出现权限错误 #

本地目录/home/user/node_red_data的所有者为主机pi用户，容器内node-red用户（默认UID为1000）无读写权限，导致Node-RED无法复制默认settings.js到目录。

修复方案1：调整本地目录权限 #

在主机上执行命令，将目录所有权改为与容器内node-red用户匹配的UID/GID（通常为1000:1000）：

sudo chown -R 1000:1000 /home/user/node_red_data

随后运行容器：

docker run -it -p 1880:1880 -v /home/user/node_red_data:/data --name mynodered nodered/node-red

修复方案2：运行容器时指定用户 #

若不想修改主机目录权限，可在运行容器时指定主机用户的UID/GID，让容器内进程以该身份运行：

docker run -it -p 1880:1880 -v /home/user/node_red_data:/data --user $(id -u):$(id -g) --name mynodered nodered/node-red

额外注意事项 #

• 若你的flows.json包含加密节点，需同步复制对应的flows_cred.json到/data目录，否则流加载可能异常。
• 验证settings.js是否生效，可通过Node-RED管理界面右上角菜单的Settings选项查看，或检查容器日志确认加载状态。

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