Platform For AI:リモート接続：ProxyClient

手順1： DSW ProxyClient のダウンロードとインストール

1. DSW ProxyClient ツールをダウンロードし、ホームディレクトリに保存します。

   お使いのオペレーティングシステムに応じて、ツールを以下のディレクトリに保存します。

   • Windows オペレーティングシステム： ユーザーの個人フォルダーに保存します。例： C:\Users\<username> または C:\ユーザー\<username>。

   • Linux： root ユーザーの場合は /root に、一般ユーザーの場合は /home/<username> に保存します。

   • macOS： /Users/<username> に保存します。

   <username> を実際のユーザー名に置き換えます。

   お使いのオペレーティングシステム用のクライアントをダウンロードします。

   • Linux (x86-64)

   • macOS (x86-64)

   • macOS (ARM64)

   • Windows (x86-64)

2. ターミナルで、ダウンロードしたクライアントファイルに実行権限を付与します。Windows (x86-64) バージョンの場合、この手順はスキップできます。

   chmod 755 <proxyclient>

   <proxyclient> をダウンロードしたクライアントファイルの名前に置き換えます。

3. 設定ファイルを生成します。

   1. 設定コマンドを実行します。

      # macOS または Linux
      ./proxyclient config
      # Windows
      proxyclient.exe config

      重要

      macOS で初めて ./proxyclient コマンドを実行すると、"proxyclient" cannot be opened because the developer cannot be verified. というプロンプトが表示されることがあります。続行するには、[システム環境設定] > [セキュリティとプライバシー] を開き、proxyclient の実行を許可してください。

   2. プロンプトに従って、設定ファイルのパスを設定します。

      設定ファイルの名前を入力します。パスを含めることもできます。

      説明

      • 推奨： Enter キーを押し、デフォルトのパスとファイル名 ~/.proxyclientconfig を使用します。

      • カスタムパスとファイル名を指定することもできます。たとえば、Windows の場合： C:/Users/<username>/xxx/.proxyclientconfig。

      • カスタムパスを設定した場合は、「手順3」 で ./proxyclient add コマンドを実行する際に、-c または --config-file フラグを使用してそのパスを指定する必要があります。

   3. プロンプトに従って、RegionId、AccessKey ID、AccessKey Secret、および STSToken パラメーターを設定します。

      次の表にパラメーターを示します。

      パラメーター	説明
      RegionId	DSW インスタンスが配置されているリージョンの ID です。たとえば、中国 (上海) の場合は cn-shanghai です。リージョン ID のリストについては、「リージョンとゾーン」をご参照ください。 重要 リージョン ID は、DSW インスタンスのリージョンと一致している必要があります。
      AccessKey ID	Alibaba Cloud アカウントのアクセスキーペアです。詳細については、「アクセスキーペアの作成」をご参照ください。
      AccessKey Secret
      STSToken	Alibaba Cloud アカウントまたは RAM ユーザーを使用している場合は、このパラメーターは空のままにしてください。 RAM ロールを使用してログインする場合は、一時的なセキュリティ認証情報を使用してこのパラメーターを設定する必要があります。STS トークンの生成方法については、「STS 一時トークンの取得」をご参照ください。 重要 STS トークンが有効であることを確認してください。

手順2： SSH 認証の設定

SSH キーペアまたはパスワードを使用して DSW インスタンスに接続できます。

手順3： DSW インスタンスプロキシの追加

1. インスタンスリストから、接続したい DSW インスタンスの ID をコピーします。

   ターゲットインスタンスをクリックして詳細パネルを展開します。パネル内で [Instance ID] フィールド (例： dsw-xxxxxxd6) を見つけ、プロキシ設定用にインスタンス ID をコピーします。

2. ローカルのターミナルで、次のコマンドを実行して、DSW インスタンスを SSH ターゲットホストとして追加します。

   <instance_id> をコピーしたインスタンス ID に置き換えます。

   # macOS または Linux
   ./proxyclient add -i=<instance_id>
   # Windows
   proxyclient.exe add -i=<instance_id>

3. .ssh/config ファイルの内容を表示して、プロキシ設定が適用されていることを確認します。

   # macOS または Linux
   cat .ssh/config
   # Windows
   # ローカルのターミナルで、ユーザーのホームディレクトリに移動し、次のコマンドを実行します。
   # config ファイルをダブルクリックして開くこともできます。
   explorer .ssh\config

4. オプション：SSH キーペアを生成する際に example_id_rsa のようなカスタムファイル名を使用した場合は、次の例に示すように ~/.ssh/config ファイルを変更します。IdentityFile パラメーターを使用して、接続に使用する秘密鍵ファイルのパスを指定します。

   Host dsw-b7a2765b267e****
       HostName dsw-b7a2765b267e****
       User root
       ProxyCommand ~/proxyclient connect --region-id=cn-hangzhou --instance-id=dsw-b7a2765b267e**** --config-file=***
       ServerAliveInterval 30
       IdentityFile ~/.ssh/example_id_rsa

手順4： DSW インスタンスへの接続

ssh <instance_id>

# ローカルファイルをリモートインスタンスにコピーします。
scp local_file_path root@<instance_id>:<remote_file_path>
# ローカルディレクトリをリモートインスタンスにコピーします。
scp -r local_dir root@<instance_id>:<remote_dir>
# リモートインスタンスからローカルマシンにファイルをコピーします。
scp root@<instance_id>:<remote_file_path> <local_file_path>
# リモートインスタンスからローカルマシンにディレクトリをコピーします。
scp -r root@<instance_id>:<remote_dir> <local_dir>

Q： Direct SSH と ProxyClient の違いは何ですか。

Q： RAM ユーザーで接続に失敗するのはなぜですか。

RAM ユーザーの AccessKey を使用して ProxyClient 経由で接続する場合、プライマリアカウントが RAM ユーザーに paidsw:GetToken 権限を付与していることを確認する必要があります。そうでない場合、認証は失敗します。この権限を追加する手順は次のとおりです。

Q： 接続がタイムアウトしたり失敗したりするのはなぜですか。

proxyclient.exe によって生成された設定ファイルで、RegionId が DSW インスタンスのリージョンと同じであることを確認してください。

Q： SSH ログイン用に複数のユーザーを作成できますか。

デフォルトでは、DSW インスタンスは SSH ログイン用に root ユーザーのみを提供します。現在、DSW は複数の独立したユーザーを作成し、それぞれに分離された SSH ログインを設定することをネイティブにサポートしていません。インスタンス内で手動で新しいユーザーを作成することはできますが、これは公式にサポートされている標準的な方法ではありません。

Q： ローカル IDE でワークスペースファイルを見つけるにはどうすればよいですか。

SSH 経由でログインした後、デフォルトのディレクトリは root ユーザーのホームディレクトリ (/root) である場合があります。作業ファイルは通常、/mnt/workspace などのマウントされたデータディスクパスにあります。VSCode では、サイドバーの [File] > [Open Folder] 機能を使用して、サーバー上の正しい作業ディレクトリを手動で選択して開くことができます。その後、ファイルエクスプローラーでプロジェクトファイルを表示できます。