PyCharm 2026.1 Help

デプロイ: 接続タブ

このタブを使用して、 Web サーバーにアクセスする方法を選択し、接続設定を指定します。 コントロールのセットは、選択したサーバーアクセスタイプによって異なります。

すべてのサーバータイプに共通の設定

項目

説明

このプロジェクトでのみ表示

このチェックボックスを使用すると、このサーバーアクセス構成またはサーバーグループを他のプロジェクトで再利用できるようになります。

  • チェックボックスを選択して、構成またはサーバーグループの使用を現在のプロジェクトに制限します。 このような構成またはサーバーグループは、現在のプロジェクトの外では再利用できません。 他のプロジェクトで使用可能な構成の一覧には表示されません。

    サーバー構成設定はプロジェクトとともに .idea ディレクトリに保存されるため、 VCS を介してチームメンバー間で共有できます。

    左側のペインのサーバーアクセス構成のリストでは、現在のプロジェクトでのみ表示される構成には 現在のプロジェクトのみで表示されるアイコン アイコンが付いています。

  • チェックボックスをオフにすると、構成またはサーバーグループがすべての PyCharm プロジェクトで表示されます。 その設定は、複数のプロジェクトで再利用できます。

ランタイムの設定方法については、 Node.js via SSH を参照してください。

タイプ

このリストで、サーバーにアクセスする方法を選択します。 利用可能なオプションは次のとおりです：

  • FTP: このオプションを選択すると、PyCharm が FTP ファイル転送プロトコルを利用してサーバーにアクセスします。

  • SFTP: このオプションを選択すると、PyCharm が SFTPファイル転送プロトコルを利用してサーバーにアクセスします。

  • FTPS: このオプションを選択すると、PyCharm が SSL（FTPS拡張）を介した FTP ファイル転送プロトコルでサーバーにアクセスします。

  • WebDAV: このオプションを選択すると、PyCharm が WebDAV ファイル転送プロトコル（WebDAV拡張）でサーバーにアクセスします。

Web サーバーの URL

このフィールドには、サーバー構成ファイルで指定されているサーバードキュメントディレクトリに対応する URL アドレスを指定します。 フィールドの URL をブラウザーで開くアイコン をクリックして、指定されたサーバールート URL アドレスがアクセス可能であり、正しい Web ページを指していることを確認します。

HTTP と HTTPS の両方がサポートされています。

FTP と FTPS の設定

項目

説明

ホスト

このフィールドには、ファイルをアップロードするサーバーのホスト名を指定します。

ポート

このフィールドで、使用するポートを指定します。 デフォルト値は 21 です。

ルートパス

このフィールドでは、リモートファイルシステムを参照し、サーバーパスマッピングと除外パスを設定するためのリモートディレクトリルートとして使用するフォルダーを指定します。

次のいずれかを実行します：

  • デフォルトの / パスを受け入れると、それはサーバー上の ルート フォルダーを指します。

  • パスを手動で入力するか、 閲覧ボタン をクリックして、開いた ルートパスを選択 ダイアログで目的のフォルダーを選択します。

  • Autodetect をクリックしてください。 PyCharm は FTP/SFTP サーバー上のユーザーのホームフォルダー設定を検出し、それに応じてルートパスを設定します。 このボタンは、資格情報を指定した場合にのみ有効になります。

Autodetect

このボタンをクリックして、PyCharm がサーバー上のユーザーのホームフォルダー設定を検出し、それに応じて ルートパス を設定します。

ユーザー名

このフィールドに、サーバーへの認証用のユーザー名を入力します。

パスワード

このフィールドに、サーバーへの認証用のパスワードを入力します。

Login as anonymous

メールアドレスをパスワードとしてサーバーへの 匿名アクセス(英語)を有効にするには、このチェックボックスを選択します。

パスワードを保存

このチェックボックスを選択すると、PyCharm が指定したパスワードを記憶します。

接続のテスト

このボタンをクリックして、指定した設定で接続が成功することを確認します。 このボタンは、ユーザーの資格情報を指定した場合にのみ有効になります。

FTP と FTPS の詳細設定

拡張生 advanced 領域で、FTP / FTPS サーバー構成の追加プロトコル固有オプションを指定してアップロード / ダウンロードをカスタマイズします。

項目

説明

以下のために利用可能

TLS

クライアントセキュリティを呼び出す方法を選択します：

  • Explicit: 明示的（アクティブ）セキュリティ(英語)が適用されます。 接続を確立した直後に、マシンの FTP クライアントはサーバーにコマンドを送信して、デフォルトの FTP ポートを介して安全な制御接続を確立します。

  • 暗黙的: 暗黙の（パッシブ）セキュリティ(英語)が適用されます。 この場合、セキュリティは、安全な接続のために別のポートを指定するサーバーへの接続を確立すると自動的に提供されます。

    暗黙的メソッドは廃止予定とみなされ、使用することはお勧めしません。

FTPS

Data channel protection level

このリストから、PROT コマンドの保護レベルを設定します：

  • <デフォルト>: デフォルトのサーバーポリシーが適用されます。

  • クリア: 生データはセキュリティを適用せずに転送されます。

  • 非公開: 適用されたトランスポート層セキュリティ（TLS）または Secure Sockets Layer(SSL)。

詳細については、 TLS(英語)、 SSL 2.0(英語)、 SSL 3.0(英語) に関する記事を参照してください。

FTPS

Reuse SSL session

コントロールとデータ接続の間で SSL セッションの再利用が必要なサーバーに接続するには、このチェックボックスを選択します。

FTPS

Disable TLS 1.3

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

FTPS

Passive mode

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

FTP、FTPS

Show and process hidden files

このチェックボックスを選択すると：

  1. 隠しファイルとディレクトリは リモートホストツールウィンドウ に表示されます。

  2. 隠しファイルと隠しディレクトリは、 差分(英語)操作と 同期(英語)操作に関係しています。

隠しファイルまたは隠しディレクトリの名前はドット . で始まります。

FTP、FTPS

LIST コマンドを使用する

この領域のオプションを利用して、LIST コマンドの使用方法を構成します。

  • Compatible with old version of listing children: FTP サーバーとの 子ファイルの命名の互換性(英語)を確保するには、このチェックボックスを選択します。

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

    Invalid descendant file name <file name>

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

  • Instead of MLSD: MLSD コマンドの代わりに標準の LIST コマンドをリストに使用するには、このチェックボックスを選択します。 これにより、FTP サーバーが MLSD をサポートし cdir を返す場合、アップロード時に Invalid descendent file name例外が発生して失敗するなどの問題を回避できます。

FTP、FTPS

Number of connections

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

FTP、FTPS

Send keep-alive messages each

このフィールドでは、PyCharm がサーバーにコマンドを送信してタイムアウトをリセットし、接続を維持する頻度を指定します。

FTP、FTPS

Keep-alive command

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

FTP、FTPS

Encoding for client-server communication

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

FTP、FTPS

SFTP 設定

項目

説明

SSH 構成

このリストから、作成された SSH 構成の 1 つを選択するか、 参照ボタン をクリックして、 SSH 構成を作成する の説明に従って新しい構成を作成します。

接続のテスト

このボタンをクリックして、指定した設定で接続が成功することを確認します。 このボタンは、ユーザーの資格情報を指定した場合にのみ有効になります。

ルートパス

このフィールドでは、リモートファイルシステムを参照し、サーバーパスマッピングと除外パスを設定するためのリモートディレクトリルートとして使用するフォルダーを指定します。

次のいずれかを実行します：

  • デフォルトの / パスを受け入れると、それはサーバー上の ルート フォルダーを指します。

  • パスを手動で入力するか、 閲覧ボタン をクリックして、開いた ルートパスを選択 ダイアログで目的のフォルダーを選択します。

  • Autodetect をクリックしてください。 PyCharm は FTP/SFTP サーバー上のユーザーのホームフォルダー設定を検出し、それに応じてルートパスを設定します。 このボタンは、資格情報を指定した場合にのみ有効になります。

ダウンロード / アップロード / 同期に Rsync を使用する

Rsync(英語) を使用してデプロイ構成を同期するには、このチェックボックスを選択します。

Rsync Settings

このリンクをクリックして、開いたダイアログで Rsync 設定を構成します：

  • rsync および ssh 実行可能ファイルへのパスを指定します。

    • macOS および Linux では、 rsync および ssh ツールがプリインストールされており、それらのパスは自動的に入力されます。

    • Windows では、最初に Cygwin を rsync および openssh パッケージと一緒に手動でインストールする必要があります。 ツールの実行可能ファイルは通常、 <Cygwin installation>\bin フォルダーにあります。

  • 必要に応じて、 Rsync options フィールドの Rsync コマンドラインパラメーターをオーバーライドします。

    デフォルトでは、 -zar オプションが使用されるため、Rsync は転送されたデータを圧縮し（z ）、転送されたファイルとフォルダーのアクセス許可、所有権、タイムスタンプを保持し（a ）、サブディレクトリに再帰します（r）。

    使用可能なオプションの完全なリストについては、 Rsync のドキュメント(英語)を参照してください。

SFTP の詳細設定

拡張生 advanced 領域で、SFTP サーバー構成の追加プロトコル固有オプションを指定してアップロード / ダウンロードをカスタマイズします。

項目

説明

Number of connections

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

Send keep-alive messages each

このフィールドでは、PyCharm がサーバーにコマンドを送信してタイムアウトをリセットし、接続を維持する頻度を指定します。

Encoding for client-server communication

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

WebDAV 設定

項目

説明

ホスト

このフィールドには、ファイルをアップロードするサーバーのホスト名を指定します。

ポート

このフィールドで、使用するポートを指定します。 デフォルト値は 6180 です。

ユーザー名

このフィールドに、サーバーへの認証用のユーザー名を入力します。

パスワード

このフィールドに、サーバーへの認証用のパスワードを入力します。

Login as anonymous

サーバーへの匿名アクセスを有効にするには、このチェックボックスを選択します。

パスワードを保存

このチェックボックスを選択すると、PyCharm が指定したパスワードを記憶します。

接続のテスト

このボタンをクリックして、指定した設定で接続が成功することを確認します。

ローカルまたはマウントされたフォルダーの設定

項目

説明

フォルダー

このフィールドには、サーバー構成ファイルで定義されているサーバードキュメントルートへの絶対パスを指定します。 ドキュメントルート自体の他に、ドキュメントルートにある他の既存のフォルダーも指定できます。

ドキュメントルートは、Web サーバーが Web サーバー URL にファイルを提供するフォルダーです。

2026 年 6 月 1 日
デプロイデプロイ: マッピングタブ