kevin0330/nas-tools

nastools(v2.9.2) Docker镜像文档

镜像概述

nastools(v2.9.2) Docker镜像是一款专为NAS系统设计的媒体资源管理工具，提供媒体文件的自动化下载、整理、分类与管理功能，帮助用户高效维护个人媒体库，支持WebUI控制及多目录管理。

核心功能

• 媒体资源自动化管理：支持电影、电视剧等媒体文件的自动识别、分类与整理
• WebUI控制界面：通过3000端口提供直观的Web管理界面，方便配置与操作
• 多目录支持：可同时映射多个媒体目录，实现分散存储媒体文件的集中化管理
• 配置持久化：配置文件通过卷挂载实现持久化存储，确保重启容器后设置不丢失
• 灵活权限控制：支持通过PUID/PGID指定运行用户，适配不同系统的权限需求

使用场景

适用于个人或家庭NAS用户，用于管理本地媒体库（如电影、电视剧、音乐等资源）的自动化下载、整理与维护，尤其适合需要高效管理大量分散存储媒体文件的场景。

使用方法

Docker Run部署示例

bash
docker run -d \
    --name nas-tools \
    --hostname nas-tools \
    -p 3006:3000   `# WebUI控制端口映射（主机端口:容器端口）` \
    -v /volume4/docker/nas-tools/config:/config  `# 配置文件目录映射（主机路径:容器路径）` \
    -v /volume4/MediaMore:/MediaMore    `# 媒体目录映射（可添加多个）` \
    -v /volume3/Media:/Media    `# 媒体目录映射（多个目录需分别映射）` \
    -e PUID=0     `# 运行程序的用户UID（详见下方说明）` \
    -e PGID=0     `# 运行程序的用户GID（详见下方说明）` \
    -e UMASK=000  `# 掩码权限（默认000，建议设置为022）` \
    -e NASTOOL_AUTO_UPDATE=false `# 启动时自动升级程序（true启用，false禁用）` \
    kevin0330/nas-tools

参数说明

端口映射

• -p 3006:3000：将容器内WebUI默认端口（3000）映射到主机3006端口，可根据实际需求修改主机端口（如-p 8080:3000）。

卷挂载

• /config目录：存放程序配置文件，需映射到主机目录（如示例中的/volume4/docker/nas-tools/config），确保配置持久化。
• 媒体目录：需将NAS中的媒体文件目录（如/volume4/MediaMore、/volume3/Media）映射到容器内，多个目录需分别添加-v参数。

环境变量

• PUID：指定运行程序的用户UID（用户ID），用于解决文件权限问题，默认0（root用户），建议设置为实际使用用户的UID。
• PGID：指定运行程序的用户GID（用户组ID），与PUID配合使用，默认0（root组），建议设置为实际使用用户组的GID。
• UMASK：文件创建掩码权限，默认000（所有用户可读写执行），建议设置为022（仅所有者有写权限，其他用户只读）以增强安全性。
• NASTOOL_AUTO_UPDATE：启动容器时是否自动升级程序，true表示启用自动升级，false表示禁用（默认）。