318182456/nas-tools

nas-tools Docker镜像文档

镜像概述

nas-tools是一款针对NAS（网络附加存储）环境设计的工具，主要用于媒体文件管理、配置数据持久化及应用自动更新。通过WebUI提供直观操作界面，支持自定义媒体目录映射，满足家庭或小型办公场景下的媒体资源管理需求。

核心功能与特性

• WebUI控制：默认通过3000端口提供Web管理界面，方便用户操作
• 配置持久化：支持配置文件目录映射，确保配置数据不丢失
• 媒体目录管理：可映射多个媒体目录，实现媒体文件的集中管理
• 用户权限控制：支持通过PUID/PGID指定运行用户，保障文件访问权限
• 自动更新：支持启动时自动升级程序，可选国内源加速更新

使用场景

• 家庭NAS媒体文件管理与维护
• 个人或小型团队的媒体资源集中存储与访问
• 需要持久化配置和自动更新的NAS应用部署

使用方法

基本部署命令

bash
docker run -d \
    --name nas-tools \
    --hostname nas-tools \
    -p 3003:3000   `# WebUI访问端口（主机端口:容器端口）` \
    -v /volume3/docker/nas-tools:/config  `# 配置文件目录映射（主机路径:容器路径）` \
    -v /volume2/video:/volume2/video    `# 媒体目录映射（可添加多个）` \
    -e PUID=0     `# 运行用户UID` \
    -e PGID=0     `# 运行用户GID` \
    -e UMASK=000  `# 文件权限掩码（默认000，建议设置为022）` \
    -e NASTOOL_AUTO_UPDATE=true `# 启动时自动升级程序（true/false）` \
    -e NASTOOL_CN_UPDATE=true `# 使用国内源更新（网络不佳时设置为true）` \
    318182456/nas-tools

参数说明

端口映射

• -p 3003:3000：将容器内3000端口（WebUI默认端口）映射到主机3003端口，可根据需要修改主机端口

卷挂载

• /config：配置文件存储目录，需映射到主机持久化路径（如示例中的/volume3/docker/nas-tools）
• 媒体目录：可根据实际需求添加多个媒体目录映射，格式为-v 主机媒体路径:容器内路径

环境变量

docker-compose配置示例

yaml
version: '3'
services:
  nas-tools:
    image: 318182456/nas-tools
    container_name: nas-tools
    hostname: nas-tools
    ports:
      - "3003:3000"
    volumes:
      - /volume3/docker/nas-tools:/config
      - /volume2/video:/volume2/video
      - /volume2/music:/volume2/music  # 额外媒体目录
    environment:
      - PUID=1000
      - PGID=1000
      - UMASK=022
      - NASTOOL_AUTO_UPDATE=true
      - NASTOOL_CN_UPDATE=true
    restart: unless-stopped

注意事项

• 首次运行需通过http://主机IP:3003访问WebUI进行初始配置
• 媒体目录映射时，确保主机路径存在且容器用户（PUID/PGID）有读写权限
• UMASK建议设置为022以增强文件权限安全性
• 国内用户建议开启NASTOOL_CN_UPDATE以提高更新速度