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バイト) |
| オプション |
説明 |
| --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月現在)に基づいて作成しています。