LightFile NextLightFile Next

コマンドラインオプション

すべてのコマンドラインオプションの完全なリファレンス

LightFile Batchで使用できるすべてのコマンドラインオプションの完全なリファレンスです。

コマンド構文

lightfile-batch <サブコマンド> [ディレクトリ] [オプション]

サブコマンド一覧

LightFile Batchは、ファイルシステムごとに最適化されたサブコマンドを提供します。

サブコマンド説明主な必須オプション
localローカルファイルシステム（デフォルト）なし
s3Amazon S3 / S3互換ストレージ--s3-bucket, --s3-acl
ftpFTP / FTPSサーバー--ftp-host, --ftp-user
sftpSFTPサーバー--sftp-host, --sftp-user
webdavWebDAVサーバー--webdav-url
test-notifyFatalError通知のテスト送信通知設定のみ

デフォルト動作: サブコマンドを省略すると local として動作します。

# 以下は同じ動作
lightfile-batch local /path/to/images
lightfile-batch /path/to/images

基本オプション

--config, -c <path>

YAML設定ファイルを指定します。複数回指定可能です。

lightfile-batch --config config.yaml
lightfile-batch -c config1.yaml -c config2.yaml

詳細は YAML設定ファイル を参照してください。

--license-token, -l <token>

ライセンストークンを指定します。

lightfile-batch /path/to/images --license-token "your-token-here"
lightfile-batch /path/to/images -l "your-token-here"

優先順位:

  1. コマンドラインオプション --license-token
  2. 環境変数 LF_TOKEN
  3. ファイル ~/.lightfile-next/token

詳細は ライセンスのセットアップ を参照してください。

--dry-run, -n

実際の処理を行わず、処理内容をプレビューします。

lightfile-batch /path/to/images --dry-run
lightfile-batch /path/to/images -n

動作:

  • ファイルのスキャンと対象ファイルのリストアップのみ実行
  • 実際の画像最適化は行わない
  • バックアップも作成しない

--quiet, -q

コンソール出力を抑制します（エラーのみ表示）。

lightfile-batch /path/to/images --quiet
lightfile-batch /path/to/images -q

--verbose, -v

内部処理の詳細ログを出力します。

lightfile-batch /path/to/images --verbose
lightfile-batch /path/to/images -v

--non-exclusive

排他制御を無効化します。複数のlightfile-batchプロセスを同時に実行する場合に使用します。

lightfile-batch /path/to/images --non-exclusive

注意: 通常は排他制御が有効です。同じプロジェクトに対して複数のプロセスを実行すると、データ競合が発生する可能性があります。

--log-level <level>

ログレベルを設定します。

lightfile-batch /path/to/images --log-level debug

ログレベル:

  • debug: すべてのログを出力（最も詳細）
  • info: 情報ログを出力（デフォルト）
  • warn: 警告とエラーのみ出力
  • error: エラーのみ出力

環境変数 LOG_LEVEL でも設定可能です。

--log-progress-interval <interval>

進捗ログの出力間隔を設定します。

# 10秒間隔
lightfile-batch /path/to/images --log-progress-interval 10s

# 1分間隔
lightfile-batch /path/to/images --log-progress-interval 1m

# 100ミリ秒間隔
lightfile-batch /path/to/images --log-progress-interval 100ms

# 進捗ログを無効化
lightfile-batch /path/to/images --log-progress-interval 0

デフォルト: 30s（30秒間隔）

詳細は ログ機能 を参照してください。

--help, -h

ヘルプメッセージを表示します。

lightfile-batch --help
lightfile-batch local --help  # サブコマンドのヘルプ

--version

バージョン情報を表示します。

lightfile-batch --version

出力例:

lightfile-batch version v0.4.2 (commit: abc1234, built: 2024-01-01T00:00:00Z)

システムディレクトリオプション

LightFile Batchの作業ディレクトリをカスタマイズします。

詳細は システムディレクトリ を参照してください。

--system-dir <path>

システムディレクトリを指定します。

lightfile-batch /path/to/images --system-dir /custom/system

デフォルト: ~/.lightfile-next/batch

--project-dir <path>

プロジェクトディレクトリを指定します。

lightfile-batch /path/to/images --project-dir /custom/project

デフォルト: <システムディレクトリ>/<プロジェクトコード>

--file-memory-dir <path>

ファイルメモリディレクトリ（KVS保存先）を指定します。

lightfile-batch /path/to/images --file-memory-dir /custom/memory

デフォルト: <プロジェクトディレクトリ>/memory

--session-retention-days <days>

セッションディレクトリの保持日数を指定します。

# 7日間保持
lightfile-batch /path/to/images --session-retention-days 7

# 自動削除を無効化
lightfile-batch /path/to/images --session-retention-days 0

デフォルト: 28日間

--session-dir <path>

セッションディレクトリを明示的に指定します。

lightfile-batch /path/to/images --session-dir /custom/session

デフォルト: <プロジェクトディレクトリ>/sessions/<セッションID>

--backup-dir <path>

バックアップディレクトリを指定します。

lightfile-batch /path/to/images --backup-dir /custom/backup

デフォルト: <プロジェクトディレクトリ>/backup

インデックスファイルオプション

インデックスファイルから処理対象ファイルを読み込みます。

詳細は インデックスファイル を参照してください。

--index-file <path>

ローカルインデックスファイルのパスを指定します。

lightfile-batch /path/to/images --index-file /path/to/index.tsv

フォーマット: TSV（タブ区切り）

file1.jpg	102400	1609459200
file2.png	204800	1609459300

--index-remote-file <path>

リモートインデックスファイルの相対パスを指定します（リモートFS専用）。

# S3バケット内のindex.tsvを使用
lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-acl private \
  --index-remote-file index.tsv

バックアップオプション（ローカル）

詳細は バックアップ機能 を参照してください。

--backup-mode <mode>

バックアップモードを指定します。

# strict: バックアップ必須、失敗したら処理中止（デフォルト）
lightfile-batch /path/to/images --backup-mode strict

# loose: バックアップ失敗しても処理続行
lightfile-batch /path/to/images --backup-mode loose

# none: バックアップしない
lightfile-batch /path/to/images --backup-mode none

バックアップモード:

  • strict: バックアップ必須。失敗したら処理を中止（デフォルト）
  • loose: バックアップを試みるが、失敗しても処理を続行
  • none: バックアップしない

--no-backup

バックアップを無効化します（--backup-mode none のエイリアス）。

lightfile-batch /path/to/images --no-backup

--backup-fs <filesystem>

バックアップ先のファイルシステムを指定します。

# ローカルディレクトリにバックアップ（デフォルト）
lightfile-batch /path/to/images --backup-fs local

# S3バケットにバックアップ
lightfile-batch /path/to/images --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2

選択肢: local, s3

ディスク容量管理オプション

--backup-free-space-threshold <size>

ディスクの空き容量しきい値を指定します。

lightfile-batch /path/to/images --backup-free-space-threshold 10gb

デフォルト: 10gb

空き容量がこの値を下回ると、古いバックアップを自動削除します。

--backup-target-free-space <size>

ディスクの目標空き容量を指定します。

lightfile-batch /path/to/images --backup-target-free-space 15gb

デフォルト: 15gb

自動削除時に確保する空き容量の目標値です。

--backup-max-total-size <size>

バックアップの最大サイズを指定します。

lightfile-batch /path/to/images --backup-max-total-size 50gb

デフォルト: 無制限

バックアップの合計サイズがこの値を超えると、古いバックアップを自動削除します。

--backup-target-total-size <size>

バックアップの目標サイズを指定します。

lightfile-batch /path/to/images --backup-target-total-size 40gb

デフォルト: 未設定

自動削除時に目標とするバックアップの合計サイズです。

--backup-check-interval <size>

バックアップ容量チェックの間隔を指定します。

lightfile-batch /path/to/images --backup-check-interval 1gb

デフォルト: 1gb

この容量だけバックアップが増えるごとに、ディスク容量をチェックします。

バックアップオプション（S3）

S3バケットにバックアップする場合のオプションです（--backup-fs s3 指定時）。

--backup-s3-endpoint <url>

S3互換エンドポイントを指定します。

# MinIOの例
lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-endpoint https://s3.example.com \
  --backup-s3-bucket my-backup-bucket

Amazon S3の場合は不要です。

--backup-s3-bucket <name>

バックアップ先のS3バケット名を指定します（必須）。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2

--backup-s3-region <region>

バックアップ先のS3リージョンを指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region ap-northeast-1

デフォルト: us-east-1

--backup-s3-prefix <prefix>

S3バケット内のプレフィックス（パス）を指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2 \
  --backup-s3-prefix backups/production/

--backup-s3-access-key <key>

バックアップ先のS3アクセスキーを指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2 \
  --backup-s3-access-key AKIAIOSFODNN7EXAMPLE \
  --backup-s3-secret-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

環境変数やAWS設定ファイルでも指定可能です。

--backup-s3-secret-key <key>

バックアップ先のS3シークレットキーを指定します。

--backup-s3-acl <acl>

バックアップファイルのACL（アクセス制御）を指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2 \
  --backup-s3-acl private

デフォルト: private

選択肢: private, public-read, public-read-write, authenticated-read, _keep

  • private: プライベート（所有者のみアクセス可能）
  • public-read: パブリック読み取り可能
  • public-read-write: パブリック読み書き可能
  • authenticated-read: 認証されたユーザーのみ読み取り可能
  • _keep: 既存のACLを変更しない

--backup-s3-max-total-size <size>

S3バックアップの最大サイズを指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2 \
  --backup-s3-max-total-size 100gb

デフォルト: 無制限

--backup-s3-target-total-size <size>

S3バックアップの目標サイズを指定します。

lightfile-batch /path/to/images \
  --backup-fs s3 \
  --backup-s3-bucket my-backup-bucket \
  --backup-s3-region us-west-2 \
  --backup-s3-target-total-size 80gb

デフォルト: 未設定

最適化オプション

--quality <level>

全体の最適化品質を指定します。

# 低品質（最大圧縮）
lightfile-batch /path/to/images --quality low

# 中品質（バランス型、デフォルト）
lightfile-batch /path/to/images --quality medium

# 高品質（画質優先）
lightfile-batch /path/to/images --quality high

選択肢: low, medium, high デフォルト: medium

--jpeg-quality <level>

JPEG画像の品質を個別に指定します。

lightfile-batch /path/to/images --jpeg-quality low

選択肢: low, medium, high

--quality より優先されます。

--png-quality <level>

PNG画像の品質を個別に指定します。

lightfile-batch /path/to/images --png-quality high

選択肢: low, medium, high

--quality より優先されます。

フィルタオプション

--after <date|duration>

指定した日時より新しいファイルのみを処理します。

# 7日以内に更新されたファイル
lightfile-batch /path/to/images --after 7d

# 特定の日時以降
lightfile-batch /path/to/images --after "2024-01-01 00:00:00"

時間単位: d (日), h (時間), m (分)

--before <date|duration>

指定した日時より古いファイルのみを処理します。

# 30日以前に更新されたファイル
lightfile-batch /path/to/images --before 30d

# 特定の日時以前
lightfile-batch /path/to/images --before "2024-12-31 23:59:59"

時間単位: d (日), h (時間), m (分)

--min-size <size>

最小ファイルサイズを指定します。

# 100KB以上のファイルのみ
lightfile-batch /path/to/images --min-size 100kb

# 2MBバイト以上のファイルのみ
lightfile-batch /path/to/images --min-size 2mb

サイズ単位: b, kb, mb, gb （大文字小文字問わず）

--max-size <size>

最大ファイルサイズを指定します。

# 5MB以下のファイルのみ
lightfile-batch /path/to/images --max-size 5mb

# 1GB以下のファイルのみ
lightfile-batch /path/to/images --max-size 1gb

サイズ単位: b, kb, mb, gb （大文字小文字問わず）

--ext <extensions>

処理対象の拡張子をカンマ区切りで指定します。

# JPEGファイルのみ
lightfile-batch /path/to/images --ext .jpg,.jpeg

# PNGファイルのみ
lightfile-batch /path/to/images --ext .png

デフォルト: .jpg,.jpeg,.png,.jfif

--include <pattern>

対象パターンを glob 形式で指定します（複数回指定可能）。

# uploadsディレクトリ内のJPEGのみ
lightfile-batch /path/to/images --include "uploads/**/*.jpg"

# 複数パターン
lightfile-batch /path/to/images \
  --include "uploads/**/*.jpg" \
  --include "photos/**/*.png"

glob パターン例:

  • **/*.jpg - すべてのサブディレクトリのJPEGファイル
  • 2024/**/* - 2024ディレクトリ以下のすべてのファイル
  • **/thumb_* - thumb_で始まるファイル

--exclude <pattern>

除外パターンを glob 形式で指定します（複数回指定可能）。

# thumbnailsディレクトリを除外
lightfile-batch /path/to/images --exclude "**/thumbnails/**"

# 複数パターン
lightfile-batch /path/to/images \
  --exclude "**/thumbnails/**" \
  --exclude "**/temp/**"

--limit <count>

処理するファイル数の上限を指定します。

# 最大100ファイルまで処理
lightfile-batch /path/to/images --limit 100

デフォルト: 0（無制限）

--concurrency <number>, -j <number>

並列処理数を指定します。

# 4ファイルを並列処理
lightfile-batch /path/to/images --concurrency 4
lightfile-batch /path/to/images -j 4

デフォルト: 1（順次処理） 推奨値: CPU数以下（例: 4コアCPUなら -j 4）

通知オプション（SMTP Email）

バッチ処理を続行不可能なエラー(Fatal Error)発生時にSMTP経由でメール通知します。

詳細は 通知機能 を参照してください。

--notify-smtp-to <email>

通知メールの宛先を指定します。

lightfile-batch /path/to/images \
  --notify-smtp-to admin@example.com \
  --notify-smtp-from lightfile@example.com \
  --notify-smtp-host smtp.example.com

--notify-smtp-from <email>

通知メールの送信元を指定します。

--notify-smtp-host <host>

SMTPサーバーのホスト名を指定します。

--notify-smtp-port <port>

SMTPサーバーのポート番号を指定します。

lightfile-batch /path/to/images \
  --notify-smtp-host smtp.example.com \
  --notify-smtp-port 587

デフォルト: 587

--notify-smtp-user <username>

SMTP認証のユーザー名を指定します。

lightfile-batch /path/to/images \
  --notify-smtp-host smtp.example.com \
  --notify-smtp-user smtp_user \
  --notify-smtp-password smtp_password

--notify-smtp-password <password>

SMTP認証のパスワードを指定します。

--notify-smtp-use-tls

TLS接続を使用します。

lightfile-batch /path/to/images \
  --notify-smtp-host smtp.example.com \
  --notify-smtp-use-tls

デフォルト: true（TLS使用）

明示的に無効化する場合: --notify-smtp-use-tls=false

--notify-smtp-ignore-tls-errors

TLSエラーを無視します（開発・テスト用）。

lightfile-batch /path/to/images \
  --notify-smtp-host smtp.example.com \
  --notify-smtp-ignore-tls-errors

注意: 本番環境では使用しないでください。

通知オプション（簡易Email）

バッチ処理を続行不可能なエラー(Fatal Error)発生時に弊社のメールサーバー経由でメール通知します。

特徴:

  • 簡単な設定で利用可能（SMTPサーバーの設定不要）
  • 弊社のメールサーバーを利用
  • 月1000件までの送信上限あり

--notify-email-to <email>

通知メールの宛先を指定します（カンマ区切りで複数指定可能）。

lightfile-batch /path/to/images \
  --notify-email-to admin@example.com,staff@example.com

--notify-email-cc <email>

通知メールのCCを指定します（カンマ区切りで複数指定可能）。

lightfile-batch /path/to/images \
  --notify-email-to admin@example.com \
  --notify-email-cc manager@example.com,team@example.com

通知オプション（Slack）

バッチ処理を続行不可能なエラー(Fatal Error)発生時にSlack Webhook経由で通知します。

--notify-slack-webhook-url <url>

Slack Webhook URLを指定します。

lightfile-batch /path/to/images \
  --notify-slack-webhook-url https://hooks.slack.com/services/YOUR/WEBHOOK/URL

--notify-slack-channel <channel>

通知先のSlackチャンネルを指定します（Webhook設定を上書き）。

lightfile-batch /path/to/images \
  --notify-slack-webhook-url https://hooks.slack.com/services/YOUR/WEBHOOK/URL \
  --notify-slack-channel #alerts

リモートファイルシステムオプション（FTP）

ftp サブコマンドで使用するオプションです。

詳細は リモートファイルシステム を参照してください。

必須オプション

--ftp-host <host>

FTPサーバーのホスト名を指定します（必須）。

lightfile-batch ftp --ftp-host ftp.example.com --ftp-user myuser

--ftp-user <username>

FTPユーザー名を指定します（必須）。

基本オプション

--ftp-password <password>

FTPパスワードを指定します。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-password mypassword

--ftp-port <port>

FTPポート番号を指定します。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-port 2121

デフォルト: 21

注意: 暗黙的TLS（--ftp-use-implicit-tls）を使用する場合は、一般的にポート990を使用します。その場合は --ftp-port 990 を明示的に指定してください

TLS/セキュリティオプション

--ftp-use-tls

明示的TLS（FTPS）を使用します。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-password mypassword \
  --ftp-use-tls

注意: AUTH TLS コマンドでTLS接続を開始します。

--ftp-use-implicit-tls

暗黙的TLS（FTPS）を使用します。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-password mypassword \
  --ftp-use-implicit-tls

注意: 接続開始時からTLS接続を使用します（ポート990）。

--ftp-ignore-tls-errors

TLS証明書エラーを無視します（開発・テスト用）。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-password mypassword \
  --ftp-use-tls \
  --ftp-ignore-tls-errors

警告: 本番環境では使用しないでください。

接続オプション

--ftp-short-timeout <seconds>

短いタイムアウト時間を秒単位で指定します。

適用される処理:

  • ファイルの日付やサイズの取得
  • ディレクトリの存在確認
  • その他の軽量な操作
lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-short-timeout 10

デフォルト: 30秒

--ftp-long-timeout <seconds>

長いタイムアウト時間を秒単位で指定します。

適用される処理:

  • ファイルのダウンロード
  • ファイルのアップロード
  • ファイルリストの取得
  • その他の長時間を要する可能性がある処理
lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-long-timeout 300

デフォルト: 300秒（5分）

パス指定

--ftp-base-path <path>

FTPサーバーのベースパスを指定します。

lightfile-batch ftp \
  --ftp-host ftp.example.com \
  --ftp-user myuser \
  --ftp-base-path /public_html

リモートファイルシステムオプション（SFTP）

sftp サブコマンドで使用するオプションです。

必須オプション

--sftp-host <host>

SFTPサーバーのホスト名を指定します（必須）。

lightfile-batch sftp --sftp-host sftp.example.com --sftp-user myuser

--sftp-user <username>

SFTPユーザー名を指定します（必須）。

認証オプション

--sftp-password <password>

SFTPパスワードを指定します（パスワード認証）。

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-password mypassword

--sftp-private-key <path>

SSH秘密鍵のパスを指定します（鍵認証）。

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-private-key ~/.ssh/id_rsa

--sftp-private-key-password <password>

SSH秘密鍵のパスフレーズを指定します。パスフレーズで保護された秘密鍵を使用する場合に必要です。

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-private-key ~/.ssh/id_rsa \
  --sftp-private-key-password mypassphrase

接続オプション

--sftp-port <port>

SFTPポート番号を指定します。

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-port 2222

デフォルト: 22

注意: SFTPのタイムアウト設定はコマンドラインオプションでは提供されていません。YAML設定ファイルで sftp.shortTimeout および sftp.longTimeout を使用してください。

パス指定

--sftp-base-path <path>

SFTPサーバーのベースパスを指定します。

lightfile-batch sftp \
  --sftp-host sftp.example.com \
  --sftp-user myuser \
  --sftp-base-path /home/myuser

リモートファイルシステムオプション（WebDAV）

webdav サブコマンドで使用するオプションです。

必須オプション

--webdav-url <url>

WebDAVサーバーのURLを指定します（必須）。

lightfile-batch webdav \
  --webdav-url https://webdav.example.com/remote.php/dav/files/user/ \
  --webdav-user myuser \
  --webdav-password mypassword

認証オプション

--webdav-user <username>

WebDAVユーザー名を指定します。

--webdav-password <password>

WebDAVパスワードを指定します。

リモートファイルシステムオプション（S3）

s3 サブコマンドで使用するオプションです。

必須オプション

--s3-bucket <name>

S3バケット名を指定します（必須）。

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region us-west-2 \
  --s3-acl private

--s3-acl <acl>

アップロード時のACL（アクセス制御）を指定します（必須）。

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region us-west-2 \
  --s3-acl public-read

選択肢: private, public-read, public-read-write, authenticated-read, _keep

  • private: プライベート（所有者のみアクセス可能）
  • public-read: パブリック読み取り可能
  • public-read-write: パブリック読み書き可能
  • authenticated-read: 認証されたユーザーのみ読み取り可能
  • _keep: 既存のACLを変更しない

基本オプション

--s3-region <region>

S3リージョンを指定します。

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region ap-northeast-1 \
  --s3-acl private

デフォルト: us-east-1

--s3-endpoint <url>

S3互換エンドポイントを指定します。

# MinIOの例
lightfile-batch s3 \
  --s3-endpoint https://s3.example.com \
  --s3-bucket my-bucket \
  --s3-region us-east-1 \
  --s3-acl private

Amazon S3の場合は不要です。

認証オプション

--s3-access-key <key>

S3アクセスキーを指定します。

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region us-west-2 \
  --s3-acl private \
  --s3-access-key AKIAIOSFODNN7EXAMPLE \
  --s3-secret-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

環境変数 AWS_ACCESS_KEY_ID やAWS設定ファイルでも指定可能です。

--s3-secret-key <key>

S3シークレットキーを指定します。

環境変数 AWS_SECRET_ACCESS_KEY でも指定可能です。

高度なオプション

--s3-prefix <prefix>

S3バケット内のプレフィックス（パス）を指定します。

lightfile-batch s3 \
  --s3-bucket my-bucket \
  --s3-region us-west-2 \
  --s3-acl private \
  --s3-prefix images/uploads/

--s3-force-path-style

パススタイルのエンドポイントを使用します。

# MinIOなどのS3互換ストレージで使用
lightfile-batch s3 \
  --s3-endpoint https://s3.example.com \
  --s3-bucket my-bucket \
  --s3-region us-east-1 \
  --s3-acl private \
  --s3-force-path-style

用途: MinIOなどのS3互換ストレージで、バケット名をパスに含める形式（https://s3.example.com/bucket/key）を使用します。

--s3-disable-ssl

SSL/TLS接続を無効化します（開発・テスト用）。

lightfile-batch s3 \
  --s3-endpoint http://localhost:9000 \
  --s3-bucket my-bucket \
  --s3-region us-east-1 \
  --s3-acl private \
  --s3-disable-ssl

警告: 本番環境では使用しないでください。

関連ページ

  • 環境変数 - 利用可能な環境変数の詳細とデフォルト値、設定の優先順位
  • YAML設定ファイル - すべての設定をまとめて管理する方法

使用状況レポート機能

統計情報とエラー情報の自動レポート

環境変数

利用可能な環境変数のリファレンス

目次

コマンド構文サブコマンド一覧基本オプション--config, -c <path>--license-token, -l <token>--dry-run, -n--quiet, -q--verbose, -v--non-exclusive--log-level <level>--log-progress-interval <interval>--help, -h--versionシステムディレクトリオプション--system-dir <path>--project-dir <path>--file-memory-dir <path>--session-retention-days <days>--session-dir <path>--backup-dir <path>インデックスファイルオプション--index-file <path>--index-remote-file <path>バックアップオプション（ローカル）--backup-mode <mode>--no-backup--backup-fs <filesystem>ディスク容量管理オプション--backup-free-space-threshold <size>--backup-target-free-space <size>--backup-max-total-size <size>--backup-target-total-size <size>--backup-check-interval <size>バックアップオプション（S3）--backup-s3-endpoint <url>--backup-s3-bucket <name>--backup-s3-region <region>--backup-s3-prefix <prefix>--backup-s3-access-key <key>--backup-s3-secret-key <key>--backup-s3-acl <acl>--backup-s3-max-total-size <size>--backup-s3-target-total-size <size>最適化オプション--quality <level>--jpeg-quality <level>--png-quality <level>フィルタオプション--after <date|duration>--before <date|duration>--min-size <size>--max-size <size>--ext <extensions>--include <pattern>--exclude <pattern>--limit <count>--concurrency <number>, -j <number>通知オプション（SMTP Email）--notify-smtp-to <email>--notify-smtp-from <email>--notify-smtp-host <host>--notify-smtp-port <port>--notify-smtp-user <username>--notify-smtp-password <password>--notify-smtp-use-tls--notify-smtp-ignore-tls-errors通知オプション（簡易Email）--notify-email-to <email>--notify-email-cc <email>通知オプション（Slack）--notify-slack-webhook-url <url>--notify-slack-channel <channel>リモートファイルシステムオプション（FTP）必須オプション--ftp-host <host>--ftp-user <username>基本オプション--ftp-password <password>--ftp-port <port>TLS/セキュリティオプション--ftp-use-tls--ftp-use-implicit-tls--ftp-ignore-tls-errors接続オプション--ftp-short-timeout <seconds>--ftp-long-timeout <seconds>パス指定--ftp-base-path <path>リモートファイルシステムオプション（SFTP）必須オプション--sftp-host <host>--sftp-user <username>認証オプション--sftp-password <password>--sftp-private-key <path>--sftp-private-key-password <password>接続オプション--sftp-port <port>パス指定--sftp-base-path <path>リモートファイルシステムオプション（WebDAV）必須オプション--webdav-url <url>認証オプション--webdav-user <username>--webdav-password <password>リモートファイルシステムオプション（S3）必須オプション--s3-bucket <name>--s3-acl <acl>基本オプション--s3-region <region>--s3-endpoint <url>認証オプション--s3-access-key <key>--s3-secret-key <key>高度なオプション--s3-prefix <prefix>--s3-force-path-style--s3-disable-ssl関連ページ