maene/nas-tools

jxxghp/nas-tools 镜像文档

镜像概述

本镜像为jxxghp/nas-tools的2.9.1/2.9.0版本备份，用于在Docker环境中部署nas-tools工具。部署时需特别注意设置环境变量NASTOOL_AUTO_UPDATE=false以禁用自动更新功能，避免版本冲突或意外升级。

核心功能与特性

• 基于nas-tools 2.9.x稳定版本构建，确保功能稳定性
• 支持持久化配置存储，通过卷挂载保存配置文件
• 可自定义端口（默认3000，通过生成的config.yml文件修改）
• 支持设置用户ID(PUID)、组ID(PGID)及时区，适配不同系统环境
• 提供文件掩码(UMASK)配置，控制文件权限

使用场景

适用于NAS环境下部署nas-tools工具，用于文件管理、媒体资源整理等相关场景，尤其适合需要稳定版本且手动控制更新的用户。

使用方法与配置说明

Docker Compose部署示例

yaml
version: "3.2"

services:
  nas-tools:
    image: maene/nas-tools:2.9.0  # 镜像名称及版本
    volumes:
      - /volume1/docker/nastools:/config  # 配置文件持久化目录
      - /volume1/movie:/volume1/movie  # 主机路径与容器内路径映射（可根据需求添加多个）
    environment: 
      - PUID=1000    # 执行用户ID（根据实际用户名ID设置）
      - PGID=1000    # 执行用户组ID（根据实际用户组ID设置）
      - TZ=Asia/Shanghai  # 时区设置
      - NASTOOL_CN_UPDATE=false  # 关闭中国加速更新
      - UMASK=022  # 文件掩码，控制新建文件权限
      - NASTOOL_AUTO_UPDATE=false  # 禁用自动更新（必须设置为false）
    restart: always  # 容器退出后自动重启
    network_mode: host  # 使用主机网络模式
    hostname: nas-tools  # 容器主机名
    container_name: nas-tools  # 容器名称

配置参数说明

卷挂载（volumes）

• /config: 配置文件存储目录，需持久化挂载以保存配置
• 可根据需求添加其他路径映射，格式为主机路径:容器内路径

环境变量（environment）

• PUID: 执行用户ID，用于控制容器内文件访问权限，需根据实际系统用户ID设置
• PGID: 执行用户组ID，与PUID配合使用
• TZ: 时区设置，如Asia/Shanghai表示中国时区
• NASTOOL_CN_UPDATE: 是否启用中国加速更新，false为关闭
• UMASK: 文件掩码，默认022，控制新建文件的权限
• NASTOOL_AUTO_UPDATE: 自动更新开关，必须设置为false，避免自动升级到非备份版本

网络与运行设置

• network_mode: host: 使用主机网络，容器直接使用主机的网络栈
• restart: always: 容器退出时自动重启，确保服务持续运行
• hostname/container_name: 自定义容器主机名和名称，便于识别和管理

端口配置

默认端口为3000，可通过容器内生成的config.yml文件修改端口配置，修改后需重启容器使配置生效。