SnapOtter 教程:一条 docker run,把 CloudConvert/Smallpdf/Otter 搬回自己服务器

📌 项目地址:github.com/snapotter-hq/SnapOtter | 星数:2765+ | 架构:AMD64 + ARM64 | 许可:开源自托管

📋 项目简介

文件处理需求散落在十几个在线工具里:转格式去 CloudConvert、压 PDF 去 Smallpdf、转写录音去 Otter——每个都要上传文件到别人的服务器。SnapOtter 把这整条链路收回内网:图像/视频/音频/PDF/文档五大模态 200+ 工具,外加本地 AI(去背景、超分、OCR、转写),网页 UI、REST API、流水线三种用法,一条 docker run 部署完成。文档数字化场景的深度方案可搭配 paperless-gpt教程:LLM增强OCR文档管理。

📦 五大模态工具清单

模态数量代表能力
图像112缩放/裁剪/压缩/水印/美化截图/表情包/矢量化和 GIF 工具;55+ 输入格式(含 23 种相机 RAW)、17 种输出
视频57转换/压缩/裁剪/合并/提取音频/防抖/改帧率/烧录字幕、MOV→MP4、MKV→MP4 等
音频27转换/修剪/归一化/淡入淡出/变调/降噪/合并拆分/波形图
PDF34合并/拆分/压缩/加密解锁/涂黑/签名/水印/页码/OCR/转 JPG/PNG/TIFF
文件23CSV/JSON/XML/YAML 互转、Excel→CSV、图表生成、ZIP 打包解压

🚀 快速开始

# 一条命令(内置 Postgres 17 + Redis 8)
docker run -d --name SnapOtter \
  -p 1349:1349 -v SnapOtter-data:/data \
  snapotter/snapotter:latest

# 打开 http://localhost:1349
# 默认账号 admin / admin —— 装完就是全部

# 生产:Compose 栈 + NVIDIA GPU 加速见仓库 Deployment 一节
# 关闭统计:SNAPOTTER_ANALYTICS=off 或应用内后台退出

💡 使用建议

📚 常见问题

SnapOtter 是什么?

开源的自托管文件处理基础设施(2765 星):转换、压缩、OCR、转写、去元数据、本地 AI 处理,覆盖图像/视频/音频/PDF/文档五大模态共 200+ 工具,通过网页 UI、REST API 和流水线使用。定位是一套栈替代 CloudConvert、Smallpdf、TinyPNG、TinyWow 和 Otter.ai——文件永不离开你的服务器。

怎么部署?

一条命令:docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest。打开 http://localhost:1349 用 admin/admin 登录即可——单容器内已内置 Postgres 17 + Redis 8,无任何外部 SaaS 依赖。生产环境可用 Compose 栈 + NVIDIA GPU 加速;支持 AMD64 与 ARM64(含 Apple Silicon 和树莓派)。

本地 AI 能力有哪些?

全部在你的硬件上运行、无需联网:去背景、图片超分、老照片修复与上色、物体擦除、人脸模糊/增强、图片与 PDF 的文字提取(OCR)、音频转写、视频自动字幕、画布扩展、透明度修复。内置 Fast OCR 只给官方镜像增加约 25 MiB;可选的精度包按需安装。