NASTools 媒体库目录结构规范 🎬

🗂️ 为 NAS Tools 和媒体服务器优化的标准化目录结构

📖 目录导航

✨ 特性介绍

NAS 媒体库目录结构规范提供以下优势：

  • 🎯 标准化管理：统一命名规则，便于媒体服务器识别和刮削
  • 🔄 自动化支持：完美适配 NAS Tools 等自动化工具
  • 📊 分类清晰：按类型、地区、语言多维度分类
  • 🚀 高效整理：硬链接技术节省空间，提高整理效率
  • 🌐 多语言支持：支持中英文媒体内容管理
  • 🔧 易于维护：结构化设计便于备份和迁移

🎯 目录结构概述

📊 媒体库设计原则

  1. 标准化：符合 NAS Tools 和媒体服务器识别规范
  2. 分类清晰：按类型、地区、语言多维度分类
  3. 扩展性强：支持未来新增媒体类型
  4. 维护方便：易于管理和备份
  5. 自动化友好：适配自动化工具的工作流程

📁 FnOS 媒体库结构

🌳 完整目录树

1
2
3
4
5
6
7
8
9
10
11
/vol2/1000/media/
├── 📥 downloads/          # 下载目录
├── 🔗 link/              # 硬链接目录（NAS Tools使用）
│   ├── 🎥 movie/         # 电影硬链接
│   │   ├── 华语电影/     # 中文电影
│   │   └── 外语电影/     # 外国电影
│   ├── 📺 tv/           # 电视剧硬链接
│   │   └── 国产剧/       # 国产电视剧
│   └── 🐰 cartoons/     # 动画硬链接
├── 🎥 movie/            # 电影媒体库
└── 📺 tv/              # 电视剧媒体库

🎨 优化后的目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/vol2/1000/光影集/
├── 📥 下载区/           # 原始下载文件
├── 🔧 整理区/           # NAS Tools处理区
│   ├── 🎥 电影/
│   │   ├── 华语电影/
│   │   └── 外语电影/
│   ├── 📺 剧集/
│   └── 🐰 动画/
└── 🏠 媒体库/           # 最终媒体库（Jellyfin/Plex）
    ├── 🎥 电影/
    │   ├── 华语电影/
    │   └── 外语电影/
    ├── 📺 剧集/
    │   ├── 国产剧/
    │   ├── 日韩剧/
    │   └── 欧美剧/
    └── 🐰 动画/
        ├── 华语动画/
        └── 外语动画/

🚀 快速创建脚本

📝 一键创建目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#!/bin/bash
# 🎬 媒体库目录创建脚本

BASE_DIR="/vol2/1000/光影集"
echo "🎯 开始创建媒体库目录结构..."

# 创建主目录
mkdir -p "${BASE_DIR}" && cd "${BASE_DIR}"

# 创建三级目录结构
mkdir -pm 755 \
    "下载区" \
    "整理区/电影/华语电影" \
    "整理区/电影/外语电影" \
    "整理区/剧集/国产剧" \
    "整理区/剧集/日韩剧" \
    "整理区/剧集/欧美剧" \
    "整理区/动画/华语动画" \
    "整理区/动画/外语动画" \
    "媒体库/电影/华语电影" \
    "媒体库/电影/外语电影" \
    "媒体库/剧集/国产剧" \
    "媒体库/剧集/日韩剧" \
    "媒体库/剧集/欧美剧" \
    "媒体库/动画/华语动画" \
    "媒体库/动画/外语动画"

# 设置权限
chmod -R 755 "${BASE_DIR}"

# 验证创建结果
echo "✅ 目录创建完成！"
tree -L 3 "${BASE_DIR}"

🔧 权限设置脚本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
#!/bin/bash
# 🔐 媒体库权限设置脚本

MEDIA_DIR="/vol2/1000/光影集"
USER="media"
GROUP="media"

# 设置用户组
chown -R ${USER}:${GROUP} "${MEDIA_DIR}"

# 设置目录权限
find "${MEDIA_DIR}" -type d -exec chmod 755 {} \;

# 设置文件权限
find "${MEDIA_DIR}" -type f -exec chmod 644 {} \;

# 设置可执行权限（如果需要）
chmod +x "${MEDIA_DIR}/脚本"/*.sh 2>/dev/null

echo "✅ 权限设置完成！"

🎬 电影目录规范

📁 电影命名规范

1
2
3
4
5
6
7
# 标准电影目录结构
媒体库/电影/华语电影/
└── 电影名称 (年份) [分辨率][编码]
    ├── 电影名称 (年份) [分辨率][编码].mkv
    ├── 电影名称 (年份) [分辨率][编码].chs.srt
    ├── 电影名称 (年份) [分辨率][编码].eng.srt
    └── poster.jpg

🎯 示例结构

1
2
3
4
5
6
7
媒体库/电影/华语电影/
└── 流浪地球2 (2023) [4K][HDR]
    ├── 流浪地球2 (2023) [4K][HDR].mkv
    ├── 流浪地球2 (2023) [4K][HDR].chs.srt
    ├── 流浪地球2 (2023) [4K][HDR].eng.srt
    ├── poster.jpg
    └── fanart.jpg

🌍 多语言支持

1
2
3
4
5
6
7
媒体库/电影/外语电影/
├── English Movies/
│   └── Inception (2010) [1080p]
├── Japanese Movies/
│   └── 君の名は。 (2016) [4K]
└── Korean Movies/
    └── 기생충 (2019) [1080p]

📺 电视剧目录规范

📁 电视剧命名规范

1
2
3
4
5
6
7
8
9
# 标准电视剧目录结构
媒体库/剧集/国产剧/
└── 剧集名称 (年份)
    ├── Season 01
    │   ├── 剧集名称 S01E01 集数标题.mkv
    │   ├── 剧集名称 S01E01.chs.srt
    │   └── ...
    ├── Season 02
    └── poster.jpg

🎯 示例结构

1
2
3
4
5
6
7
8
9
10
媒体库/剧集/国产剧/
└── 三体 (2023)
    ├── Season 01
    │   ├── 三体 S01E01 科学边界.mkv
    │   ├── 三体 S01E01.chs.srt
    │   ├── 三体 S01E02.mkv
    │   └── ...
    ├── Season 02
    ├── poster.jpg
    └── banner.jpg

🌍 国际剧集分类

1
2
3
4
5
6
7
8
9
媒体库/剧集/
├── 国产剧/
├── 日韩剧/
│   ├── 韩剧/
│   └── 日剧/
└── 欧美剧/
    ├── 美剧/
    ├── 英剧/
    └── 其他/

🐰 动画目录规范

📁 动画命名规范

1
2
3
4
5
6
7
8
9
10
11
# 动画电影和剧集分类
媒体库/动画/
├── 华语动画/
│   ├── 电影/
│   └── 剧集/
└── 外语动画/
    ├── 日本动画/
    │   ├── 电影/
    │   └── 剧集/
    ├── 欧美动画/
    └── 其他/

🎯 示例结构

1
2
3
4
5
6
媒体库/动画/外语动画/日本动画/电影/
└── 千と千尋の神隠し (2001) [4K]
    ├── 千と千尋の神隠し (2001) [4K].mkv
    ├── 千と千尋の神隠し (2001) [4K].jpn.srt
    ├── 千と千尋の神隠し (2001) [4K].chs.srt
    └── poster.jpg

💡 最佳实践

🎯 NAS Tools 配置建议

1
2
3
4
5
6
7
8
# NAS Tools目录映射配置示例
version: '3'
services:
  nastools:
    volumes:
      - /vol2/1000/光影集/下载区:/downloads
      - /vol2/1000/光影集/整理区:/media
      - /vol2/1000/光影集/媒体库:/library

🔄 硬链接策略

1
2
3
4
# 使用硬链接节省空间
/media/整理区/电影/华语电影/流浪地球2 (2023)/电影文件.mkv
⬇️ 硬链接
/library/媒体库/电影/华语电影/流浪地球2 (2023)/电影文件.mkv

📊 监控和维护

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 定期清理脚本
#!/bin/bash
# 🧹 媒体库维护脚本

MEDIA_DIR="/vol2/1000/光影集"

# 清理空目录
find "${MEDIA_DIR}" -type d -empty -delete

# 清理临时文件
find "${MEDIA_DIR}" -name "*.nfo" -mtime +30 -delete
find "${MEDIA_DIR}" -name "*.tmp" -delete

# 检查文件完整性
find "${MEDIA_DIR}" -name "*.mkv" -exec ffmpeg -v error -i {} -f null - 2>error.log \;

echo "✅ 媒体库维护完成！"

🚀 自动化脚本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 媒体库健康检查
#!/bin/bash
# 🩺 媒体库健康检查脚本

check_directory() {
    local dir=$1
    if [ ! -d "$dir" ]; then
        echo "❌ 目录缺失: $dir"
        return 1
    fi
    echo "✅ 目录正常: $dir"
    return 0
}

# 检查关键目录
check_directory "/vol2/1000/光影集/下载区"
check_directory "/vol2/1000/光影集/整理区"
check_directory "/vol2/1000/光影集/媒体库"

# 检查权限
find "/vol2/1000/光影集" -name "*.mkv" ! -perm 644 -exec echo "⚠️  文件权限异常: {}" \;

🎬 提示：良好的目录结构是媒体库管理的基石。建议定期备份目录结构配置，并在新增媒体类型时及时更新规范。

📚 推荐工具：

🔧 故障排除：

1
2
3
4
5
6
7
8
# 查看目录大小
du -sh /vol2/1000/光影集/*

# 检查inode使用
df -i /vol2/1000/

# 查找重复文件
fdupes -r /vol2/1000/光影集/

💡 扩展建议：

  1. 定期使用 rsync 备份媒体库元数据和目录结构
  2. 考虑使用 ZFS 或 Btrfs 文件系统以获得更好的数据完整性保护
  3. 为不同类型的媒体设置不同的备份策略
  4. 使用监控工具如 inotifywait 监控媒体库变化