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设备时，我们常常会遇到一个普遍问题：系统自动生成的分享链接通常过于冗长复杂。对于临时性分享尚可接受，但若需长期管理使用，不仅会增加管理员的工作负担，分享对象在访问时也会感到操作不便。您不妨亲自检查手头的NAS设备，其生成的链接长度往往超出预期。

为解决这一常见痛点，本文将详细介绍一个高效的开源项目——Zurl短链接系统。该系统能够将冗长的NAS分享地址转换为简洁易记的短链接，大幅提升分享与管理效率。值得注意的是，Zurl不仅提供基础的链接缩短服务，还集成了点击统计、有效期设置、User-Agent屏蔽等多项实用功能，特别适合NAS用户搭建专属的分享管理平台。

Zurl项目核心解析

Zurl是一款设计简洁且功能全面的短链接生成系统，能够快速创建短链接，便于日常分享与集中管理。该项目致力于提供轻量级解决方案，帮助用户更有效地管理和追踪链接使用情况。

其运作机制如下：当用户提交一个长链接时，系统会自动生成唯一短码（例如abc123），并将「短码→原始URL」的映射关系存储于数据库中（Zurl默认采用SQLite作为主数据库）。当访问者通过域名/短码形式（如yourdomain.com/abc123）访问时，服务器会根据映射关系查询原始URL，并通过302或307重定向将浏览器引导至目标网站。

主要功能特性

短链接生成：支持将任意长链接转换为简洁短链接，提升分享与传播效率。

链接管理：提供直观易用的管理界面，管理员可轻松查看、编辑和删除链接记录。

延迟计数：采用延迟记录机制统计每个短链接的点击次数，有效避免高并发场景下的系统压力。

自动获取标题：在添加链接时，系统会自动尝试获取长链接的页面标题，便于后续识别与管理。

支持UA屏蔽：管理员可自定义需要屏蔽的User-Agent列表，防止恶意访问行为。

数据迁移：支持将YOURLS系统中的数据迁移至Zurl，方便用户平滑过渡。

API接口：提供完整的API接口，支持二次开发和与其他系统的无缝集成。

有效期设置：允许为每个短链接设置自定义有效期，增强链接安全性。

自定义站点信息：支持个性化配置站点名称、Logo等基础信息。

API Token管理：提供完整的API令牌管理功能，确保接口访问安全。

中英文双语：内置中英文双语界面，满足不同用户群体的使用需求。

高级分析功能：规划中的高级统计分析模块，未来将提供更深入的数据洞察。

登录会话管理：计划实现的会话管理功能，将进一步提升用户体验。

项目地址：https://github.com/helloxz/zurl

详细部署步骤

本文以威联通NAS为操作平台，通过Container Station采用Docker Compose方式进行部署演示。

部署代码如下：

services:  zurl:    container_name: zurl    image: docker.20040311.xyz/helloz/zurl # 如果网络没问题可删掉代理    ports:      - "3080:3080" # 冒号左侧可更改    restart: always    volumes:      - /share/Container/zurl/data:/opt/zurl/app/data # 左侧自行替换路径

打开Container Station应用，将上述代码适当修改后粘贴至创建框内，即可创建新的应用程序实例。

操作使用指南

若按照上述配置代码完成部署，在浏览器中输入NAS_IP:3080即可访问Zurl服务界面。

首次访问时需要完成系统初始化设置。

成功登录后即可开始使用各项功能。将需要缩短的长链接粘贴至输入框内，系统会自动生成对应的短链接。需要注意的是，初始生成的是内网访问链接。若需分享至外网，需通过反向代理并基于外网域名重新生成。

使用Lucky进行反向代理的配置示例如下：

完成域名配置后，再次生成的便是可在公网访问的文件分享短链接（图中蓝色部分）。

通过生成的短链接访问，系统会自动重定向至原始的分享站链接。

点击界面右上角的管理按钮，可以浏览项目概览、进行站点自定义设置、生成API密钥等高级操作。

总结与建议

总体而言，Zurl是一个轻量级且功能完善的短链接管理系统，特别适合解决NAS环境中分享链接冗长、管理不便的痛点。通过部署使用Zurl，不仅能让分享链接更加美观易用，还能实现精细化的统计分析和访问控制。如果您也深受繁琐NAS分享链接的困扰，不妨尝试部署Zurl系统，为日常文件分享体验增添更多便捷与优雅。

如需了解更多技术细节或解决特定问题，建议访问项目官方页面查阅完整文档。

在部署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 等具体权限。

对于许多拥有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中，选择“创建应用程序”，将上述配置文件内容粘贴至编辑区。

本期向大家推荐一款设计出众的在线工具箱——极速箱（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 即可访问并使用极速箱。

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

开发者已经预先对工具进行了合理的分类。对于像我这样需要经常撰写技术文章和应对日常工作的人来说，这些工具分布在不同的分类中。我只需将最常用的几个点击“收藏”按钮。

对于依赖网盘的用户而言，资源查找与跨平台转存常常是繁琐的流程。本期内容将为大家详细介绍一款功能强大的工具——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界面。首次使用需要注册账户，请注意账户名不能使用中文。

在之前的分享中，我曾介绍过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参数需完整填写地址。

图片在我们的数字生活中扮演着至关重要的角色，无论是社交媒体分享、内容创作还是日常工作文档，都离不开它们。然而，高清图片带来的大体积文件，常常导致网页加载缓慢，并迅速消耗宝贵的存储空间。传统的在线处理工具虽然便捷，但要求用户上传图片至远程服务器，这引发了隐私安全的担忧，并且可能受制于网络状况和文件大小限制。

为此，我们将介绍一款名为Mazanoke的开源工具，它能够在本地运行，通过Docker快速部署，为您提供一个安全、高效的图片处理环境。

Mazanoke的核心优势在于其完全在浏览器端执行所有操作。您的图片无需离开本地设备，彻底杜绝了隐私泄露的风险。该工具支持广泛的图片格式处理，包括JPG、PNG、WebP、HEIC、AVIF、GIF及SVG，具备压缩与转换功能，界面直观，易于上手。

接下来，我们将详细讲解如何在您的本地环境（以威联通NAS为例）中部署Mazanoke。通过搭建这个私有化工具，您可以摆脱对第三方服务的依赖，实现数据的完全本地化处理，获得对图片优化流程的完全控制权。

项目核心特点

🖼️ 全面的浏览器端图片优化：

• 灵活调整图像质量参数。
• 设定目标文件大小以实现精准压缩。
• 设置最大宽度或高度来限制图片尺寸。
• 支持直接从剪贴板粘贴图片进行处理。
• 在JPG、PNG、WebP等主流格式间相互转换。
• 支持将HEIC、AVIF、GIF、SVG等格式转换为通用格式。

🔒 极致隐私与安全保护：

• 完全离线工作，无需网络连接。
• 所有图片处理均在您的设备本地完成。
• 自动移除EXIF元数据（如拍摄地点、时间等敏感信息）。
• 不包含任何用户行为追踪代码。
• 支持安装为独立的渐进式Web应用（PWA），提供类似原生应用的体验。

🕙 未来发展路线图：

• 计划增加批量文件上传功能。
• 将持续扩展支持的图像文件类型。
• 近期已新增HEIC、AVIF、GIF、SVG至JPG/PNG/WebP的转换功能。
• 预计添加记住用户上次操作设置的功能。
• 未来可能集成图像裁剪工具。

详细部署流程

我们以威联通NAS系统作为部署平台，采用Docker Compose这一高效便捷的容器编排方式。

以下是关键的部署配置文件代码，请注意保持YAML格式的严格缩进：

services:
  mazanoke:
    container_name: mazanoke
    image: ghcr.io/civilblur/mazanoke:latest
    ports:
      - "3474:80" # 请将冒号左侧的3474替换为您NAS上未被占用的端口号
    environment:
      - USERNAME=YourUsername # 请在此处设置您自定义的登录用户名
      - PASSWORD=YourPassword # 请在此处设置您自定义的登录密码

部署配置可参考下图示意：

功能使用与界面展示

按照上述配置成功部署后，您可以在浏览器中输入 您的NAS_IP地址:3474 来访问Mazanoke服务。

界面默认采用深色主题，您可以在右上角轻松切换为浅色模式以适应不同偏好。

工具的功能设计直观，基本符合“所见即所得”的原则。虽然界面为英文，但主要功能通过图标和通用术语呈现，理解起来并不困难。当然，您也可以借助浏览器的网页翻译功能。为了更清晰地说明，以下将对主要功能区域进行介绍：

顶部操作区域： 标注为“Drop or paste images”，您可以直接将图片文件拖拽至此区域，或从剪贴板粘贴，也可以点击“Browse”按钮从本地选择上传。支持的格式包括：JPG、PNG、WebP、HEIC、AVIF、GIF、SVG。

参数设置区域：

• 优化方法 (Optimization method)：
  • 设置图片质量 (Set image quality)：通过滑动条调整，较高值保留更多细节，较低值生成更小文件。
  • 限制文件大小 (Limit file size)：设定一个目标文件大小（如500KB），工具会自动压缩图片以达到该目标。
• 尺寸调整 (Dimensions)：
  • 保持原始尺寸 (Keep original dimensions)。
  • 限制尺寸 (Limit dimensions)：设定图片的最大宽度和高度。
• 格式转换 (Convert to)：
  • 默认 (.JPG, .PNG, WebP 保留格式)：保持原格式（JPG/PNG/WebP），仅将HEIC、AVIF、GIF、SVG转换为.PNG。
  • 转换为JPG。
  • 转换为PNG。
  • 转换为WebP。

完成配置后，将待处理的图片拖入或上传，系统会自动开始处理，结果将显示在右侧的“图片”列表中。一个非常实用的设计是，所有的处理历史都会保留，方便您对比不同参数下的效果，从而找到最优方案。个人通常倾向于将图片转换为WebP格式，因为它在保持高视觉质量的同时，能提供比其他常见格式更优异的压缩率。