nxzai/explorer

nextExplorer

镜像概述和主要用途

nextExplorer是一款现代化的自托管文件资源管理器，旨在提供安全、高效的文件管理体验。它支持通过密码保护共享工作区，提供直观的用户界面，并可轻松通过Docker部署，适用于个人或团队内部的文件浏览、管理和共享需求。

核心功能和特性

• 通过启动时密码门保护共享工作区
• 浏览、预览、上传、移动和删除多个挂载卷中的文件
• 可切换明暗布局，以及文件夹的网格或详情视图
• 生成并缓存图片和视频缩略图，确保导航流畅
• 通过内置语法感知代码编辑器内联编辑文本文件
• 使用内置查看器预览图片和视频

截图示例

自托管部署（使用Docker Compose）

1. 先决条件

• Docker Engine 24+ 和 Docker Compose v2
• 您希望通过资源管理器访问的主机目录
• 用于生成缩略图的可写缓存目录（推荐：SSD支持的存储）

2. 准备主机文件夹

创建或选择您计划挂载的文件夹，例如：

• /srv/nextexplorer/cache 用于缓存缩略图和设置
• /srv/data/Projects 和 /srv/data/Downloads 用于您想要浏览的内容 确保Docker用户对每个目录具有读写权限。

3. 编写Compose文件

创建 docker-compose.yml 并与其他基础架构文件放在同一目录：

yaml
services:
  nextexplorer:
    image: nxzai/explorer:latest
    container_name: nextexplorer
    restart: unless-stopped
    ports:
      - "3000:3000"  # 主机:容器
    environment:
      - NODE_ENV=production
      # 可选：将容器用户/组与主机ID匹配
      # - PUID=1000
      # - PGID=1000
    volumes:
      - /srv/nextexplorer/cache:/cache
      - /srv/data/Projects:/mnt/Projects
      - /srv/data/Downloads:/mnt/Downloads

每个挂载到 /mnt 下的文件夹都会成为应用内的顶级卷。通过重复 /path/on/host:/mnt/标签 模式添加所需数量的卷。

4. 启动服务

在包含Compose文件的目录中运行以下命令启动服务栈：

bash
docker compose up -d

API和UI均通过 http://localhost:3000 提供服务。

5. 映射容器用户ID（推荐）

1. 在主机上运行 id -u 和 id -g 获取用户ID和组ID
2. 在Compose文件中设置 PUID 和 PGID 环境变量，使容器以您的用户身份运行
3. 重启服务栈；通过nextExplorer创建的任何文件现在将归主机上的您的用户所有

6. 首次运行设置

1. 在浏览器中打开应用
2. 出现提示时设置密码；此密码门将保护所有后续会话
3. 浏览“卷”面板，确认每个挂载卷均正常显示
4. 开始上传或编辑文件——缩略图将自动填充到缓存中

7. 更新镜像

要拉取最新版本：

bash
docker compose pull
docker compose up -d

容器将用户设置保存在 /cache 中，除非您通过UI明确上传、移动或删除项目，否则绝不会修改挂载卷的内容。

其他说明

• 如需本地开发，请参阅 README-development.md
• 遇到问题或有功能想法？在项目追踪器上提交工单或与维护者发起讨论