项目介绍
OmniTools 把多种常用处理工具集中在网页中,覆盖图片、文档、文本和数据转换。它适合放在 NAS 作为便捷入口,是否适合大文件还要看浏览器内存和具体工具实现。
工具集按媒体、PDF、文本和数据分类提供操作入口。不同工具实现和资源需求不同,应分别检查。
适合家庭服务器上的日常小工具。先处理小文件,确认输出后再增加批量。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 媒体处理 | 缩放转换图片等 |
| PDF 操作 | 合并拆分与整理 |
| 文本列表 | 格式化和转换 |
| 日期计算 | 核对时间与时区 |
| 数据工具 | 按任务选择转换 |
界面展示

图 1:官方仓库提供的项目示意图,用于说明功能与布局。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 知识与效率 |
| 项目仓库 | iib0011/omni-tools |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 使用下面配置启动,访问
http://NAS_IP:8087。可先用官方在线入口查看需要的功能,再自行部署。 - 按日常需求选一项测试,例如图片缩放或 PDF 处理,输入小文件后检查输出尺寸、清晰度与格式。
- 处理较大任务时观察浏览器资源,保留原件。对于重要文档,用独立阅读器检查输出文件,避免只看处理成功提示。
首次使用与操作检查
先做一次图片缩放和 PDF 拆分,核对输出尺寸与页数,再试常用文本工具。
大文件观察浏览器内存,原件始终保留。不同工具的本地处理与联网行为按实际功能确认。
Docker Compose
依据官方 README 的 Compose 示例整理,宿主端口改为 8087。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/omni-tools/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/omni-tools
cd /volume1/docker/omni-tools
HALO_PREPARE
cd /volume1/docker/omni-tools
services:
omni-tools:
image: iib0011/omni-tools:latest
restart: unless-stopped
ports:
- "8087:80"
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 不同工具有不同格式限制,不把一个功能的支持范围套用到整个工具箱。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
保存 Compose 和镜像版本,工作文件按自己的目录备份;网页缓存不能作为长期存储。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。
参考资料
配图来自 iib0011/omni-tools 官方仓库,按 MIT 许可 保留来源与许可;图片只做等比例缩小和压缩。