WebStorm 2026.1 Help

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

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

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

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

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

  2. 追加設定を指定してください:

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

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

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

      ワイルドカードで除外: デプロイから除外されたフォルダースタイルシート全体
      ワイルドカードで除外: 疑問符
      ワイルドカードで除外: 疑問符とアスタリスク

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      Invalid descendant file name <file name>

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

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

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

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

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

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

    • データチャンネルの保護レベル: 非セキュア接続の場合は クリア を選択し、セキュア接続の場合は 非公開 を選択します。

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

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

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

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

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

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

      Invalid descendant file name <file name>

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

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

2026 年 6 月 8 日