IntelliJ IDEA 2026.1 Help

アップロードとダウンロードをカスタマイズする

さまざまなプロジェクト(サーバーのセットアップ)でのアップロードとダウンロードを確実に成功させるための必須設定の他に、サーバーとの対話をカスタマイズするための追加オプションを構成できます。 これらのオプションのほとんどは、すべての サーバーアクセス構成タイプに適用されます。 FTP、FTPS、SFTP サーバー構成の場合、追加のプロトコル固有のオプションを指定できます。

FTP/SFTP/WebDAV 接続プラグインを有効化する

この機能は、デフォルトで IntelliJ IDEA にバンドルされて有効になっている FTP/SFTP/WebDAV 接続(英語)プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. インストール済みタブを開き、 FTP/SFTP/WebDAV Connectivity プラグインを見つけて、プラグイン名の横にある チェックボックスを選択します。

一般的なアップロードとダウンロードのオプションを設定する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ | オプション を選択します。

    または、メインメニューの ツール | デプロイ | オプション ... に移動します。

  2. 追加設定を指定します。

    • アップロードおよびダウンロード中に特定のファイルまたはフォルダー全体をスキップするには、 項目を名前で除外(E) フィールドで、これらのファイルとフォルダーの名前を定義するパターンを指定します。

      セミコロン ; を区切り文字として使用し、アスタリスク * をゼロ以上の文字に一致させ、疑問符 ? を単一の文字に一致させます。

      例: 3 つのファイル style.css style1.css style2.scss を持つフォルダー stylesheets がある場合、 style* はフォルダー全体を除外し、 style?.css style1.css を除外し、 style?.* style1.css style2.scss を除外します。

      正規表現 .info(英語) の詳細を参照してください。

      除外は再帰的に適用されます。 つまり、一致するフォルダーにサブフォルダーがある場合、これらのサブフォルダーの内容はデプロイされません。

      詳細については、 アップロードとダウンロードからファイルとフォルダーを除外する を参照してください。

    • アップロードおよびダウンロード手順の詳細を指定するには、対応するチェックボックスをオンまたはオフにします。

追加のプロトコル固有のカスタマイズオプションを指定する

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デプロイ を選択します。

    または、メインメニューの ツール | デプロイ | 構成 に移動します。

  2. 構成済みのサーバーを選択し、 接続 タブの 詳細グループをデプロイして、プロトコルに応じた追加のアップロード設定を指定します。

    • 接続数(E) フィールドで、同時にサポートされる接続の最大数を指定します。

    • キープアライブメッセージ送信間隔(K) フィールドで、IntelliJ IDEA がサーバーにコマンドを送信してタイムアウトをリセットして接続を維持する頻度を指定します。

    • クライアントサーバー通信のエンコーディング(E) フィールドに、サーバーで使用されているエンコーディングと一致するエンコーディングを指定します。 UTF-8 エンコーディングがサポートされているかどうかわからない場合は、デフォルト値をそのまま使用してください。

    • クライアントを パッシブモード(英語)に設定するには、 パッシブモード(P) チェックボックスを選択します。 このモードでは、マシンのクライアントがサーバーに接続してパッシブモードであることを通知し、リッスンするポート番号を受信し、受信した番号のポートを介してデータ接続を確立します。 このモードは、マシンがファイアウォールの背後にある場合に役立ちます。

    • サーバーブラウザーツールウィンドウに非表示のファイルとディレクトリ(ドット で始まる名前)を表示するには、 隠しファイルを表示して処理する(S) を選択します。

    • LIST コマンドの使用 領域で 旧バージョンの子のリスト表示との互換性を確保する(C) を選択して、FTP サーバーとの 子ファイルの命名の互換性(英語)を確保します。

      このオプションは、リモート FTP サーバーが次のエラーを報告する場合に役立ちます。

      Invalid descendant file name <file name>

      このオプションを選択すると、サーバーとの同期が遅くなる可能性があります。

    • MLSD コマンドの代わりに一覧表示するための標準 LIST コマンドを使用する LIST コマンドの使用 エリアで MLSD の代わりに使用する を選択します。 これによって問題を回避することができます。例えば、FTP サーバーが MLSD をサポートし、 cdir を返す場合、 下位ファイル名が無効の例外でアップロード中に失敗するケースです。

    • 接続数(E) フィールドで、同時にサポートされる接続の最大数を指定します。

    • キープアライブメッセージ送信間隔(K) フィールドで、IntelliJ IDEA がサーバーにコマンドを送信してタイムアウトをリセットして接続を維持する頻度を指定します。

    • キープアライブコマンド(A) リストから、サーバーに送信するコマンドを選択してタイムアウトをリセットし、接続を維持します。

    • TLS: Transfer Layer Security の方法。 プレーン(非セキュア)モードと同じポートを使用するには 明示(X) を選択し、専用ポートを使用するには 暗黙的(I) を選択します。

    • データチャネルの保護レベル(D): 非セキュア接続の場合は クリア を選択し、セキュア接続の場合は プライベート を選択します。

    • SSL セッションの再利用: SSL 接続中に確立された、キーとアルゴリズムの合意情報を含むセキュリティ契約の再利用を選択します。

    • TLS 1.3 を無効にする: TLS 1.3 機能を無効にし、IntelliJ IDEA を TLS1.2 経由の接続にフォールバックさせる場合に選択します。 サーバーへの接続の確立または特定のファイルのアップロードで問題が発生した場合は、このオプションを使用してください。

    • クライアントを パッシブモード(英語)に設定するには、 パッシブモード(P) チェックボックスを選択します。 このモードでは、マシンのクライアントがサーバーに接続してパッシブモードであることを通知し、リッスンするポート番号を受信し、受信した番号のポートを介してデータ接続を確立します。 このモードは、マシンがファイアウォールの背後にある場合に役立ちます。

    • サーバーブラウザーツールウィンドウに非表示のファイルとディレクトリ(ドット で始まる名前)を表示するには、 隠しファイルを表示して処理する(S) を選択します。

    • LIST コマンドを使用する 領域で 旧バージョンの子のリスト表示との互換性を確保する(C) を選択して、FTP サーバーとの 子ファイルの命名の互換性(英語)を確保します。

      このオプションは、リモート FTP サーバーが次のエラーを報告する場合に役立ちます。

      Invalid descendant file name <file name>

      このオプションを選択すると、サーバーとの同期が遅くなる可能性があります。

    • MLSD コマンドの代わりに一覧表示するための標準 LIST コマンドを使用する LIST コマンドの使用 エリアで MLSD の代わりに使用する を選択します。 これによって問題を回避することができます。例えば、FTP サーバーが MLSD をサポートし、 cdir を返す場合、 下位ファイル名が無効の例外でアップロード中に失敗するケースです。

2026 年 3 月 30 日