📎 SnapOtter：自托管文件工具箱 200+ 工具 本地文档处理全覆盖

SnapOtter 是一款开源自托管文件处理工具箱，一套系统整合图片压缩、视频转换、音频处理、PDF 合并拆分、文件格式互转等 200+ 工具。Docker 一键部署，本地 AI 加速，文件永不离开本地服务器。隐私优先，替代所有云端订阅，AGPLv3 开源免费。

🎤 引言

用过的云端文件处理服务有多少个？TinyPNG 压缩图片，iLovePDF 处理 PDF，CloudConvert 转换格式，Otter.ai 转录音频，Canva 做设计……每个工具都要注册账号、上传文件、按次付费。

更关键的是：你的文件在这些服务上经历了什么，你根本不知道。企业数据泄露成本平均 488 万美元（IBM 2024），GDPR 罚款屡创新高——把客户合同、财务报表、员工资料传给别人处理，永远有风险。

SnapOtter 把这一切打包到了一个 Docker 容器里。200+ 工具，图片/视频/音频/PDF/文件全覆盖，本地运行，隐私优先。开源免费，自托管部署，1.9k Stars，1,937 Commits。

⭐ 核心功能

1. 200+ 工具，五大类别全覆盖

支持的输入格式：55+ 种（含 23 种 RAW 格式），输出格式 14 种。JPG、PNG、HEIC、WebP、PDF、MP4、MOV、MKV、MP3、M4A、AAC、OGG——主流格式基本全覆盖。

2. 本地 AI 加持

所有 AI 功能都在本地运行，不需要网络，不需要 API Key：

• 抠图去背景：上传产品图，一键去除背景
• 图片放大：老照片修复，低分辨率图片高清化（RealESRGAN）
• 照片上色：黑白老照片自动上色
• 物体消除：去掉图片中不需要的内容
• 人脸模糊：隐私保护，一键对人脸打码
• OCR 文字识别：从图片和 PDF 中提取文字
• 音频转录：把录音转成文字
• 自动生成字幕：视频 AI 生成字幕文件

3. 浏览器端图层编辑器

内置基于浏览器的图层编辑器，支持：

• 画笔、形状、渐变工具
• 曲线、色阶调整
• 滤镜特效
• 键盘快捷键

所有处理在本地硬件完成，不上传服务器。

4. 工作流 Pipeline

把多个工具串联成自动化流水线：

• 无限步骤，支持条件分支
• JSON 导入/导出，分享工作流
• 批量处理无限文件
• 定时任务化

例如：自动监控文件夹 → 新图片自动压缩 + 加水印 + 放大 + 存档。

5. REST API

每个工具都有对应的 REST API，可以用程序调用：

curl -X POST http://localhost:1349/api/v1/tools/image/compress \
  -H "X-API-Key: your-api-key" \
  -F "[email protected]"

API 文档在 /api/docs，交互式调试。

6. 单容器一键启动

最极致的安装体验——一行命令，不需要额外依赖：

docker run -d --name SnapOtter \
  -p 1349:1349 \
  -v SnapOtter-data:/data \
  snapotter/snapotter:latest

然后访问 http://localhost:1349，用 admin / admin 登录。

内置 PostgreSQL 17 + Redis 8，无需手动配置数据库。生产环境用 Docker Compose 扩展，支持 NVIDIA GPU 加速。

📥 安装与使用

快速启动（单容器）

# 一行命令，嵌入式数据库，无需额外配置
docker run -d --name SnapOtter \
  -p 1349:1349 \
  -v SnapOtter-data:/data \
  snapotter/snapotter:latest

# 访问 http://localhost:1349
# 登录 admin / admin

生产部署（Docker Compose）

services:
  snapotter:
    image: snapotter/snapotter:latest
    ports:
      - "1349:1349"
    volumes:
      - snapotter-data:/data
    environment:
      - NVIDIA_VISIBLE_DEVICES=all  # GPU 加速
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [gpu]

volumes:
  snapotter-data:

NVIDIA GPU 加速

AI 相关功能（图片放大、修复、上色）需要 GPU 支持：

# 确认 NVIDIA 驱动和 Docker NVIDIA 运行时已安装
docker run --gpus all snapotter/snapotter:latest

多架构支持

一个镜像，多种硬件通用。

SSO / OIDC 登录

支持企业级身份认证：

• Google
• GitHub
• Okta
• 任意 OpenID Connect 提供商

适合团队协作场景。

🎯 适用场景

1. 替代所有云端文件处理服务

把 TinyPNG、iLovePDF、CloudConvert、Canva 这些订阅全部停掉，一套 SnapOtter 覆盖所有需求。文件永远在自己服务器上，不存在隐私泄露风险。

2. 设计师/摄影师工作流

批量压缩、格式转换、水印、RAW 处理、照片修复——本地 GPU 加速比云端更快，成本更低。

3. 企业内部文件处理

合同 PDF 去敏感信息、自动签章、批量加水印、格式统一——内网部署，数据不出公司网络。

4. 开发者 API 集成

把文件处理能力集成到自己的产品里，通过 REST API 调用，无需自己实现和维护各种文件处理逻辑。

5. NAS / 服务器文件管理

安装在群晖、TrueNAS、Unraid 等 NAS 设备上，做家庭媒体中心或小型工作室的文件处理中枢。

🔍 对比/替代方案

SnapOtter 的核心优势：

• 唯一一个「200+ 工具全合一 + 本地 AI + 全平台」的开源方案
• Stirling-PDF 只做 PDF，ConvertX 只做转换，SnapOtter 是真正的 all-in-one
• 对比云端服务：完全隐私，无订阅费，无文件离开服务器

⚠️ 注意事项

1. v2.0.0 即将发布（当前 latest 是 v1.x）

README 提到：v2.0.0 包含全部 200+ 工具，v1.x 目前主要是图片工具。v2.0 正在修复最后一个 local AI 安装问题，正式版即将发布。生产环境建议等 v2.0 稳定版。

2. AGPLv3 许可证要注意

SnapOtter 采用 AGPLv3 + 商业双许可证。个人使用和自托管完全免费；但如果以网络服务形式运行修改版，必须开源。商业 SaaS 嵌入需要购买商业许可证。

3. 存储空间需求

Docker 镜像约 4.4 GB，安装前确保服务器有足够空间。处理大文件时也需要留意 /data 卷的磁盘容量。

4. 内存和 GPU 要求

本地 AI 功能（放大、修复、上色）推荐至少 8GB RAM；有 NVIDIA GPU 可加速处理，否则 CPU 运行较慢。

5. 单体维护者风险

SnapOtter 是独立开发者维护，没有 VC 也没有公司背书。长期维护存在连续性风险（bus factor 风险）。生产环境使用建议关注 GitHub 活跃度。

✅ 总结

SnapOtter 是目前最完整的自托管文件处理工具——200+ 工具覆盖图片/视频/音频/PDF/文件五大类别，本地 AI 加持，REST API + Pipeline + 图层编辑器，一行 Docker 命令启动。替代所有云端文件处理服务，文件永远不出自己的服务器。

优点：

• 200+ 工具 all-in-one，覆盖场景最全面
• 完全本地运行，隐私零风险
• 本地 AI（抠图/放大/上色/OCR），无需 API Key
• REST API 完善，可集成到自己的产品
• Pipeline 工作流，批量自动化
• 单容器启动，部署极简
• AMD64 + ARM64 多架构，树莓派都能跑

缺点：

• 当前 latest 是 v1.x，v2.0 还在最后修复阶段
• 单体维护者，长期维护存在不确定性
• AGPLv3 许可证，改作网络服务需开源
• 本地 AI 功能无 GPU 会比较慢

推荐指数：⭐⭐⭐⭐（4/5）

适合所有对文件处理隐私有要求、不想付订阅费、需要一站式替代多个云服务的用户。Stirling-PDF 太单一，云端工具不放心——SnapOtter 是在自托管领域目前最接近「全能」的选择。

GitHub 仓库：snapotter-hq/SnapOtter
官网：snapotter.com
在线演示：demo.snapotter.com
Docker Hub：hub.docker.com/r/snapotter/snapotter