メール移行ツールimapsyncのオプションガイド

ChatGPTにimapsyncのオプションを翻訳してもらっただけのやつです。

1. 認証・接続オプション

オプション 説明
--host1 移行元IMAPサーバのホスト名またはIPアドレス
--port1 host1のIMAPポート番号(デフォルト143/993)
--user1 host1のユーザー名
--password1 host1のパスワード
--host2 移行先IMAPサーバのホスト名またはIPアドレス
--port2 host2のIMAPポート番号(デフォルト143/993)
--user2 host2のユーザー名
--password2 host2のパスワード
--nossl1 / --nossl2 SSL接続を無効化(プレーンIMAP
--ssl1 / --ssl2 SSL接続を強制使用
--tls1 / --tls2 STARTTLSによる暗号化接続を使用
--showpasswords パスワードをマスクせずに出力(危険)
--passfile1 / --passfile2 パスワードを記述したファイルのパス
--authuser1 / --authuser2 管理者としてログインするユーザー名(プロキシ認証用)
--proxyauth1 / --proxyauth2 プロキシ認証を有効にする(authuserと併用)

2. 同期挙動制御オプション

オプション 説明
--syncinternaldates メールの内部受信日時を保持(デフォルトON)
--idatefromheader ヘッダーの"Date"を内部日時として使用
--useuid UIDを使ってメッセージを特定(高速化)
--useheader <ヘッダー名> 指定したヘッダーを基準に比較(Message-ID等)
--dry 実際の操作はせずに処理内容のみ出力(ドライラン)
--justlogin ログインの確認のみ実施
--justconnect 接続確認のみ(ログインなし)
--justfolders フォルダの同期確認のみ(メッセージ対象外)

3. 削除・差分同期制御

オプション 説明
--delete1 host1のメッセージを転送後に削除
--delete2 host2にだけ存在するメッセージを削除
--delete2folders host2にだけ存在するフォルダを削除
--delete1emptyfolders 空のフォルダをhost1から削除
--delete2duplicates host2内の重複メッセージを削除(--useuid 不要)
--expunge1 / --expunge2 \Deletedのついたメッセージを完全削除(EXPUNGE)
--uidexpunge2 UIDベースで削除

4. フォルダ関連オプション

オプション 説明
--folder <名前> 特定のフォルダを同期対象に追加(複数可)
--folderrec <名前> 指定フォルダとそのサブフォルダを再帰的に同期
--exclude <正規表現> 同期対象外とするフォルダ名のパターン指定
--include <正規表現> 同期対象とするフォルダ名のパターン指定(--excludeより先に評価)
--automap 一般的なフォルダ名(Sent, Junk等)を自動マッピング
--f1f2 <F1=F2> フォルダF1をF2にマッピングして同期
--subfolder1 / --subfolder2 フォルダ階層を指定して部分同期・復元対応

5. メッセージ選択オプション

オプション 説明
--maxsize / --minsize 指定サイズより大きい/小さいメッセージを除外
--maxage / --minage 指定日数より古い/新しいメッセージを除外
--search / --search1 / --search2 IMAP SEARCH コマンドでメッセージをフィルタリング

6. パフォーマンスと制限

オプション 説明
--maxmessagespersecond メッセージの転送速度制限(数/秒)
--maxbytespersecond 転送バイト数制限(バイト/秒)
--buffersize バッファサイズの指定(デフォルト4096バイト)

7. ログ・デバッグ

オプション 説明
--log / --nolog ログ出力の有効・無効切り替え
--logfile <パス> 出力するログファイルのパス指定
--debug 全体的なデバッグ出力
--debugimap / --debugimap1 / --debugimap2 IMAP通信ログ詳細出力
--debugfolders / --debugflags / --debugcontent フォルダ・フラグ・内容それぞれの詳細ログ

8. Gmail / Exchange 連携用

オプション 説明
--gmail1 / --gmail2 Gmail仕様に特化したオプション群を自動設定
--office1 / --office2 Office365対応設定を自動化
--exchange1 / --exchange2 Exchangeサーバ向け設定
--oauthaccesstoken1 / 2 OAuth2 トークンを使った認証(Gmailなど)

9. その他

オプション 説明
--tmpdir <パス> 一時ファイル保存ディレクト
--pidfile <パス> PIDファイルの指定(多重起動防止)
--help オプション一覧を表示
--version バージョン情報を表示
--abort PIDファイルから既存プロセスを終了

このドキュメントは、imapsync バージョン 2.303(2025年2月現在)に基づいて作成しています。