Nginx-UI项目Docker部署中LogDirWhiteList配置问题解析

在使用Docker部署Nginx-UI项目时，从v35版本升级到v36版本后，部分用户可能会遇到无法查看在线日志的问题。这个问题通常与日志目录白名单配置相关，需要正确配置LogDirWhiteList参数才能解决。

问题背景

Nginx-UI在v36版本中引入了更严格的日志目录访问控制机制。出于安全考虑，系统现在要求明确指定允许访问的日志目录路径。如果未正确配置这些白名单路径，即使日志文件实际存在，用户界面也无法显示日志内容。

解决方案

对于Docker部署的用户，可以通过以下两种方式配置LogDirWhiteList：

1. 通过环境变量配置： 在docker-compose.yml文件中添加环境变量：

   environment:
     - NGINX_UI_NGINX_LOG_DIR_WHITE_LIST=/var/log/nginx/
   

   多个路径可以用逗号分隔。

2. 通过配置文件修改： 如果已经做了数据持久化，需要手动编辑app.ini配置文件，在[nginx]部分添加：

   [nginx]
   log_dir_white_list = /var/log/nginx/
   

注意事项

1. 确保配置的路径与实际Nginx日志存储路径一致
2. 路径末尾的斜杠(/)不是必须的，但建议保持一致
3. 修改配置后需要重启Nginx-UI服务使更改生效
4. 对于生产环境，建议只开放必要的日志目录，不要使用过于宽泛的路径

最佳实践

对于大多数标准Nginx安装，推荐配置：

log_dir_white_list = /var/log/nginx

如果使用自定义日志路径，需要相应调整。配置完成后，建议先测试日志查看功能是否恢复正常，再部署到生产环境。

通过正确配置LogDirWhiteList参数，用户可以既保证系统的安全性，又能正常使用Nginx-UI的日志查看功能。