lsiodev/diskover

linuxserver/diskover

镜像概述和主要用途

https://github.com/diskoverdata/diskover-community 是一款开源文件系统索引器，它使用Elasticsearch对跨异构存储系统的数据进行索引和管理。LinuxServer.io团队提供的此镜像具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，整个LinuxServer.io生态系统共享通用层，以最小化空间占用、 downtime和带宽
• 定期安全更新

核心功能和特性

• 跨异构存储系统的文件系统索引与管理
• 依赖Elasticsearch进行数据存储与检索
• 支持通过Web UI进行数据查看与管理
• 可配置的自动索引任务（通过crontab）
• 支持手动触发索引任务
• 多架构支持（x86-64、arm64v8）

支持的架构

该镜像利用docker manifest实现多平台支持，拉取lscr.io/linuxserver/diskover:latest即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。支持的架构如下：

应用设置

依赖说明

本应用依赖Elasticsearch实例，请参考示例compose文件获取更多信息。

初始访问

默认用户名为diskover，密码为darkdata，通过http://<host-ip>/访问容器。在创建有效索引之前，UI可能无法正常使用。

配置Elasticsearch连接

需要编辑位于/config/diskover-web.conf.d/Constants.php的默认diskover-web配置文件，以允许diskover-web与Elasticsearch容器通信，需修改以下条目：

• const ES_HOST = 'elasticsearch';
• const ES_PORT = 9200;

索引管理

应用默认不启动索引任务。/config目录下会创建crontab文件，可配置为对/data目录进行自动索引。修改crontab文件后需重启容器生效。也可手动执行索引任务：

• 后台运行索引：

  bash
  docker exec -u abc -d diskover python3 /app/diskover/diskover.py -i diskover-my_index_name /data
  

• 前台运行索引：

  bash
  docker exec -u abc -it diskover python3 /app/diskover/diskover.py -i diskover-my_index_name /data
  

使用方法和配置说明

docker-compose（推荐）

yaml
version: '2'
services:
  diskover:
    image: lscr.io/linuxserver/diskover
    container_name: diskover
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
      - ES_HOST=elasticsearch
      - ES_PORT=9200
    volumes:
      - /path/to/diskover/config:/config
      - /path/to/diskover/data:/data
    ports:
      - 80:80
    mem_limit: 4096m
    restart: unless-stopped
    depends_on:
      - elasticsearch
  elasticsearch:
    container_name: elasticsearch
    image: docker.elastic.co/elasticsearch/elasticsearch:7.10.2
    environment:
      - discovery.type=single-node
      - xpack.security.enabled=true
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms1g -Xmx1g"
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - /path/to/esdata:/usr/share/elasticsearch/data
    ports:
      - 9200:9200
    depends_on:
      - elasticsearch-helper
    restart: unless-stopped
  elasticsearch-helper:
    image: alpine
    command: sh -c "sysctl -w vm.max_map_count=262144"
    privileged: true

docker cli

bash
docker run -d \
  --name=diskover \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e ES_HOST=elasticsearch \
  -e ES_PORT=9200 \
  -e ES_USER=elastic \
  -e ES_PASS=changeme \
  -p 80:80 \
  -v /path/to/diskover/config:/config \
  -v /path/to/diskover/data:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/diskover:latest

参数说明

容器通过运行时传递的参数进行配置，格式为<外部>:<内部>。

环境变量文件（Docker secrets）

可通过特殊前缀FILE__从文件设置任何环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据/run/secrets/mysecretvariable文件内容设置MYVAR环境变量。

应用程序Umask设置

所有镜像支持通过可选参数-e UMASK=022覆盖容器内服务的默认umask设置。注意umask是权限掩码，基于其值减去权限而非添加，请参考umask说明。

用户/组标识符

使用卷（-v标志）时，主机OS与容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的卷目录归指定用户所有，权限问题将迎刃而解。

使用id your_user命令获取您的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=diskover&query=%24.mods%5B%27diskover%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看可用的通用mods")

我们发布了各种https://github.com/linuxserver/docker-mods%E4%BB%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E5%8F%AF%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84mods%E5%88%97%E8%A1%A8%E5%8F%8A%E9%80%82%E7%94%A8%E4%BA%8E%E4%BB%BB%E4%BD%95LinuxServer.io%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8mods%E3%80%82

支持信息

容器运行时Shell访问

bash
docker exec -it diskover /bin/bash

实时监控容器日志

bash
docker logs -f diskover

容器版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' diskover

镜像版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/diskover:latest

更新信息

大多数镜像为静态版本化，需要更新镜像并重建容器以更新内部应用。请参考应用设置部分了解是否推荐更新。

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull diskover
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d diskover
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/diskover:latest
  

• 停止运行中的容器：

  bash
  docker stop diskover
  

• 删除容器：

  bash
  docker rm diskover
  

• 使用相同参数重建容器（若正确映射到主机文件夹，/config目录和设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

镜像更新通知 - Diun（Docker镜像更新通知器）

提示：推荐使用Diun获取更新通知。不推荐或支持自动更新容器的其他工具。

本地构建

如需为开发或自定义修改本地构建镜像：

bash
git clone https://github.com/linuxserver/docker-diskover.git
cd docker-diskover
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/diskover:latest .

可使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，可使用-f Dockerfile.aarch64指定ARM64构建文件。

版本历史

• 25.05.23: - 基于Alpine 3.18重建，弃用armhf架构。
• 13.04.23: - 将ssl.conf包含移动到default.conf。
• 02.03.23: - 初始化期间设置crontabs权限。
• 20.08.22: - 基于Alpine 3.17和php8.1重建，重构nginx配置（查看变更公告）。
• 25.02.22: - 添加php7-sqlite3以支持rc4版本。
• 03.11.21: - 增加对潜在配置文件的支持。
• 31.10.21: - 为ElasticSearch添加xpack.security变量；添加编辑diskover中Constants.php的说明；修正手动生成索引的命令。
• 11.10.21: - 更新至diskover-community v2。
• 19.11.20: - 修复pip包问题。
• 19.12.19: - 基于Alpine 3.11重建。
• 28.06.19: - 基于Alpine 3.10重建。
• 12.04.19: - 基于Alpine 3.9重建。
• 23.03.19: - 切换到新基础镜像，迁移至arm32v7标签。
• 01.11.18: - 初始发布。