このページは機械翻訳されています。間違いを見つけましたか？改善にご協力ください。
SnapOtter
Search K

日本語

English
简体中文
繁體中文
한국어
Español
Français
Italiano
Português (Brasil)
Deutsch
Nederlands
Svenska
Русский
Polski
Українська
العربية
Türkçe
हिन्दी
Tiếng Việt
Bahasa Indonesia
ไทย

日本語

English
简体中文
繁體中文
한국어
Español
Français
Italiano
Português (Brasil)
Deutsch
Nederlands
Svenska
Русский
Polski
Українська
العربية
Türkçe
हिन्दी
Tiếng Việt
Bahasa Indonesia
ไทย

Appearance

開発を支援する
スター2.2k

はじめに ​

インストール前に試す

demo.snapotter.com で完全な UI を試せます。サインアップもインストールも不要です。

クイックスタート ​

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

この単一のコンテナーは必要なものをすべて実行します。DATABASE_URL を設定せずに、ループバック インターフェイス (埋め込みモード) で独自の PostgreSQL と Redis を開始し、すべてのデータを SnapOtter-data ボリュームに保持します。これは、ホームラボで SnapOtter またはセルフホストを試す最も速い方法です。運用環境では、PostgreSQL と Redis を独自のコンテナーに保持する 正規の Docker Compose スタック を使用します。埋め込みモードは root (デフォルト) として実行され、DATABASE_URL を設定するとすぐに自動的にオフになります。

Raspberry Pi、古いラップトップ、小さな VPS にインストールしますか？調整済みの手順と、限られたハードウェアで何が期待できるかについては、低リソース環境のセットアップ を参照してください。

初回ログイン時にパスワードの変更を求められます。

匿名のプロダクトアナリティクス

SnapOtter にはデフォルトで匿名のプロダクトアナリティクスが含まれています。オフにするには、Settings → System → Privacy を開き、Anonymous Product Analytics をオフにしてください。インスタンス全体で即座に停止します。

環境変数 SNAPOTTER_TELEMETRY=0（false と off も使えます）を設定すると、リビルドせずにインスタンスのすべてのテレメトリを無効にできます。

エラー監視は Sentry によって提供されており、Sentry はオープンソースプログラムを通じて SnapOtter をスポンサーしています。

何が収集されるかの詳細については、SnapOtter が収集するもの を参照してください。

NVIDIA CUDA アクセラレーション

NVIDIA CUDA で高速化された背景除去、アップスケーリング、顔の強調、および復元用に --gpus all を追加します。 OCR は CPU ベースのままで、GPU アクセスの有無にかかわらず、同じイメージ内で動作します。

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

NVIDIA Container Toolkit が必要です。 CUDA が使用できない場合は、自動的に CPU にフォールバックします。現在、VA-API、Quick Sync、または OpenCL を介した Intel/AMD iGPU アクセラレーションは AI 推論ではサポートされていません。ベンチマークについては、Docker タグ を参照してください。 --gpus all にもかかわらず AI ツールが CPU で実行される場合は、GPU アクセラレーションを検証する を参照してください。

GHCR でも利用可能
bash
docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data ghcr.io/snapotter-hq/snapotter:latest

どちらのレジストリもリリースごとに同じイメージを公開します。

Docker Compose ​

このページから短縮された Compose サンプルをコピーする代わりに、各リリースで保守およびテストされた実稼働ファイルを使用してください。

bash
install -d -m 700 snapotter && cd snapotter
curl --proto '=https' --tlsv1.2 -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/snapotter-hq/SnapOtter/v2.2.0/docker/docker-compose.yml

# Keep generated service credentials out of shell history and world-readable files.
umask 077
POSTGRES_PASSWORD="$(openssl rand -hex 32)"
REDIS_PASSWORD="$(openssl rand -hex 32)"
printf 'POSTGRES_PASSWORD=%s\nREDIS_PASSWORD=%s\n' \
  "$POSTGRES_PASSWORD" "$REDIS_PASSWORD" > .env

docker compose -f docker-compose.yml pull
docker compose -f docker-compose.yml up -d --no-build

正規の docker/docker-compose.yml には、4 つのランタイム ボリュームすべて、ヘルス チェック、リソース制限、耐久性のある Redis 構成、固定されたデータベース/キャッシュ イメージ、および現在のコンテナーの強化が含まれています。最初のログイン直後にデフォルトの管理者パスワードを変更します。再現可能な展開を行うには、latest をフォローする代わりに、SnapOtter アプリケーション イメージをリリース タグまたは確認したダイジェストに固定します。

すべての環境変数については 構成 を、シークレット、ネットワーク ポリシー、およびバックアップ ガイダンスについては セキュリティと強化 を参照してください。

ソースからビルド ​

前提条件: Node.js 22.22 以上、pnpm 9 以上、Docker（Postgres + Redis 用）、Python 3.10 以上（AI 機能用）、Git。

bash
git clone https://github.com/snapotter-hq/SnapOtter.git
cd SnapOtter
docker compose -f docker-compose.dev.yml up -d   # start Postgres + Redis
pnpm install
pnpm dev

できること ​

ファイル処理（200+ ツール） ​

モダリティ数ツールの例
画像107リサイズ、切り抜き、圧縮、変換、背景除去、アップスケール、OCR、透かし、コラージュ、カラー化、GIF ツール、フォーマットプリセット
ビデオ57トリミング、切り抜き、圧縮、変換、結合、オーディオ抽出、自動字幕、ビデオから GIF、リサイズ、手ブレ補正、フォーマットプリセット
オーディオ27トリミング、結合、変換、正規化、ノイズ低減、文字起こし、ピッチシフト、フェード、着信音メーカー、フォーマットプリセット
PDF / ドキュメント29結合、分割、圧縮、OCR、透かし、墨消し、Word から PDF、Excel から PDF、回転、保護、修復
ファイル23CSV から JSON、JSON から XML、CSV の結合、CSV の分割、ZIP の作成、ZIP の展開、チャートメーカー、YAML/JSON

パイプライン ​

ツールを連結して複数ステップのワークフローにし、1 枚の画像やバッチ全体に適用します：

  1. サイドバーで Pipelines を開きます。
  2. ステップを追加します（任意のツール、任意の設定）。
  3. 単一ファイルで実行するか、バッチ全体を一度に実行します。
  4. パイプラインを保存して後で再利用します。

パイプラインはデフォルトで 20 ステップを許可します。MAX_PIPELINE_STEPS=0 を設定すると上限を無制限にできます。

ファイルライブラリ ​

処理したすべてのファイルは Files ライブラリに保存できます。SnapOtter は完全なバージョン履歴を追跡するので、元のアップロードから最終出力まで、あらゆる処理ステップを辿れます。

保存は明示的です。ライブラリに保存した結果は削除するまで保持されますが、処理して未保存のまま残した結果は 72 時間後に自動的に消去されます（FILE_MAX_AGE_HOURS で設定可能）。

REST API と API キー ​

すべてのツールは HTTP 経由でアクセスできます：

bash
curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_<your-api-key>" \
  -F "file=@photo.jpg" \
  -F 'settings={"width":800,"height":600,"fit":"cover"}'

Settings → API Keys で API キーを生成します。すべてのエンドポイントについては REST API リファレンス を参照するか、http://localhost:1349/api/docs でインタラクティブなリファレンスにアクセスしてください。

マルチユーザーとチーム ​

ロールベースのアクセス制御で複数のユーザーを有効にします：

  • 管理者（Admin）: フルアクセス。ユーザー、チーム、設定、すべてのファイル/パイプライン/API キーを管理します
  • ユーザー（User）: ツールを使用し、自分のファイル/パイプライン/API キーを管理します

Settings → Teams でチームを作成してユーザーをグループ化します。

AUTH_ENABLED=true（ログインなしの単一ユーザー/自己利用の場合は false）を設定します。

スマートフォンから使う ​

SnapOtter はモバイルブラウザで動作し、アプリとしてインストールすることもできます。スマートフォンでインスタンスを開き、次のように操作します。

  • iPhone / iPad（Safari）: 共有をタップし、ホーム画面に追加 をタップします。
  • Android（Chrome）: ブラウザのメニューを開き、アプリをインストール をタップします。

インストールしたアプリは専用のウィンドウで開き、そのままインスタンスにつながります。

注意点がひとつあります。ブラウザがインストールを提案するのは HTTPS 経由のときだけです。LAN 上の通常の HTTP アドレスでもブラウザのタブでは問題なく使えますが、実際にインストールするには、証明書を備えたリバースプロキシの背後にインスタンスを配置してください（デプロイガイド を参照）。

スマートフォンやタブレットでは、画像ツールのアップロードボタンの横に 写真を撮る ボタンが表示されます。レシートやホワイトボードを撮影すると、そのままツールに取り込まれます。