razeencheng/nastool

nastool Docker镜像文档

镜像概述

nastool Docker镜像是一款专为NAS（网络附加存储）系统设计的管理工具容器化方案，旨在简化NAS资源的管理、备份及自动化任务处理。通过容器化部署，该镜像提供了便捷的配置方式和灵活的运行参数，适用于个人及小型团队的NAS系统维护需求。

核心功能与特性

• 配置持久化：通过挂载/config目录实现配置文件的持久化存储，避免容器重启后配置丢失
• 用户权限控制：支持通过PUID/PGID设置运行用户及组ID，确保容器内操作与宿主机文件权限兼容
• 灵活更新选项：可通过环境变量控制自动更新功能及国内更新源的使用，适应不同网络环境
• Web管理界面：默认通过3000端口提供直观的Web管理界面，简化NAS资源管理操作

使用场景

• 个人NAS系统的日常管理与维护
• 自动化备份NAS中的重要数据
• 统一管理NAS资源，实现文件分类与整理
• 家庭或小型团队环境下的NAS资源共享与访问控制

使用方法

基本部署（docker run）

通过以下命令快速启动nastool容器：

bash
docker run --rm \
    --name nas-tools \
    --hostname nas-tools \
    -p 3000:3000    \  # 映射Web管理界面端口
    -v $(pwd)/config:/config  \  # 挂载配置目录，持久化配置
    -e PUID=1026      \  # 运行容器的用户ID
    -e PGID=100      \  # 运行容器的组ID
    -e UMASK=000   \  # 文件权限掩码
    -e NASTOOL_AUTO_UPDATE=false  \  # 禁用自动更新
    -e NASTOOL_CN_UPDATE=false \  # 禁用国内更新源
    -it razeencheng/nastool:2.9.1

环境变量说明

访问与配置

容器启动后，通过浏览器访问 http://宿主机IP:3000 即可进入nastool Web管理界面。首次使用需根据引导完成初始配置，所有配置将保存在挂载的./config目录中，确保容器重启后配置不丢失。

docker-compose配置示例

创建docker-compose.yml文件，便于容器的管理与维护：

yaml
version: '3'
services:
  nas-tools:
    image: razeencheng/nastool:2.9.1
    container_name: nas-tools
    hostname: nas-tools
    ports:
      - "3000:3000"  # Web管理界面端口映射
    volumes:
      - ./config:/config  # 配置文件持久化
    environment:
      - PUID=1026         # 用户ID
      - PGID=100          # 组ID
      - UMASK=000         # 权限掩码
      - NASTOOL_AUTO_UPDATE=false  # 禁用自动更新
      - NASTOOL_CN_UPDATE=false    # 禁用国内更新源
    restart: unless-stopped  # 除非手动停止，否则自动重启容器

启动命令：docker-compose up -d