PyCharm 2025.3 ヘルプ

SSH を使用してインタープリターを構成する

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

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

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

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

SSH 経由でリモート Python インタープリターを構成する

  1. PyCharm は ssh-sessions を介してリモートインタープリターを実行するため、リモートホストで SSH サーバーが実行されていることを確認してください。

  2. 以下のいずれか 1 つを実行します:

    • Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。

    • Ctrl+Alt+S を押して設定を開き、Python | インタープリターに移動します。

    • Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

  3. 利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックし、SSH の場合を選択します。

  4. オプションを選択して新しい SSH 接続を作成し、サーバー情報 (ホスト、ポート、ユーザー名) を指定します。

    adding an interpreter via SSH

    または、既存を選択して、リストから使用可能な SSH 構成を選択することもできます。新しい SSH 構成を作成するには、次の手順に従います。

    SSH 構成の作成
    • 構成のリストの横にある Browse button をクリックします。

      Add new SSH configuration
    • new configuration をクリックし、このプロジェクトでのみ表示するチェックボックスを無効にして、必要なフィールドに入力します。

      Adding new SSH configuration
    • 完了すると、新しく作成された SSH 構成が使用可能な構成のリストに表示されます。SSH デプロイ構成設定でも使用できるようになります。次へをクリックして続行します。

      Connecting to SSH server
  5. 次のダイアログウィンドウで、ターゲットサーバーに接続するための認証の詳細を入力します。

    specifying authentication details

    パスワードまたはキーペア (OpenSSH または PuTTY) を選択し、パスワードまたはパスフレーズを入力します。キーペア (OpenSSH または PuTTY) を選択した場合は、以下を指定します。

    続行するには次へをクリックします。

  6. PyCharm が SSH サーバーのイントロスペクションを完了するまで待ちます。

    SSH server introspection
  7. 次のダイアログで、SSH サーバーで構成する Python 環境のタイプを選択します。

    Selecting a Python environment

    新しい仮想環境またはコンダ環境を作成したり、既存の環境を選択したり、システムインタープリターを使用したりできます。

    • マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、ベースインタープリターからパッケージを継承するチェックボックスを選択します。このチェックボックスは、virtualenv(英語) ツールの --system-site-packages オプションに対応しています。

    • SSH サーバー上で Python コードを sudo ユーザーとして実行する必要がある場合は、sudo 経由で root 権限でコードを実行するチェックボックスを有効にします。

    • ローカルプロジェクトとサーバー間のパスマッピングを構成できます。これを行うには、フォルダーの同期フィールドの参照アイコンをクリックし、ローカルプロジェクトフォルダーへのパスとリモートサーバー上のフォルダーへのパスを入力します。

    作成をクリックして、インタープリターの追加を完了します。

SSH インタープリターの切り替え時のプロジェクトファイルの同期

プロジェクトインタープリターを変更して SSH インタープリターを選択する場合、ローカルコンテンツをターゲットサーバーと同期することが必要になる場合があります。右下隅の通知バルーンに注目してください。

Sync local files with the deployment server

サーバーへのファイルの自動アップロードを有効にすることを選択できます。

  • ファイルの自動アップロードをクリックすると、次回の保存時にアップロードが開始されます。

  • ファイルの同期と自動アップロードをクリックすると、ファイルがすぐに同期され、今後保存するたびにアップロードされます。

追加設定を構成するには、メインメニューからツール | デプロイ | オプションを選択します。

あるいは、設定 | ビルド、実行、デプロイ | デプロイ | オプションに進みます。

2025 年 8 月 01 日

関連ページ:

Python インタープリターを構成する

PyCharm の Python インタープリター:Python コードを PyCharm で動作させるには、少なくとも 1 つの Python インタープリターを設定する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。また、Virtualenv、pipenv、Poetry、uv、hatch、または conda の仮想環境を作成することもできます。仮想環境は、ベースインタープリターとインストールされたパッケージで構成されます。PyCharm Pro で...

リモートサーバー構成を作成する

リモートサーバー構成では、サーバーは別のコンピューター (リモートホスト) 上で実行されます。リモートサーバー上のファイルにアクセスするには、FTP/SFTP/FTPS/WebDAV プロトコルを使用します。PyCharm でリモートサーバー構成を作成するには、次の手順を実行する必要があります。リモートホストで認証し、接続を設定するは、そこにインストールされている Web サーバーと PyCharm の間にあります。PyCharm プロジェクトとホスト上のプロジェクトフォルダー間のマッピングを構...

仮想環境を構成する

PyCharm では、virtualenv ツールを使用してプロジェクト固有の分離された仮想環境を作成できます。仮想環境の主な目的は、他の Python プロジェクトに関係なく、特定のプロジェクトの設定と依存関係を管理することです。virtualenv ツールは PyCharm にバンドルされているため、ユーザーがインストールする必要はありません。virtualenv 環境を作成する以下のいずれか 1 つを実行します:Python インタープリターセレクターをクリックして、新しいインタープリターを...

conda 仮想環境を構成する

PyCharm は、Conda を使用した Python の仮想環境の作成をサポートしています。次の手順は、サポートされているすべてのオペレーティングシステムに適用されます。このページの上部にあるプラットフォームスイッチャーを使用して、オペレーティングシステムに固有のショートカットを表示します。conda 環境を作成する Anaconda または Miniconda がコンピューターにダウンロードされインストールされていること、およびその実行可能ファイルへのパスを認識していることを確認します。詳細について...

チュートリアル: PyCharm でデプロイ

このチュートリアルでは、PyCharm を使用してコードのデプロイをリモートホストに構成および管理する手順を段階的に説明します。FTP/SFTP/WebDAV 接続プラグインを有効にするこの機能は、デフォルトで PyCharm にバンドルされて有効になっている FTP/SFTP/WebDAV 接続プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、FTP/SFTP/WebD...

WSL を使用してインタープリターを構成する

準備ステップを実行する Python をコンピューターにダウンロードしてインストールしたことを確認してください。Microsoft ストアから Windows に Python をインストールする Windows をお使いの場合は、Microsoft ストアから Python をダウンロードし、Python インタープリターとしてインストールできます。Microsoft ストアから Python アプリケーションをダウンロードすると、Python 実行ファイルのリストに追加されます。Microsoft...