shigongqiang/nas-tools

镜像概述

shigongqiang/nas-tools是针对NAS场景设计的工具镜像，支持amd64和arm64双架构，提供标准版与lite版本，适配不同设备与需求。

核心功能

• 多架构支持：兼容amd64/arm64设备；
• 版本选择：lite版本体积更小，但不包含浏览器内核、xvfb，不支持Rclone/Minio转移及复杂依赖自动升级；
• 安全运行：可通过非root用户执行任务，降低权限风险。

使用场景

• 个人NAS媒体文件的统一管理与配置；
• 与emby、jellyfin、qbittorrent等媒体工具配合，确保文件权限一致；
• 轻量化NAS工具需求场景（选择lite版本）。

配置说明

PUID/PGID设置

• 建议与其他媒体工具（如emby、qbittorrent）使用相同PUID/PGID，保证文件访问权限一致；
• 在宿主机器通过id -u（获取uid）、id -g（获取gid）命令获取数值，分别设置为PUID、PGID；
• 避免默认使用root用户（PUID=0/PGID=0），除非媒体文件所有者为root。

部署示例

docker-compose部署

新建docker-compose.yaml文件：

yaml
version: "3.4"
services:
  nastools:
    network_mode: host
    image: shigongqiang/nas-tools:2.9.0
    container_name: nastools
    hostname: nastools
    volumes:
      - /root/nastools/config:/config   # 主机配置保存路径
      - /home/downloads:/home/downloads # 数据目录映射
      - /home/media/movie:/movie # 电影文件夹映射
      - /home/media/tv:/tv # 电视剧文件夹映射
      - /home/media/anime:/anime # 动漫文件夹映射
      - /root/.config/rclone:/root/.config/rclone  # rclone配置路径
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - UMASK=022 # 掩码权限
      #- REPO_URL=https://ghproxy.com/https://github.com/jxxghp/nas-tools.git  # 国内访问GitHub困难时启用
    restart: always

执行启动命令：docker-compose up -d

docker cli部署

bash
docker run -d \
    --name nas-tools \
    --hostname nas-tools \
    -p 3000:3000   # 默认webui控制端口 \
    -v $(pwd)/config:/config  # 主机配置保存路径 \
    -v /你的媒体目录:/容器内目标目录    # 媒体目录映射（多个需分别添加） \
    -e PUID=0     # 运行用户uid \
    -e PGID=0     # 运行用户gid \
    -e UMASK=000  # 掩码权限 \
    -e NASTOOL_AUTO_UPDATE=false # 启动时自动升级程序（true开启） \
    -e NASTOOL_CN_UPDATE=false # 国内源升级（网络不友好时开启） \
    shigongqiang/nas-tools

若访问GitHub困难，添加环境变量：-e REPO_URL="https://ghproxy.com/https://github.com/jxxghp/nas-tools.git"