长期使用NAS后，往往会随着使用经验的积累而部署大量的Docker服务。在一台NAS上安装十几个甚至二十多个应用程序，已经成为相当普遍的现象。

QBittorrent、Emby、Jellyfin、Transmission、Plex、NASTool、IT-Tools、Uptime Kuma、DDNS-Go、Navidrome、Lucky、Alist、Reader 等各类实用软件工具。

不知道大家情况如何，我个人几乎为每一项服务都配置了反向代理，并通过独立的二级域名进行访问。

尽管主域名和监听端口相对固定，但记住如此众多的子域名前缀也颇具挑战……除了NAS本身的Web管理界面以及少数几个最常用的服务外，很多时候我不得不先打开Lucky查看具体的域名，然后才能访问目标服务。

为了有效解决这一管理难题，本期将介绍几款优秀的项目。它们能够承担起NAS或服务器服务导航的重任。其中一些不仅轻量易用，还附带了其他实用功能，甚至可以作为浏览器的默认首页使用。

本文将以威联通（QNAP）NAS为例，演示如何通过Docker Compose部署这些导航页。

🍉 Sun-Panel

项目简评与特色

国人开发者无疑最懂国内用户的需求，本篇首先推荐Sun-Panel。其界面简洁直观，功能却相当强大，系统资源占用低，对移动端的支持也非常出色，操作逻辑极为简单。总体而言，它是一个轻量级、高度可定制且开箱即用的Web控制面板。如果非要指出缺点，那就是其1.3.0版本之后转向了闭源，不过这也在情理之中。

建议大家先部署试用一下，用不了十分钟就能对其功能有一个大致的了解。

部署与初步配置

部署代码如下所示，请注意保持格式的对齐：

version: "3.2" # 最新版Docker Compose可删除此行，该版本声明已弃用
services:
  sun-panel:
    image: "hslr/sun-panel:latest"
    container_name: sun-panel
    volumes:
      - /share/Container/sunpanel/conf:/app/conf # 请根据实际情况修改目录路径
      - /var/run/docker.sock:/var/run/docker.sock # 挂载docker.sock以实现部分高级功能
      # - ./runtime:/app/runtime # 挂载日志目录，对多数用户意义不大
      # - /mnt/sata1-1:/os # 挂载硬盘路径（请根据自身需求修改）
    ports:
      - 3002:3002
    restart: always

关于硬盘挂载点的路径，不同品牌的NAS有所差异。例如，威联通NAS的典型路径可能是/share/CACHEDEV1_DATA1或/share/CACHEDEV2_DATA。也可以直接挂载具体的共享文件夹，例如- /share/Multimedia:/os或- /share/Container/data:/os。

如果按照上述配置部署成功，在浏览器中输入 NAS_IP:3002 即可访问服务界面。

默认的登录账号与密码如下：

账号：admin@sun.cc
密码：12345678

界面右上角的图标点击后可以快速切换内外网访问环境，这个设计非常贴心。

右上角的四叶草图标点击后可以进行更多个性化设置，整个过程相当简单便捷。

经过简单的配置后，页面效果如图所示。面板自带的搜索功能，可以快速定位并打开已添加的应用程序。

可以随时更换背景壁纸。

如果觉得背景图片过于花哨，可以启用模糊处理效果。模糊程度支持自由调节，背景图也会根据浏览器窗口的大小自动进行缩放适配。

尽管1.3.0版本之后推出了需要付费的Pro功能，但其免费的基础版本已经足够满足日常使用，强烈推荐大家尝试此项目。

🍉 Flare

项目简评与特色

同样出自国内开发者之手，但项目近期更新不太活跃，可能功能已经趋于稳定完善。

在部署Docker应用时，我们经常会遇到需要配置数据库的情况。其中，MySQL / MariaDB、PostgreSQL以及一些轻量级项目使用的SQLite，是较为常见的选择。

Redis虽然在一些较新的项目中也会出现，但由于它不属于关系型数据库，本文将暂且不讨论。

根据官方文档进行一键部署通常并不困难。但当你希望多个应用共享同一个数据库，或者部署的多个应用都强依赖于数据库时，麻烦可能就随之而来了。本文旨在梳理和解决的，正是这部分在实际操作中可能遇到的挑战。

MariaDB作为MySQL的一个分支，有着其特殊性。它的特殊之处在于，在威联通（QNAP）NAS官方的App Center应用市场中，可以直接安装MariaDB的套件版本。这意味着许多用户在接触容器化应用之前，可能就已经先使用过它了。

正因如此，我打算从MariaDB开始写起，将其作为整个数据库系列文章的第一篇，希望能为新手用户提供一个清晰的入门指引。

⚠️ 重要声明：本文仅介绍基础的使用方法，目标是帮助你的项目成功连接并运行起来。文中涉及的所有部署代码均为演示目的，其可用性不作保证，请在生产环境中谨慎验证！

版本选择

在部署任何依赖数据库的应用时，首要步骤是仔细阅读该应用的官方文档。例如，下图展示了Photoview应用对数据库的支持情况，可以看到它默认推荐使用MariaDB的LTS（长期支持）版本，但并未强制要求具体的版本号，因此兼容性相对较高。

而另一个应用PhotoPrism则明确要求MariaDB版本必须大于等于10.5.12。

如果你使用的版本低于应用的要求，那么项目部署几乎注定会失败。

套件版 MariaDB

在威联通的应用商店中，通常提供两个MariaDB版本供选择：MariaDB 5 和 MariaDB 10。

两个版本的区别

MariaDB 5： 这是一个相对陈旧的版本，主要目的是为了兼容一些遗留的旧应用（例如早期的内容管理系统或论坛程序）。这些旧应用可能依赖与新版本不完全匹配的数据库语法或特定功能。如果你的应用年代久远，并且官方文档明确要求使用MariaDB 5.x系列，那么你只能选择这个版本。

MariaDB 10： 这是当前的主流版本，拥有更好的性能、更全面的功能以及更强的兼容性。绝大多数现代应用（如WordPress、Nextcloud、PhotoPrism等）在其官方说明中都会推荐使用MariaDB 10。因此，如果没有历史遗留应用的兼容性顾虑，直接选择MariaDB 10是明智之举。不过需要注意的是，应用商店提供的套件版本可能是v10.5.8，这已经是一个稍显落后的子版本。

如何启用套件版

首先，下载并安装 MariaDB 10 套件。其默认的端口号为 3307，我们可以根据需要进行修改。

在套件的“账户和数据库”设置界面中，“根密码”相当于超级管理员密码，建议将其重置为自己熟悉且安全的密码。“用户密码”则是指后续为各个独立数据库创建的访问账户的密码。

接着，你还需要下载安装名为 phpMyAdmin 的配套套件。通过它，我们可以使用网页界面以图形化的方式连接并管理数据库，这对于新手来说非常友好。

安装完成后，打开phpMyAdmin，会出现登录界面。用户名填写 root，密码填入上一步重置后的根密码。在服务器选项中，选择“MariaDB 10”。

登录成功后，你将进入phpMyAdmin的主管理界面。

在部署依赖MariaDB的项目之前，需要先为其创建一个专用的数据库和用户。如下图所示，点击“账户”选项卡，然后按箭头指示创建新账户。图中红框内是之前为“照片墙”应用创建的账户示例。

假设我们正在部署Emby，并且它必须绑定一个数据库才能完成初始化。

对于一般家庭用户，主要需要关注下图红框内的内容。用户名和密码通常习惯设置为与应用同名，例如 emby，当然你也可以完全自定义。主机名设置为 % 表示允许从任何主机连接，这符合大多数家庭网络的使用场景。“生成密码”功能会随机创建强密码，但个人不太喜欢使用。务必勾选「创建与用户同名的数据库并授予所有权限」选项，然后点击页面最下方的“执行”按钮。

“全局权限”部分保持默认（即不勾选任何选项），仅在数据库级别授予权限。这样做可以确保用户 emby 对系统库没有任何操作权限，只能管理其专属的数据库，更加安全。当然，如果你有特殊需求，也可以手动勾选启用如 SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX 等具体权限。

本期向大家推荐一款设计出众的在线工具箱——极速箱（JiSuXiang）。它支持通过Docker一键部署，集成了多种程序员日常所需的开发工具，旨在有效提升编码与工作效率。

值得一提的是，该工具同样完美支持ARM架构的设备。

早些时候，我还介绍过另一个名为IT-TOOLS的在线工具箱。那个项目集成的小工具数量更多，实用性也很强，不过最初版本缺乏中文界面。虽然可以通过浏览器翻译临时解决，但使用体验总有些不顺畅。随着项目迭代，官方现已加入了中文语言支持，在我看来它已经近乎完美。

至于如何在这两者之间选择，我的建议是你可以将它们都部署起来，亲自体验对比一番。毕竟两者都非常轻量级，资源占用极小。具体的部署代码将在下一节详细列出。

功能特点

极速箱具备一系列提升使用体验的核心特性：

• 工具分类清晰：提供JSON处理、编码解码、网络测试等多种实用工具。
• 响应式设计：能够自适应各种屏幕尺寸的设备，确保最佳的用户体验。
• 深色主题：配备护眼的深色界面模式，适合长时间专注工作。
• 高效全局搜索：拥有强大的搜索功能，可以快速定位到你需要的工具。
• 个人收藏系统：允许你将常用工具加入收藏夹，便于日后快速访问。
• 多语言界面：完整支持中文与英文，满足不同用户的使用习惯。

极速箱内置了种类极其丰富的开发辅助工具，其功能覆盖面非常广，从数据处理到界面设计均有涉猎。具体包括：JSON格式化和验证器、HTTP请求测试器、时间戳转换器、各类编码/解码工具、正则表达式测试器、多种加密工具、颜色选择与转换器、代码格式化工具、JSON可视化编辑器、IP地址查询、日期计算器、时区转换器、文本统计分析器、HTML与Markdown互相转换工具、图片压缩工具、二维码生成器以及CSS渐变生成器等。这些工具几乎涵盖了程序员日常工作中的所有高频需求场景。而且，该平台仍在持续更新中，未来必然会加入更多实用的小工具。

部署流程

极速箱（JiSuXiang）同样推荐使用Docker进行部署，过程非常简单。

本文将以威联通（QNAP）NAS作为部署环境，采用Docker Compose的方式来完成部署。

极速箱的Docker Compose部署代码如下：

version: '3.8' # 注：最新版Docker Compose已计划弃用此声明，可酌情删除
services:
  jisuxiang:
    image: star7th/jisuxiang:latest     # ARM架构设备用户请使用 star7th/jisuxiang:arm-latest
    container_name: jisuxiang           # 自定义容器名称
    restart: always                     # 设置容器始终自动重启
    ports:
      - "3366:3000"                     # 将容器内3000端口映射到宿主的3366端口（左侧端口可自定义）

作为对比，IT-TOOLS的部署代码如下：

version: '3.8' # 同上，可根据Docker Compose版本决定是否保留此行
services:
  it-tools:
    image: corentinth/it-tools:latest
    container_name: it-tools
    ports:
      - "9999:80"                       # 将容器内80端口映射到宿主的9999端口
    restart: unless-stopped

使用介绍

按照上述代码成功部署后，在浏览器中输入 你的NAS的IP地址:3366 即可访问并使用极速箱。

其初始界面如下图所示。图中箭头依次指示了“收藏夹”入口、“中/英文语言切换”按钮以及“明/暗主题切换”按钮。

’ fill=’%23FFFFFF’%3E%3Crect x=‘249’ y=‘126’ width=‘1’ height=‘1’%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

对于依赖网盘的用户而言，资源查找与跨平台转存常常是繁琐的流程。本期内容将为大家详细介绍一款功能强大的工具——CloudSaver，它能够将资源搜索与网盘转存整合为一体，并通过Docker在您的NAS上轻松部署。

该工具支持响应式布局，可在手机与电脑端获得良好的浏览体验，并可通过Docker实现一键快速部署。将其与CD2、Alist等工具相结合，能在NAS环境中构建起一个高效的资源管理闭环。

项目功能概览

该项目集成了多项实用功能，旨在提升网盘资源的使用效率：

🔍 多渠道资源聚合搜索：

• 支持从多个资源订阅源进行聚合搜索。
• 可通过关键词直接查找，或解析已有的资源链接。
• 提供豆瓣热门影视榜单的展示功能。

💾 便捷的网盘转存操作：

• 支持一键转存至115网盘、夸克网盘、天翼云盘及123云盘。
• 在转存前可清晰展示文件夹结构，方便用户选择目标路径。

👥 完善的多用户管理系统：

• 提供用户注册与登录功能。
• 设有管理员与普通用户两种角色，并分配不同的管理权限。

📱 自适应的界面设计：

• 采用响应式设计，能自动适配PC端与移动端屏幕。
• 针对不同设备的操作习惯进行了交互优化。

详细部署步骤

以下将以威联通（QNAP）NAS为例，演示如何使用Docker Compose部署CloudSaver。项目提供稳定版与测试版镜像，您可以根据需要选择。

创建docker-compose.yml文件，并填入以下配置内容：

version: "3" # 最新版Docker Compose建议删除该行
services:
  cloudsaver:
    image: jiangrui1994/cloudsaver:latest # 使用 jiangrui1994/cloudsaver:test 可部署测试版
    container_name: cloud-saver
    ports:
      - "8008:8008" # 冒号左侧的宿主机端口可按需修改
    volumes:
      - /share/Container/cloudsaver/data:/app/data # 请根据实际情况修改冒号左侧的本地路径
      - /share/Container/cloudsaver/config:/app/config
    restart: unless-stopped

服务启动后，通过容器日志可以确认系统已自动生成初始的.env环境变量配置文件。接下来，我们需要根据自身需求对该文件进行调整。

在NAS内部，我们可以直接使用威联通自带的Text Editor文本编辑器来打开并修改此文件。完成编辑后保存即可。

在配置文件中，您可以添加或修改必要的环境变量。例如，为了增强安全性，建议生成并配置JWT密钥。以下是一个配置示例（部分敏感信息已做处理）：

# JWT安全密钥配置
# 可以通过SSH连接到NAS，执行以下命令生成一个强密钥：
# openssl rand -base64 32
JWT_SECRET=FLtxW7hOfP+n8RxJMF2pJ9QqK8pRjP0ZpC3vUcD2RgA=

基本使用与配置指引

请注意： 资源搜索功能需要配置可访问外网的代理环境。

完成上述部署后，在浏览器中输入 您的NAS_IP地址:8008 即可访问CloudSaver的Web界面。首次使用需要注册账户，请注意账户名不能使用中文。

Karakeep作为一款可自托管的书签与知识管理平台，不仅能够存储网页链接，还能高效处理图片、PDF文档和笔记内容，并借助AI技术自动创建标签和摘要，从而使用户能够更轻松地组织和检索信息。此外，它还支持从多个平台导入和导出书签数据。例如，将YouTube或Bilibili的链接粘贴进系统后，工具会自动抓取简介、标题和封面图片并记录保存，用户点击即可直接跳转到对应页面浏览。在信息泛滥的当下时代，我们并不缺少可用内容，真正稀缺的是高效掌控和管理内容的方法。

Karakeep项目深度解析

该项目目前仍处于快速迭代开发阶段，感兴趣的用户可以自行关注其后续更新动态。

Karakeep（原名Hoarder）是一款支持自托管的书签和知识管理工具。它不仅能够快速保存各种链接，还能存储图片、PDF文件和笔记内容，并且集成了AI自动标签和摘要生成功能。

用户可以将它视为「自建版本的Notion、Pocket与Evernote结合体」。

需要注意的是，如果启用AI功能会产生额外使用成本，因为API Key会涉及费用支出，有条件的话也可以选择部署本地大模型如Ollama来降低成本。

本文主要介绍社区版的部署方案，当然官方也提供了测试Demo供用户体验。

全面功能概览

• 多格式收藏支持：不仅能保存传统书签，还兼容笔记、图片、PDF等多种内容形式，并自动提取网页标题、描述信息和缩略图。
• 智能增强特性：集成AI自动标签和摘要生成（可选本地模型Ollama），OCR功能从图片中提取文字内容，以及规则引擎实现自动化分类与管理。
• 强大的搜索与组织能力：内置全文搜索引擎，支持列表归类、高亮标注和批量操作功能，让海量信息也能快速定位和访问。
• 跨平台与生态集成：提供Chrome/Firefox浏览器插件和iOS/Android移动客户端，支持RSS自动收集，REST API、多语言界面和SSO登录方式，覆盖从桌面到移动端的各种使用场景。
• 长期存档保障：通过网页快照（Monolith）防止内容失效，视频存档（yt-dlp）保留多媒体资料，还能导入现有书签或与浏览器进行同步操作。
• 用户体验优化：深色模式界面、自托管优先设计，未来还将增加移动端离线阅读和语义搜索等高级功能。

推荐部署平台

官方建议通过Docker Compose方式进行部署。本文以威联通NAS为例，通过Container Station工具进行实际操作演示。

家中的TS-464C2已更换为Qu805型号超过半个月时间。从个人使用体验来看，这一代NAS的性能提升和整体表现相当显著。

威联通系统的调度逻辑一向偏向「官方化」风格，换句话说就是对硬件性能的释放高度依赖系统自身优化，这一点老用户都有体会。不过在Qu805设备上，这套调度机制显然发挥得更好，CPU资源分配合理，内存占用和I/O响应也保持稳定状态。

首先是响应速度和多任务处理能力。升级到8核8线程配置后，日常访问和后台任务调度的流畅度有了明显提升。特别是在同时运行多个应用（如Qsirch、Qumagie等）时，系统没有出现显著卡顿或等待现象。在视频解码能力方面，处理起来轻松自如毫无压力。再就是温度控制表现，无论是日常待机还是满载运行，温度都维持在理想范围内，整体噪音控制和稳定性都比上一代产品更出色。

详细部署步骤

官方提供的流程是通过SSH输入命令从GitHub拉取docker-compose.yml文件，然后执行部署操作。

wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

但为了方便管理，直接打开威联通的Container Station创建即可。

部署代码如下：

services:  web:    image: ghcr.io/karakeep-app/karakeep:release    container_name: karakeep-web    ports:      - "3000:3000" # 冒号左侧端口请自行修改，不再赘述    #env_file:      #- /share/Container/karakeep/.env    environment:      - NODE_ENV=production      - TZ=Asia/Shanghai      - KARAKEEP_VERSION=release      - NEXTAUTH_SECRET=X9U9AS+YVENHWc4D1au+/CoKIjrBLgMF5zqHR4yGM5necJWI      - NEXTAUTH_URL=http://localhost:3000 # 如果用域名/局域网访问，请改成实际URL      - MEILI_ADDR=http://meilisearch:7700 # Karakeep 连接 Meilisearch 的地址与凭据      - MEILI_API_KEY=honxYNqSbgcJ5Gj5hVOwxm5r5ubg0NwSGI320r79IV      - DATA_DIR=/data      # 可选，用于 AI 摘要/标签      # - OPENAI_API_KEY=sk-yourapikey    volumes:      - /share/Container/karakeep/data:/data    depends_on:      - meilisearch      - chrome    restart: always  chrome:    image: gcr.io/zenika-hub/alpine-chrome:124    container_name: karakeep-chrome    restart: always    command:      - --no-sandbox      - --disable-gpu      - --disable-dev-shm-usage      - --remote-debugging-address=0.0.0.0      - --remote-debugging-port=9222      - --hide-scrollbars  meilisearch:    image: docker.20040311.xyz/getmeili/meilisearch:v1.13.3 # 我自建的加速，可换别的    container_name: karakeep-meilisearch    ports:      - "7700:7700"    #env_file:     #- /share/Container/karakeep/.env    environment:      - MEILI_NO_ANALYTICS=true      - MEILI_MASTER_KEY=honxYNqSbgcJ5Gj5hVOwxm5r5ubg0NwSGI320r79IV    volumes:      - /share/Container/karakeep/meili_data:/meili_data    restart: always

你是否在寻找一个应用服务，既能满足家庭观影需求，又无需投入大量预算购买硬盘，或依赖网盘？此前我介绍过LibreTV，今天我们将探讨另一个更为出色的项目：MoonTV。该项目支持Vercel、Docker和Cloudflare部署。关于部署方法及实际效果，请继续阅读下文。

MoonTV的播放质量表现相当出色。

个人经历与NAS发展

我的第一台NAS是威联通TS-453Bmini。虽然对NAS早有耳闻，但当时群晖价格较高，而威联通仅售2千元，性价比极高，于是果断入手。许多朋友可能和我一样，在京东促销时下单，后续价格甚至降至1999元，并成功保价。

从那时起，我便逐渐沉迷于NAS的探索。陆续尝试过树莓派、星际蜗牛等设备，也体验过虚拟机环境，安装了TrueNas、Unraid、黑群晖及黑威联通等多种NAS系统。近年来，随着新兴NAS品牌不断涌现，NAS设备已进一步普及，如今它已成为不再小众的数码产品。

随着NAS走入更多家庭，其应用场景中，相册管理和家庭影音这类生活娱乐功能占据了相当大的比重。相册管理相对简单，只要官方提供好用软件即可，但影音解决方案呢？早期阶段，本地硬盘几乎是必需品，而整理媒体库和刮削信息的痛苦过程许多人都经历过。如今网盘兴起，硬盘变成了可选项。然而，一旦网盘用户数量达到特定阈值，订阅收费模式几乎不可避免。

现在想要完全免费使用，确实颇具挑战！但办法总比困难多。

下面让我们进入正题。

MoonTV项目简介

项目名称：senshinya/MoonTV，在GitHub搜索即可找到。

MoonTV 是一个开箱即用、跨平台的多媒体项目。它基于Next.js 14 + Tailwind CSS + TypeScript技术栈构建，支持多源搜索、在线播放、收藏同步、播放记录、本地与云端存储，让用户可以随时随地享受海量影音内容。该项目还支持多账户数据隔离和跨设备同步。

核心功能特性

• 🔍 多源聚合搜索：内置数十个免费资源站点，一次搜索即可返回全部来源的结果。
• 📄 丰富详情页面：完整展示剧集列表、演员信息、上映年份、内容简介等。
• ▶️ 流畅在线播放：集成 HLS.js 和 VidStack 播放技术。
• ❤️ 收藏与续播功能：数据通过 LocalStorage 存储，未来计划扩展数据库支持。
• 📱 PWA 支持：支持离线缓存、安装到桌面或主屏幕，提供接近原生的移动端体验。
• 🌗 响应式布局：桌面端采用侧边栏，移动端使用底部导航，完美适应各种屏幕尺寸。
• 🚀 极简部署流程：仅需一条 Docker 命令即可运行完整服务，或免费部署到 Vercel 平台。
• 👿 智能广告过滤：实验性功能，可自动跳过视频中的分段广告。

详细部署步骤

本节以威联通NAS为演示平台，通过Docker Compose方式部署MoonTV。

首先，访问项目页面下载名为config.json的配置文件（主要用于配置视频源）。

接着，准备文件存储目录。我的具体路径为/share/Container/moontv，请将上述配置文件上传至NAS的对应位置。

项目作者提供了三种部署方式，其中第三种最为推荐。

基础部署代码（注意格式对齐）：

services:  
  moontv:  
    image: ghcr.io/senshinya/moontv:latest  
    container_name: moontv  
    ports:  
      - "3000:3000"  # 左侧端口可自定义  
    restart: unless-stopped

启用本地存储的普通部署版本：

对于许多拥有NAS设备的用户而言，整理本地音乐库常常是一项令人头疼的任务：

歌曲的元数据信息残缺不全、专辑封面不知去向、文件名混乱无序，甚至不同编码格式的音乐文件混杂在同一个目录中。这些情况常常导致Plex、Jellyfin等媒体服务器软件无法正确识别和归类音乐，影响浏览与播放体验。而市面上多数的音乐标签编辑器通常仅支持Windows或macOS桌面环境，难以在缺乏图形界面的NAS系统上直接运行。

Metadata Remote这款工具正是为了应对上述难题而诞生的。

它是一款专为NAS、VPS、树莓派等“无头”设备设计的音乐元数据编辑器。你无需在设备上安装庞大的音乐管理软件，也避免了在命令行中手动操作文件的繁琐。仅需通过Docker容器启动服务，然后使用任何设备的网页浏览器进行访问，即可轻松编辑音乐文件的曲目标题、艺术家、所属专辑、封面图像等核心信息。

简而言之，其核心理念是：

只要你能够使用网页浏览器，就可以借助Metadata Remote来系统化地整理你的整个音乐资料库。

项目特征

• 支持无头服务器环境：完美适配威联通、群晖、TrueNAS、Unraid等主流NAS系统，无需连接显示器或借助远程桌面/VNC等图形化访问方式。
• 部署快捷，近乎零配置：基于Docker容器化技术，实现“开箱即用”。从拉取镜像到服务就绪，整个过程通常在一分钟之内即可完成。
• 提供智能元数据建议：工具能够智能分析文件名与文件夹的组织结构，自动推荐可能匹配的曲目信息，对于处理精选集、合辑等复杂场景尤为有效。
• 完整的编辑历史追溯：所有对元数据的修改操作均支持撤销与重做，系统最多可记录1000步历史记录，即使发生误操作也能轻松回退到之前的任何状态。
• 强大的批量处理功能：支持对选定文件夹内的所有音乐文件进行批量标签修改或统一封面替换，极大地提升了整理大量音乐文件的效率。
• 简洁现代的交互界面：提供直观的拖放操作、实时搜索过滤、本地音乐片段试听以及深色/浅色主题切换等功能，致力于提供优秀的用户体验。
• 广泛的多平台兼容性：官方提供针对x86_64、ARM64、ARMv7等多种CPU架构的Docker镜像，能够兼容从主流服务器到树莓派等微型设备在内的各类硬件。
• 支持丰富的音频格式：可处理包括MP3、FLAC、OGG、OPUS、WMA、WAV、WavPack、M4A以及M4B在内的多种常见音频文件格式。

部署流程

以下以威联通NAS为例，演示通过Docker Compose方式部署Metadata Remote的步骤。

部署所需的Docker Compose配置文件内容如下：

version: '3.8' # 若使用最新版Compose，可删除此行
services:
  metadata-remote:
    image: ghcr.io/wow-signal-dev/metadata-remote:latest
    container_name: metadata-remote
    ports:
      - "8338:8338" # 冒号左侧的宿主机端口可根据需要自定义
    volumes:
      - /share/Media/music:/music # 请将此路径替换为你实际的音乐库路径
      # 如果你有多个独立的音乐文件夹，可以采用如下方式分别挂载：
      # - /path/to/music1:/music/Library1
      # - /path/to/music2:/music/Library2
    environment:
      - PUID=${UID:-1000} # 容器内运行的用户ID，可自动识别或通过id命令查询后固定
      - PGID=${GID:-1000} # 容器内运行的组ID
    restart: always

你也可以根据音乐的分类，更细致地划分挂载目录，例如：

      - /share/Media/Music:/music                 # 主音乐库目录
      - /share/Media/HiRes:/music/HiRes          # 可选，用于存放高解析度音乐
      - /share/Media/Concerts:/music/LiveConcerts # 可选，用于存放现场音乐会录音

在威联通NAS的Container Station中，选择“创建应用程序”，将上述配置文件内容粘贴至编辑区。

对于许多 NAS 使用者而言，打理本地的音乐收藏常常伴随着诸多困扰：音轨信息残缺不全、专辑封面不翼而飞、文件命名杂乱无章，乃至不同格式的音频文件混杂在一起，导致像 Plex 或 Jellyfin 这类媒体服务器无法准确识别和归类。传统的元数据编辑软件又往往仅限在 Windows 或 macOS 桌面环境下运行，难以适配 NAS 这种缺乏图形界面的“无头”操作环境。

而 Metadata Remote 正是为了精准解决这一系列痛点而诞生的工具。

它是一款专为 NAS、VPS、树莓派等“无头设备”量身打造的音乐元数据编辑器。你无需预先安装复杂的音乐库管理后端，也不必动用繁琐的命令行指令或手动搬运文件。只需通过 Docker 轻松启动，然后打开任何现代浏览器，即可方便地编辑音乐文件的标题、艺术家、专辑、封面等各类信息。

简而言之：

只要你会使用网页浏览器，就能借助 Metadata Remote 高效整理你的整个音乐资料库。

注：之前在部署 Navidrome 时曾顺带提及 Music Tag Web，近期也计划为其撰写一篇独立的详细介绍文章。

核心特性

• 原生支持无头服务器：完美适配威联通（QNAP）、群晖（Synology）、TrueNAS、Unraid 等无图形界面的设备，无需额外连接显示器、开启远程桌面或 VNC。
• 部署迅速，配置极简：基于 Docker 容器化技术，实现近乎“开箱即用”的体验，从拉取镜像到投入使用的整个过程通常不超过一分钟。
• 智能元数据推荐：通过分析文件名和目录结构，自动为曲目推荐合适的标签信息，尤其擅长处理精选集、合辑等复杂情况。
• 完整的操作历史追溯：支持对所有编辑步骤进行撤销与重做，系统最多记录 1000 步历史操作，即使发生误操作也能轻松复原。
• 高效的批量处理能力：可一键批量修改整个文件夹内所有文件的标签或封面图片，显著提升资料整理的工作效率。
• 简洁现代的交互界面：提供流畅的拖放操作、实时搜索筛选、本地音乐试听播放、深色模式等多种功能，致力于提供优秀的用户体验。
• 广泛的平台兼容性：提供 x86_64、ARM64、ARMv7 等多架构 Docker 镜像，兼容主流硬件平台及树莓派等微型服务器。
• 丰富的音频格式支持：全面支持编辑 MP3、FLAC、OGG、OPUS、WMA、WAV、WavPack (WV)、M4A 和 M4B 等常见音频格式的元数据。

详细部署流程

以下以威联通（QNAP）NAS 为例，展示通过 Docker Compose 方式进行部署的步骤。

核心部署代码如下：

version: '3.8'  # 若使用最新版本Compose可删除此行
services:
  metadata-remote:
    image: ghcr.io/wow-signal-dev/metadata-remote:latest
    container_name: metadata-remote
    ports:
      - "8338:8338"  # 冒号左侧的宿主机端口可根据需要自定义
    volumes:
      - /share/Media/music:/music  # 请将此路径替换为你的实际音乐库路径
      # 如果你拥有多个独立的音乐文件夹，可以参照以下方式分别挂载：
      # - /path/to/music1:/music/Library1
      # - /path/to/music2:/music/Library2
    environment:
      - PUID=${UID:-1000}  # 自动识别当前用户ID，也可通过 `id` 命令查询并固定
      - PGID=${GID:-1000}
    restart: always

你也可以根据音乐的分类，进一步细化挂载目录的结构，例如：

在之前的分享中，我曾介绍过MoonTV和LibreTV等快速部署影视站的项目，为那些不希望依赖本地硬盘或云存储的用户提供了一种便捷的观影解决方案。

然而，这些方案仍然存在一定的局限性。最近，一款名为OmniBox的聚合平台崭露头角，经过实际体验，其功能表现更为全面和强大，值得向大家详细推荐。

OmniBox项目简介

本项目本身不直接提供任何影视资源，而是作为一个集成框架来运作。请继续阅读以深入了解其功能。

OmniBox是一个以聚合为核心设计的家庭影视系统，支持多种来源的影视内容、网盘资源、电视信号以及直播源等。与传统的单一播放器不同，它更接近于一个多功能整合平台，提供网页端和TV端两种界面，用户体验接近主流流媒体服务。此外，系统还支持弹幕API和TMDB API的接入，在播放页面中可以查看分季分集的海报、剧照、剧情概要、演员表和评分等详细信息。对于不习惯在网页端观看的用户，还可以通过连接TVbox、MBOX等播放器，在个人电脑或移动设备上享受观影乐趣。

OmniBox的多数功能设计参考了其他开源项目，例如alist-tvbox、libretv、影视仓和openlist等。对于曾经使用过这些项目的用户来说，上手过程会显得格外顺畅。

总而言之，在成功部署并配置好该项目后，观看各类影视内容时不再需要频繁切换不同应用，有效避免了来回跳转的繁琐操作。

项目目前仍处于持续优化阶段，未来计划逐步加入更多实用功能，建议用户关注其更新动态。

部署步骤

完整项目名称：lampon/omnibox

建议首先通过SSH连接到NAS设备，创建一个共享网络，名称可以自定义：

docker network create media-net 

部署代码如下：

services:   omnibox:      image: lampon/omnibox:latest      container_name: omnibox      restart: always      environment:         - TZ=Asia/Shanghai      ports:         - "7023:7023"# 冒号左侧可自定      volumes:         - /share/Container/omnibox/data:/app/data      # 这一段PanSou也要加上重新创建一下，后文会提及      networks:         - media-net                networks:  media-net:    external:true  

打开威联通的Container Station应用，创建新的应用程序。

使用指南

本节将简要展示基本操作界面，但要实现完整功能，还需要进行后续配置。请继续阅读以下内容。

如果按照上述步骤完成部署，在浏览器中输入NAS_IP:7023即可访问系统。

用户进入界面后可以直观看到各项功能，操作方式简单明了，只需在对应的功能模块执行相应操作即可。

系统支持模糊搜索功能。

但此时点击搜索结果，还无法直接播放内容——这正是本节开头提到的需要进一步配置的部分。请参考下一节内容。

配置说明

点击界面右上角的「我的」-「管理」选项。

✅ 影视站配置

通过导入导出功能添加配置文件。用户也可以自行添加其他配置源。关于配置文件的获取，需要手动将文本文件后缀从.txt修改为.json格式后再进行上传操作。

如下所示。可以查看各个站点的基本评价信息。视频质量方面基本以1080P为上限，毕竟是在线观看模式，未做深入探索。如果追求更高画质，后续还可以配置网盘功能。

实际上，完成此步骤后，如同上一节内容所示，在首页已经可以自由点击观看。但部分用户可能仍有网盘使用需求，我们继续往下配置。

✅ 网盘相关配置

本节内容分为「盘搜应用」和「网盘授权」两部分。

网盘授权功能，如前所述，借鉴了Alist的设计理念，因此不再赘述，每个网盘都有相应的详细文档说明。

盘搜应用默认已经部署完成，如下图所示，点击「配置应用地址」。

在先前的内容中，我们曾详细介绍过众多Docker应用，其中部分应用内置了前端身份验证功能。以网络附加存储设备为例，其网页管理界面本身具备登录认证机制，并且支持配置双重验证以增强各类网页服务的安全性。再如QBittorrent、Transmission和Emby这类常见Docker服务，它们也自带了登录验证模块。然而，许多轻量级工具类服务（例如IT-Tools等）可能缺乏此类防护，一旦他人知晓您的服务域名，便可能无需验证直接访问。

本文我们将深入探讨一款中间层认证服务——Tinyauth，它能够有效保护我们的应用服务免受未授权访问。通过下方的动态演示图，您可以直观感受其运作效果。

请注意，Tinyauth目前处于积极开发阶段，其配置参数可能会频繁调整。

在更新前，请务必详细阅读官方发布说明。若仅限个人使用，Nginx、Caddy或Lucky等工具内置的BasicAuth功能通常已足够便捷。

由于Lucky自带认证模块，且Tinyauth官方文档明确指出其对Nginx Proxy Manager有良好兼容性，因此我们将延续上一篇文章的思路，基于NPM进行配置优化。

Lucky的认证界面如下所示。如果您认为其功能已满足需求且对界面美观度要求不高，则无需额外部署Tinyauth。但若您希望集成Google或GitHub等第三方登录方式，本项目将是一个理想选择。

Tinyauth 概述

Tinyauth是一款采用Go语言编写的轻量级身份认证中间件，主要应用于自托管或容器化环境，旨在为网页应用快速增添访问控制层。它无需修改原有应用代码，仅需通过反向代理工具（如Traefik、Nginx、Caddy）进行接入，即可实现登录保护功能。

核心特性

• 轻量简洁：仅需单个二进制文件即可运行，无额外依赖项，系统资源占用极低。
• 即开即用：配置过程简单明了，常见应用场景仅需设置环境变量即可完成部署。
• 多种认证方式：支持传统的用户名密码验证，同时兼容OAuth登录协议（如Google、GitHub）。
• 反向代理友好：可与Traefik、Nginx、Caddy等主流代理工具无缝集成，适用于家庭实验室及企业级小型应用。
• Cookie统一认证：基于域名设置Cookie，实现在同一主域名下多个应用的单一登录体验。

适用场景

• 为个人NAS服务（例如QNAP）增加外网访问安全层。
• 保护内部管理工具（如Portainer、Grafana、Whoami等）的访问权限。
• 在家庭实验室或小型团队项目中快速部署身份验证，无需构建复杂的OAuth服务体系。

部署前准备

我们需要预先生成用户名与密码的哈希值，以及一个32字节的随机密钥。

通过SSH工具连接至NAS设备，依次输入以下命令。请将生成的内容复制保存以备后续使用。具体操作可参考下方示意图。

docker run -it –rm ghcr.io/steveiliop56/tinyauth:v3 user create –interactive

安装与配置步骤

首先创建一个专用网络，以便需要反向代理的应用与NPM保持连通。

查阅官方文档后，我推荐使用以下代码进行配置。请注意，我在此创建了专属的网桥连接。

services:
  app:
    image: jc21/nginx-proxy-manager:latest
    container_name: npm
    restart: always
    environment:
      TZ: Asia/Shanghai
      DISABLE_IPV6: "true"
    volumes:
      - /share/Container/npm/data:/data
      - /share/Container/npm/letsencrypt:/etc/letsencrypt
    ports:
      - "81:81"      # NPM管理面板（仅限内网访问）
      - "8442:80"    # 公网HTTP端口（使用非标准端口）
      - "8443:443"   # 公网HTTPS端口（使用非标准端口）
    networks:
      - npm-net

  tinyauth:
    image: ghcr.io/steveiliop56/tinyauth:v3
    container_name: tinyauth
    restart: always
    environment:
      - APP_URL=https://auth.19960509.xyz:8443    # 通过NPM的8443端口访问
      - USERS=ydxian:$$2a$$10$$9Yc/rH90cPJEJjemF6oRmu9tbnClFyDhjSSjlRyJFPstuFqxr45Ky
      - SECRET=597c4353178836b87f78c5588fc6fc60
    networks:
      - npm-net
    ports:
      - "5202:3000"

networks:
  npm-net:
    external: true

需要注意的是，在国内使用非标准端口号时，APP_URL参数需完整填写地址。