ryantj/xfilemanager

XFileManager

🗂️ 把服务器、NAS 和团队文件资产，变成一个安全、顺手、可协作的 Web 文件中心。

XFileManager 是一套为个人服务器、NAS、家庭实验室和团队内网打造的现代化 Web 文件管理系统。它不只是“浏览文件”的网页面板，而是把 文件管理、权限控制、WebDAV 挂载、外链分享、媒体预览、审计日志、回收站和存储挂载 整合到一个可 Docker 一键部署的私有文件工作台。

无论你是在 Unraid、群晖/类 NAS、VPS、家庭服务器，还是企业内网环境中管理文件，XFileManager 都可以作为统一入口：用浏览器完成日常文件操作，用 WebDAV 连接桌面和移动端，用权限和审计守住边界。

✨ 核心特点

• 🗂️ 现代化文件管理体验
  像使用桌面文件管理器一样管理服务器文件：浏览、上传、下载、新建、重命名、复制、移动、删除、批量选择、批量重命名、在线文本编辑和 chmod 权限修改，一套界面完成高频操作。

• 🚀 为大文件和批量任务而生
  支持分片上传、分片检查、后台扫描、URL 离线下载，以及复制 / 移动 / 压缩 / 解压等任务进度追踪。面对大目录、大文件和长时间任务，不再只能盯着终端猜结果。

• 👥 多用户与细粒度权限
  支持管理员、普通用户和访客账号，可按路径分配权限，配合用户启停、密码重置、权限检查和头像管理，适合家庭多人使用，也适合团队内部文件资产隔离。

• 🔗 安全分享外链
  为文件或目录生成分享链接，可设置访问控制，支持分享管理、撤销、恢复、密码访问、公共下载、目录浏览和批量打包下载。临时共享资料，不必暴露整个文件系统。

• 🌐 内置 WebDAV 网关
  可被 Windows、macOS Finder、Linux davfs2、移动端文件 App 等客户端直接挂载。支持独立 WebDAV 用户、只读模式、根路径隔离和访问日志，让 XFileManager 同时成为浏览器文件面板和标准 WebDAV 服务。

• 🖼️ 媒体与文档预览
  支持图片缩略图、视频预览 / 转码、文本与代码查看、常见文档和表格预览，并提供缩略图缓存维护能力。找图、看视频、查文档，都不用先下载到本地。

• 🏷️ 更好整理文件资产
  内置标签、收藏、最近访问、全文搜索、目录大小统计、存储统计、重复文件扫描和文件版本恢复。文件越多，越需要的不只是“能打开”，而是“找得到、理得清、可恢复”。

• 🗑️ 可控回收站，降低误删风险
  删除文件先进入回收站，支持恢复、彻底删除、清空、自动清理、统计和策略配置。对 NAS 和团队目录来说，误删可恢复比“删了就没”重要得多。

• 💾 存储挂载管理
  在管理后台配置、测试、挂载和卸载外部存储，适合多磁盘、多共享目录、多存储源的 NAS 场景，把分散路径收束成统一入口。

• 🛡️ 审计与安全基线
  内置操作审计日志与导出能力，好用之外，也要可追踪、可管控。

镜像

Docker Hub:

bash
docker pull ryantj/xfilemanager:latest

快速部署

yaml
services:
  # --- XFileManager All-in-One 服务 (后端 + 前端托管) ---
  xfilemanager:
    image: ryantj/xfilemanager:latest
    container_name: xfilemanager-app
    restart: always
    privileged: true  # Required for mounting external storage
    environment:
      - DB_URL=postgres://xfilemanager_user:secure_pass_123@db:5432/xfilemanager  # 👈 把secure_pass_123修改为自己密码，和下方db一致
      - REDIS_ADDR=redis:6379
      - REDIS_PASSWORD=redis_pass_456  # 👈 把redis_pass_456修改为自己密码
      - ROOT_DIR=/data
      - TZ=Asia/Shanghai
      - NFS_PATH_PREFIX=/mnt/user
      # 如果KEY激活不了，请去掉下方的3个#来添加代理，前两个ip改为自己实际代理服务器地址后端口号
      #- http_proxy=http://192.168.1.2:7890
      #- https_proxy=http://192.168.1.2:7890
      #- no_proxy=localhost,127.0.0.1,db,redis
    volumes:
      - /mnt/user:/data:shared                                          # 👈 左侧修改为您真实的NAS根目录据路径
      - /mnt/user/appdata/xfilemanager/uploads_temp:/app/uploads_temp   # 👈 左侧修改为您用于分块上传的缓存目录
      - /mnt/user/appdata/xfilemanager/data:/app/data                   # 👈 左侧修改为您存储系统设置和用户登陆信息的数据路径
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    ports:
      - "38866:38866"    # 👈 可修改左侧端口避免冲突
    networks:
      - xfilemanager-net

  # --- 数据库 ---
  db:
    image: postgres:15-alpine
    container_name: xfilemanager-db
    restart: always
    environment:
      POSTGRES_USER: xfilemanager_user
      POSTGRES_PASSWORD: secure_pass_123   # 👈 把secure_pass_123修改为自己密码
      POSTGRES_DB: xfilemanager
    volumes:
      - /mnt/user/appdata/xfilemanager/db:/var/lib/postgresql/data   # 👈 左侧修改为宿主机数据库路径
    ports:
      - "15432:5432"                                                  # 👈 可修改左侧端口避免冲突
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U xfilemanager_user -d xfilemanager"]
      interval: 5s
      timeout: 5s
      retries: 5
    networks:
      - xfilemanager-net

  # --- 缓存 ---
  redis:
    image: redis:7-alpine
    container_name: xfilemanager-redis
    restart: always
    command: redis-server --maxmemory 128mb --maxmemory-policy allkeys-lru --requirepass redis_pass_456 --save "" --appendonly no --loglevel notice  # 👈 把redis_pass_456修改为自己密码
    networks:
      - xfilemanager-net

networks:
  xfilemanager-net:
    driver: bridge

#**关键配置说明**：
#- **XFileManager端口**: 38866
#- **数据库端口**: 15432（外部）→ 5432（容器内）
#- **数据库密码**: 请修改默认密码：secure_pass_123
#- **Redis密码**: 请修改默认密码：redis_pass_456，注意两处修改！
#- **数据目录**:   /mnt/user（Unraid用户根目录，按实际情况填写）
#- **持久化数据**: /mnt/user/appdata/xfilemanager/app
#- **时区**: Asia/Shanghai

启动：

bash
docker compose up -d

访问：

• URL: http://your-server-ip:38866

首次部署后要求强制设置管理员密码。