PyCharm 2026.1 Help

SSH 経由の Node.js

始める前

  1. 設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript and TypeScript と入力します。 プラグインの詳細については、 Managing plugins を参照してください。

  2. Install the Node.js, Node.js リモートインタープリター, JavaScript Debugger, and FTP/SFTP/WebDAV 接続 plugins on the 設定 | プラグイン page, tab マーケットプレース, as described in JetBrains マーケットプレイスからプラグインをインストールします。 プラグインは PyCharm Pro でのみ利用できます。

  3. SSH サーバーへのアクセスをターゲットリモートホスト上で Create SSH configurations の説明に従って構成し、このサーバーが実行されていることを確認します。

  4. プロジェクトソースがターゲットリモートホスト上にあることを確認してください。 これは次の 2 つの方法で実行できます。

    • Upload and download files の説明に従って、プロジェクトソースをターゲットリモートホストにアップロードします。

    • ローカルマシンでネットワーク共有を有効にし、リモートホストのターゲットディレクトリにプロジェクトフォルダーをマウントします。

      ファイルとフォルダーを共有する方法は、使用しているオペレーティングシステムによって異なります。 詳細については、OS の説明書を参照してください。

SSH 経由でアクセス可能なリモートホスト上で Node.js ランタイムを構成する

SSH 経由の Node.js ランタイムは、 Configure Node.js Remote Runtime ダイアログで設定します。 このダイアログは、 設定 ダイアログの JavaScript ランタイムページから、またはそれ以降にアプリケーションの実行またはデバッグのために Node.js の実行 / デバッグ構成を作成または編集するを実行する際に開くことができます。

推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを設定することです。 この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。

Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。

  1. 設定 ダイアログ（Ctrl+Alt+S ）を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. ノードランタイム フィールドの横にある 参照ボタン をクリックします。

    ランタイムを追加 - 参照ボタン

  3. 現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーの 追加ボタン をクリックし、コンテキストメニューから リモートの追加 を選択します。

    SSH 経由で Node.js ランタイムを構成する: リモートの追加

  4. 開いた Node.js リモートランタイムを構成するダイアログで、 SSH を選択します。

  5. 使用する SSH 構成を選択します。

    SSH 経由でリモート Node.js ランタイムを構成する: SSH 構成を選択する

    または、 参照ボタン をクリックして、 Create SSH configurations の説明に従って新しい SSH 構成を作成します。

  6. OK をクリックすると、新しいランタイムがリストに追加される Node.js ランタイム ダイアログに戻ります。

    リモートランタイムダイアログ: SSH 経由の新しい Node.js ランタイムがリストに追加されました

  7. 新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそれを選択し、 OK をクリックして JavaScript ランタイム ダイアログに戻ります。

    PyCharm は、たとえば実行/デバッグ構成を作成する際に、 ノードランタイム リストから Project エイリアスを選択するたびに、このインタープリターを自動的に使用します。

    新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。 そのためには、 パッケージマネージャー フィールドにパッケージマネージャーの場所を指定します。

    npm 実行可能ファイルのデフォルトの場所は /usr/local/lib/node_modules/npm です。

    SSH 経由で Node.js ランタイムを構成する: デフォルトのプロジェクトインタープリターとして設定

Node.js 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に進みます。 開いた 構成の編集 ダイアログで、ツールバーの Add New Configuration ボタン をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成 」ダイアログが開きます。

  2. ファイル フィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します（たとえば、 Express(英語) アプリケーションの場合は bin/www ）。

    Node.js の実行 / デバッグ構成: JavaScript ファイルが指定されました

  3. 必要に応じて、 Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。

  4. ノードランタイム リストから、SSH 経由でアクセス可能な関連するリモート Node.js ランタイムを選択します。

    Node.js 実行構成を作成する: SSH インタープリターを介してリモート Node.js を選択する

    または、 ノードランタイム フィールドの横にある 参照ボタン をクリックし、 上記のようにリモート Node.js ランタイムを構成します。

  5. ローカルフォルダーをリモートホスト上のフォルダーにマップします。

    1. パスマッピング フィールドの横にある 参照ボタン をクリックするか、 Shift+Enter を押します。

    2. 開いた Edit Project Path Mappings dialog で、ツールバーの 追加ボタン をクリックします。

      Node.js 実行構成を作成する: マッピングの追加

    3. リモートホスト上のローカルフォルダーと対応するフォルダーへのパスを指定します。 例: プロジェクトフォルダーを /home/opc にマップできます。

      Node.js 実行構成を作成する: マッピングが追加されました

    4. OK をクリックすると、 実行 / デバッグ構成 ダイアログに戻り、 パスマッピング フィールドに新しいマッピングが表示されます。

      Node.js 実行構成を作成する: 追加されたマッピングが表示されます

アプリケーションを実行する

  • ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した Node.js 構成を選択し、その横にある 実行ボタン をクリックします。

  • あるいは、 上記の説明に従ってNode.js 実行 / デバッグ構成を作成するか、既存の構成を変更して、ダイアログで 実行 をクリックします。

アプリケーションをデバッグする

  1. 必要に応じて、Node.js コードに ブレークポイント を設定します。

  2. Node.js 構成を as described aboveに従って作成し、ツールバーの 実行 / デバッグ構成を選択 リストから選択して、リスト横の the Debug button をクリックします。

  3. Node.js アプリケーションと一緒にローカルでデバッガーを起動する場合に進みます。

2026 年 6 月 1 日
Node.js と Docker Composenpm、pnpm、Yarn