【Docker项目实战】使用Docker部署FileRise文件管理器一、FileRise介绍1.1 FileRise简介1.2 FileRise主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取FileRise镜像五、部署FileRise容器5.1 创建部署目录5.2 编辑部署文件5.3 创建FileRise容器5.4 查看FileRise容器状态5.5 查看FileRise容器日志六、访问FileRise服务七、FileRise基本使用7.1 创建文件目录7.2 上传文件八、总结一、FileRise介绍1.1 FileRise简介FileRise是一个轻量级、自托管的网页文件管理器采用 PHP 与 JavaScript 构建支持 Docker 和 Unraid 部署。它提供了一个现代化的 Web 界面用于上传、编辑、管理和共享服务器上的文件和文件夹就像个人云盘一样便捷且安全。1.2 FileRise主要特点 轻松上传文件支持拖放上传、多文件/文件夹上传并具备断点续传功能提升大文件传输成功率。️ 文件管理提供完整的文件与文件夹操作功能包括移动、复制、重命名、批量删除及 ZIP 打包下载。️ 文件夹与文件共享可创建带密码保护、有效期的公共链接分享文件或文件夹支持外部用户安全上传。 WebDAV 支持支持通过 WebDAV 协议挂载为网络驱动器兼容多种客户端工具如 Cyberduck、WinSCP。 API 文档提供自动生成的 OpenAPI 接口文档和交互式 HTML 文档便于集成与二次开发。 内置编辑器和预览 支持在浏览器中查看图像、视频、音频、PDF并使用 CodeMirror 编辑文本和代码文件。️ 标签与搜索 支持为文件添加颜色标签并可通过文件名、标签、内容进行实时模糊搜索。 用户身份验证与权限控制 提供用户名/密码登录、角色权限控制、两步验证TOTP并支持 OIDC 单点登录SSO。 响应式用户界面深色/浅色模式 支持响应式布局适配手机和平板提供深色/浅色主题切换界面个性化记忆设置。 国际化与本地化支持英文、西班牙语、法语、德语等语言切换并自动保存用户的语言偏好。️ 回收站与文件恢复 删除文件会先进入回收站管理员可手动恢复或清空系统自动清理过期文件。⚙️ 轻量且自包含无需数据库数据以文件形式存储部署简单资源占用低适合各种小型到中型服务器环境。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为Ubuntu 22.04.1。hostnameIP地址操作系统版本Docker版本部署项目jeven01192.168.3.88Ubuntu 22.04.1 LTS27.1.1FileRise2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署FileRise文件管理器。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven01:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/lib/systemd/system/docker.service;enabled;vendor preset: enabled)Active: active(running)since Wed2025-07-0214:16:57 UTC;21h ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:878(dockerd)Tasks:28Memory:1.2G CPU: 1min50.356s CGroup: /system.slice/docker.service ├─878/usr/bin/dockerd-Hfd://--containerd/run/containerd/containerd.sock3.2 检查Docker版本检查Docker版本rootjeven01:~# docker -vDocker version27.1.1, build63125853.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven01:~# docker compose versionDocker Compose version v2.19.1四、拉取FileRise镜像拉取FileRise相关容器镜像如下所示dockerpull error311/filerise-docker五、部署FileRise容器5.1 创建部署目录创建部署目录mkdir-p/data/filerise/{metadata,uploads,users}cd/data/filerise挂载目录授权chmod-R777/data/filerise/5.2 编辑部署文件在部署目录下创建docker-compose.yaml文件如下所示vimdocker-compose.yamlversion:3services:web:image:error311/filerise-docker:latestcontainer_name:fileriserestart:alwaysports:-6300:80volumes:-./uploads:/var/www/uploads-./users:/var/www/users-./metadata:/var/www/metadataenvironment:-TZAsia/Shanghai-TOTAL_UPLOAD_SIZE5G-SECUREfalse-PERSISTENT_TOKENS_KEYdefault_please_change_this_key 挂载目录Volumes宿主机路径容器内路径说明./uploads/var/www/uploads存放用户上传的文件如图片、文档等。持久化该目录可防止容器删除后数据丢失。./users/var/www/users存储用户账户信息如用户名、密码哈希、权限等用于身份验证和权限控制。./metadata/var/www/metadata存储文件元数据如标签、共享链接设置、回收站记录等。保持数据一致性与恢复能力。 环境变量Environment Variables变量名值示例 / 含义TZAsia/Shanghai设置容器时区为中国上海时间确保日志、上传时间戳等显示正确的时间。TOTAL_UPLOAD_SIZE5G设置所有用户总共允许上传的最大文件容量为 5GB。SECUREfalse是否启用安全模式。若为true则可能限制某些敏感操作如删除/重命名等。PERSISTENT_TOKENS_KEYdefault_please_change_this_key用于加密持久化令牌的密钥。建议在生产环境中更改为强随机字符串以增强安全性。5.3 创建FileRise容器执行以下命令创建FileRise容器。dockercompose up-d5.4 查看FileRise容器状态检查FileRise容器运行状态确保FileRise容器正常启动。rootjeven01:/data/filerise# docker compose psWARN[0000]/data/filerise/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS filerise error311/filerise-docker:latest/usr/local/bin/star…web56minutes ago Up56minutes443/tcp,0.0.0.0:6300-80/tcp,[::]:6300-80/tcp5.5 查看FileRise容器日志检查FileRise容器运行日志确保FileRise服务正常运行。rootjeven01:/data/filerise# docker compose logsWARN[0000]/data/filerise/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion filerise| Running start.sh... filerise|⚠️ WARNING: Using default persistent tokens key—overrideforproduction. filerise| Updating config.php fromenvvars... filerise| Setting PHP upload limits to 5G filerise| Setting Apache LimitRequestBody to5368709120bytes filerise| Starting Apache... rootjeven01:/data/filerise#六、访问FileRise服务浏览器地址http://个人的服务器IP:6300访问FileRise的初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。勾选【 Grant Admin Access】选项开始创建账号。填写刚才注册的账号密码登录FileRise首页。七、FileRise基本使用7.1 创建文件目录点击右侧的创建目录图标自定义填写目录名称确认创建。7.2 上传文件将本地文件上传到创建的好的Linux目录如下所示八、总结通过本次实战部署FileRise文件管理器我们掌握了使用Docker快速构建应用运行环境的方法。整个部署过程简洁高效体现了Docker在简化服务安装与配置方面的优势。FileRise的轻量化设计和直观操作为本地文件管理提供了良好体验。此次实践进一步加深了对容器化技术应用的理解与操作能力。