SnapOtter

环境要求

• 已安装并可运行 Docker 的机器（README 未给出 Docker 安装方式）
• 默认 Web 端口 1349 未被占用
• 生产部署建议准备 Postgres 17 与 Redis 8（可用 Compose 一并拉起）
• 如需 CUDA 加速，需 NVIDIA GPU 并使用官方 GPU Compose 文件

安装与启动步骤

1. 1准备 Docker 环境

   确认本机 Docker 可正常运行容器。README 未提供 Docker 安装步骤，请先自行安装好 Docker 再继续。

2. 2一键启动容器

   用官方镜像后台启动 SnapOtter，映射 1349 端口，并把 /data 挂到命名卷做数据持久化。

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

   复制

3. 3访问并登录

   浏览器打开 http://localhost:1349，用默认账号 admin / admin 登录，首次登录会被要求修改密码。

4. 4编写生产 Compose 文件

   生产环境用 3 容器栈（app + Postgres 17 + Redis 8）。把示例内容保存为 compose.yaml。

   services:
     snapotter:
       image: snapotter/snapotter:latest
       ports: ["1349:1349"]
       environment:
         DATABASE_URL: postgres://snapotter:snapotter@postgres:5432/snapotter
         REDIS_URL: redis://redis:6379
       volumes:
         - SnapOtter-data:/data
       depends_on: [postgres, redis]
       restart: unless-stopped
     postgres:
       image: postgres:17-alpine
       environment:
         POSTGRES_USER: snapotter
         POSTGRES_PASSWORD: snapotter
         POSTGRES_DB: snapotter
       volumes: ["SnapOtter-pgdata:/var/lib/postgresql/data"]
       restart: unless-stopped
     redis:
       image: redis:8-alpine
       volumes: ["SnapOtter-redisdata:/data"]
       restart: unless-stopped
   volumes:
     SnapOtter-data:
     SnapOtter-pgdata:
     SnapOtter-redisdata:

   复制

5. 5启动 Compose 栈

   在 compose.yaml 所在目录执行，后台拉起 snapotter、postgres、redis 三个容器。

   docker compose up -d

   复制

6. 6启用 NVIDIA GPU（可选）

   有 NVIDIA GPU 时可改用官方 GPU Compose 文件获得 CUDA 加速，标签细节见官方文档。

关键配置

如何确认成功

浏览器打开 http://localhost:1349，出现登录页并能用 admin / admin 登录，即部署成功。

常见问题

注意事项

• 默认密码 admin/admin 仅适合本地试用，首次登录后请立即修改。
• 对外部署前必须更换 POSTGRES_PASSWORD 等示例凭据。
• Intel/AMD 核显不支持 AI 推理加速，这类机器上 AI 工具会跑在 CPU 上。
• OCR 在纯 CPU 与 NVIDIA 主机上都使用同一套便携 CPU 运行时；更多部署选项与 Docker 标签见 docs.snapotter.com。