omni-tools 本地部署完全指南：3 条路线搞定 100+ 工具的离线私有工具箱

omni-tools 本地部署完全指南：3 条路线搞定 100+ 工具的离线私有工具箱

【免费下载链接】omni-toolsSelf-hosted collection of powerful web-based tools for everyday tasks. No ads, no tracking, just fast, accessible utilities right from your browser!项目地址: https://gitcode.com/GitHub_Trending/om/omni-tools

想做一次 omni-tools 本地部署，给自己搭一个完全离线的私有工具箱吗？这套免费开源的离线工具集把图像处理、PDF 编辑、音视频处理、JSON/CSV 数据转换等 100 多个实用工具装进了一个不到 28MB 的 Docker 镜像里，所有文件处理都发生在你的浏览器本地——敏感数据从头到尾不会离开你的设备。

先说清楚：它凭什么让你放心

很多在线工具网站的套路是：你上传文件 → 服务器处理 → 返回结果。合同扫描件、内部报表、客户数据，全都得过一遍别人的服务器。

omni-tools 把这条路整个砍掉了。它的核心设计就是一切处理在客户端完成：你选中的文件在浏览器里被读取、加工、输出，网络上没有任何数据外流，自然也不存在账号、广告和追踪的问题。

技术栈并不复杂：React 18 + TypeScript + Vite，界面由 Material UI 提供。对使用者来说这意味着体积小（镜像仅 28MB，拉取快、占用低）、部署轻（一个容器或一批静态文件就能跑）、扩展方便（模块化定义工具，见 src/tools/defineTool.tsx）。

路线选择：按你的角色对号入座

三条部署路线没有绝对的高下之分，关键看你是谁：

• 只想用，不想维护→ Docker 路线。一条命令拉镜像，容器起完就能访问，升级就是换个镜像标签，最省心。
• 想改代码、加工具→ 源码开发模式。起一个带热重载的本地开发服务器，改一行代码立刻能看到效果。
• 有现成服务器、追求极简运维→ 静态构建路线。前端项目构建出来的就是一堆静态文件，扔给 Nginx 托管，连数据库都不需要。

三者并不互斥：今天用 Docker 跑着，明天想深入二次开发，随时可以切到源码模式。

三条路线，一步步跑起来

路线一：Docker 部署，一条命令的事 🐳

如果你装了 Docker，这是最快的路径。官方镜像iib0011/omni-tools:latest内部已经完成构建，Nginx 配置也替你做好了（Dockerfile 里可以看到它把构建产物放进nginx:alpine，并设置了 SPA 回退）：

docker run -d --name omni-tools --restart unless-stopped -p 8080:80 iib0011/omni-tools:latest

容器起来后，访问http://你的服务器:8080即可。8080 是本机映射端口，想换端口改一下映射就行。

路线二：源码模式，给二次开发者

克隆仓库后装依赖、起开发服务器，三步完成：

git clone https://gitcode.com/GitHub_Trending/om/omni-tools cd omni-tools npm install npm run dev

开发服务器会在http://localhost:5173启动，支持热重载。之后你所有的改动都会实时反映在浏览器里，是写自定义工具时的标准工作台。

路线三：静态构建，托管到自己的服务器 ⚡

npm run build

构建完成后会生成dist目录，把整个目录部署到 Nginx、Apache 或任何静态服务器即可。Nginx 侧有两点值得注意：

location / { try_files $uri $uri/ /index.html; # 单页应用路由回退 gzip on; # 压缩 css/js，首屏更快 gzip_types text/css application/javascript; }

try_files这条回退规则必不可少，否则用户刷新一个工具页会直接 404。

部署完成后，从哪些工具用起

所有工具的源码都集中在 src/pages/tools/ 下，按类别分目录，100 多个工具覆盖日常场景：

• 图片处理（image/）：压缩、裁剪、旋转、加水印、去除背景，PNG 压缩和 JPG/PNG 互转都有独立工具，发朋友圈前压一下图片、批量转格式很顺手。
• PDF 操作（pdf/）：拆分、合并、旋转、加密保护、转图片、提取内嵌图片、转 EPUB。处理合同和发票时最常用。
• 音视频加工（audio/ 与 video/）：剪辑、变速、裁剪、循环、格式转换、视频转 GIF、给视频加音轨。
• 数据转换（json/ 与 csv/）：JSON 与 CSV、XML 互转，JSON 美化、排序、校验、对比，还有行列转置、列交换等 CSV 精细操作，前端和数据分析的同学会用到。
• 文本与列表（string/、list/）：Base64 编解码、ROT13、去重、排序、统计、生成器……
• 时间与数学（time/、number/）：日期差计算、Unix 时间戳转换、工作日推算、字节换算、随机数生成。

让它变成"你的"工具集

语言：10 种语言已就绪

界面支持 10 种语言，翻译资源放在 public/locales/ 下，每个语言一个目录。想改某个词，找到对应语言目录下的 json 文件直接编辑即可，构建后生效。

加一个新工具：用官方脚手架 📦

项目内置了工具脚手架命令，一行命令生成全套模板（页面、元数据、服务层）：

npm run script:create:tool 工具名称 分类目录

比如npm run script:create:tool compress image/png，模板会自动落在 src/pages/tools/ 的对应分类目录里。你只需要在生成的service.ts里写核心逻辑，路由和页面框架都是现成的——这就是模块化架构带来的扩展效率。

卡住了？对照这张排查清单

构建时内存不够、进程被杀？给 Node 加内存上限再构建，比如在构建命令中追加--max-old-space-size=4096，把堆内存提到 4GB 一般就够（参见 package.json 的 build 脚本）。

音视频工具转码失败或没反应？这类工具依赖浏览器运行 FFmpeg 的 WebAssembly 版本（package.json 中的@ffmpeg相关依赖）。先确认浏览器支持 WebAssembly，再检查网络能否加载到 FFmpeg 的 WASM 资源——离线部署场景下这一点尤其容易踩坑。

想用上新发布的工具？拉最新代码重新部署即可：git pull && npm install && npm run build，然后重启容器或重新发布dist目录。

工具不在多，在于打开就能用、用着放心。挑一条最合适的路线，今天就给你的团队或自己搭一套 100+ 工具的私有工具箱；部署中遇到任何坑，欢迎在项目的 issue 区反馈，也顺手把用得最多的工具路径收藏下来。

【免费下载链接】omni-toolsSelf-hosted collection of powerful web-based tools for everyday tasks. No ads, no tracking, just fast, accessible utilities right from your browser!项目地址: https://gitcode.com/GitHub_Trending/om/omni-tools