FileGator Docker环境下配置Guest用户全权限指南

背景说明

FileGator作为一款开源的Web文件管理器，其Docker部署方式为用户提供了便捷的安装体验。在实际部署中，有时需要为Guest用户赋予完整权限以满足特定场景需求（如内网环境使用）。本文将详细介绍如何通过修改配置文件实现这一目标。

技术实现方案

核心配置原理

FileGator的用户权限体系存储在users.json配置文件中，该文件位于容器内的/var/www/filegator/private/目录。通过修改该文件中的permissions字段，可以精确控制用户权限。

具体操作步骤

1. 定位配置文件 在宿主机上创建或修改本地的users.json文件，确保包含以下关键配置项：

   {
     "2": {
       "username": "guest",
       "name": "Guest",
       "role": "guest",
       "homedir": "/",
       "permissions": "read|write|upload|download|batchdownload|zip|chmod",
       "password": ""
     }
   }
   

2. 权限字段说明

   • read：查看文件/目录
   • write：编辑文件
   • upload：上传文件
   • download：下载文件
   • batchdownload：批量下载
   • zip：压缩/解压操作
   • chmod：修改权限

3. Docker Compose集成 在docker-compose.yml中添加volume挂载，将修改后的配置文件映射到容器内：

   volumes:
     - /宿主机路径/users.json:/var/www/filegator/private/users.json
   

高级配置建议

1. 权限最小化原则 虽然示例中授予了全部权限，但在生产环境中建议根据实际需求配置最小必要权限集。

2. 多用户配置 可以在同一配置文件中为不同用户设置差异化权限，只需在JSON结构中添加新的用户条目即可。

3. 配置持久化 建议将整个private目录通过volume持久化，避免容器重建时配置丢失：

   volumes:
     - /宿主机路径/private:/var/www/filegator/private
   

注意事项

1. 文件路径区分大小写，确保Docker中的挂载路径与容器内路径完全一致。

2. 修改配置文件后需要重启容器使变更生效。

3. 在离线环境中使用时，建议同时禁用用户注册功能，可通过设置环境变量实现。

通过以上配置，即可实现FileGator在Docker环境中自动为Guest用户赋予完整权限，满足特殊场景下的使用需求。