リモート接続ランブック

接続情報から安定したデスクトップまで、クラウドMacに順番に接続

このガイドは、すでにデバイス情報を取得している開発者向けです。まずノード、ホストアドレス、ローカルネットワークを確認してからVNCセッションを確立します。接続後は画面、キーボード、クリップボードを調整し、ネットワークの問題をホスト障害と取り違えないようにします。

5台 選択可能な物理ノード
1件の注文 対応する専用物理マシン
365日 ノード稼働中
接続ランブック VNC / DESKTOP ACCESS
準備ができたら実行
  1. 01 デバイス情報を確認 ノード、アドレス、アカウント
  2. 02 リモートホストを追加 正しいアドレスを保存
  3. 03 認証を完了 信頼できるデバイスでのみ入力
  4. 04 デスクトップセッションを検証 画面と入力を確認
接続に問題があるときは、複数の変数を連続して変更しない 一度に1項目だけ確認
接続前の準備

まず5種類の情報を確認してからクライアントを開く

リモート接続でよくある誤りは、デバイスの状態、アドレス、ローカルネットワークを確認しないままクライアントを何度も切り替えることです。次の順番で確認すれば、アカウント、ネットワーク、画面の問題を分けて対処できます。

01

デバイスの状態

ログインコンソール注文に対応するデバイスへアクセスできることを確認し、正しいインスタンスを表示しているか確認します。古い注文のスクリーンショットにあるアドレスは再利用しないでください。

02

物理ノード

デバイスがシンガポール、東京、ソウル、香港、米国西部のどのノードにあるか確認します。地域をまたぐ経路は、入力の応答性と画面更新に直接影響します。

03

ホストアドレス

アドレスを1文字ずつ確認し、ポート、スペース、説明文まで一緒にコピーしないでください。アドレスが変わった場合は、コンソールに現在表示されている情報を使用します。

04

アカウント情報

接続アカウントとパスワードは、信頼できるデバイスでのみ入力してください。接続認証情報をコードリポジトリ、グループチャットのスクリーンショット、公開チケット、共有ドキュメントに保存してはいけません。

05

ローカルネットワーク

安定した有線ネットワーク、または電波状態の良いWi-Fiを優先し、上り帯域を使い切る同期タスクを一時停止します。ローカルネットワークがリモート接続を遮断していないことも確認してください。

初回接続

4ステップでVNC初回セッションを検証

以下ではmacOSクライアントを例に説明します。各ステップを完了するたびに結果を確認し、アドレス、認証、画面設定の間を行き来しないでください。

  1. ステップ01

    現在の接続情報を取得

    コンソールで対象デバイスの詳細を開き、ノード、ホストアドレス、接続アカウントを記録します。チームで複数のデバイスを管理している場合は、まず注文番号とデバイスタグを照合します。

    確認:注文、ノード、デバイスタグが一致
  2. ステップ02

    リモートホストを追加

    macOSの画面共有クライアントを開き、アドレス欄にコンソールで提供されたホストアドレスを入力します。プロジェクト名、ノード、デバイスタグなど、識別しやすい名前を付けます。

    確認:クライアントがアドレスエラーをすぐに表示せず、接続を開始する
  3. ステップ03

    接続先を認証

    デバイスに対応する接続アカウントとパスワードを入力します。初回接続時はホスト情報を確認し、コンソールの記録と一致しない場合は操作を停止してアドレスを再確認してください。

    確認:認証に成功し、対象デバイスに入れる
  4. ステップ04

    デスクトップに入り検証を完了

    デスクトップ要素の読み込みを待ち、マウス、キーボード、ウィンドウのドラッグ、クリップボードを順にテストします。その後ターミナルを開いてホスト名を確認し、別のデバイスで誤ってコマンドを実行しないようにします。

    確認:画面、入力、クリップボード、ホスト名がすべて正しい
画面と入力の最適化

まず操作を安定させ、その後に画質を高める

高解像度、多言語キーボード、マルチディスプレイは、リモートデスクトップの変動要因を増やします。調整時は一度に1つの設定だけを変更し、変更前後の入力遅延と画面の鮮明さを記録してください。

解像度とスケーリング

初回接続では低めの解像度を使って経路の安定性を確認し、その後段階的に上げます。文字がぼやける場合は、まずクライアントの拡大率を調整し、リモート解像度とローカル表示倍率を同時に変更しないでください。

キーボードレイアウト

ローカルの入力ソースとリモート側のレイアウトが一致しているか確認します。中日韓入力では英数・日本語切り替えと候補ウインドウを重点的に確認し、欧州キーボードではOption、AltGr、バックスラッシュ、記号キーのマッピングを確認します。

クリップボード同期

まず1行のプレーンテキストを双方向コピーし、その後複数行のコマンドをテストします。パスワード、秘密鍵、マスキング前の設定をクリップボードで転送しないでください。大容量ファイルには管理された転送手順を使用します。

マルチディスプレイ

まず1台のディスプレイで接続検証を完了してから、2台目の画面を追加します。黒帯、倍率の不一致、カーソルのずれが発生した場合は単一画面に戻し、主画面と副画面の配置を再確認してください。

経路遅延の目安

主要アクセス都市から5つのノードへのPing中央値

下表は相対的な距離を比較するためのもので、すべてのユーザー回線で固定的に得られる結果ではありません。数値はローカル通信事業者、国際経路、Wi-Fi品質、測定時間帯の影響を受けます。注文前に実際のネットワークで再測定できます。

測定日 2026年8月22日
接続事業者 現地の主要固定回線
測定時間帯 現地時間 14:00–17:00
サンプル回数 各経路30回
集計方法 ICMP往復時間の中央値
主要アクセス都市からシンガポール、東京、ソウル、香港、米国西部の各ノードへのPing中央値(ミリ秒)
アクセス都市 シンガポール 東京 ソウル 香港 米国西部
上海 73 ms 48 ms 55 ms 34 ms 142 ms
深圳 42 ms 66 ms 72 ms 21 ms 151 ms
台北 58 ms 31 ms 46 ms 37 ms 126 ms
大阪 78 ms 18 ms 35 ms 61 ms 113 ms
ソウル 89 ms 37 ms 9 ms 67 ms 128 ms
シンガポール 8 ms 72 ms 86 ms 39 ms 168 ms
ロサンゼルス 176 ms 112 ms 128 ms 151 ms 24 ms

ハイライト値は、今回のサンプルで各アクセス都市から最も低かった中央値を示します。VNCの操作感はジッター、パケットロス、上り帯域幅にも左右されるため、1回のPingだけでノードを選ばないでください。

安全な接続習慣

リモートデスクトップを本番環境への入口として管理

専用物理マシンはリソースを分離できますが、接続の安全性はアカウント、認証情報、操作習慣にも左右されます。チームでは操作者ごとに追跡可能なアクセス境界を設定してください。

  • 専用の接続アカウントを使用 同じアカウントを複数人で長期間共有せず、メンバー変更時は速やかに権限を調整します。
  • 強固で固有のパスワードを設定 コードホスティング、メール、その他のシステムのパスワードを使い回さず、スクリプトにも書き込まないでください。
  • 最小権限を徹底 日常のビルド用アカウントにはタスクに必要な権限だけを付与し、管理操作と自動化タスクを分けて実行します。
  • 認証情報を定期的に更新 メンバーの離脱、デバイスの紛失、不審なログインの兆候があった場合は、関連する認証情報を直ちに変更してください。
  • デバイスを離れるときはセッションをロック 短時間席を離れる場合でもリモートデスクトップをロックし、不要になったローカル接続ウィンドウを閉じます。
記録してよい情報

調査に必要なコンテキスト

注文番号、ノード、発生時刻、macOSバージョン、クライアントバージョン、再現手順、マスキング済みエラーログ。

共有禁止

あらゆる接続秘密情報

パスワード、秘密鍵、完全な接続認証情報、リポジトリキー、マスキングされていない設定ファイルを公開の連絡先に送ってはいけません。

トラブルシューティング

症状から切り分け、すべての設定を同時に変更しない

まず発生時刻と現在の症状を記録し、最も確認しやすい条件から調べます。各確認が終わるたびに1回再試行し、どの変数が接続に影響したかを特定できるようにします。

接続を確立できない
  1. コンソールでデバイス、ノード、ホストアドレスが同じ注文に対応しているか確認します。
  2. アドレスにスペース、説明文、期限切れの記録が混在していないか確認します。
  3. 安定したネットワークに切り替え、上り帯域を使用する同期タスクを一時停止します。
  4. クライアントのエラーテキストと発生時刻を記録してから、マスキング済み情報を送信します。
接続後に画面が黒い、またはデスクトップが更新されない
  1. デスクトップの読み込みが完了するまで待ち、連続して切断・再接続しないでください。
  2. クライアントの画質または解像度を1段階下げて、もう一度確認します。
  3. フルスクリーンを終了して単一ディスプレイモードに戻し、画面レイアウトの問題を切り分けます。
  4. 画面が表示されない場合は、カーソルが見えるか、最後に正常だった時刻を記録します。
マウスやキーボードの入力遅延が目立つ
  1. Pingを複数回連続して測定し、安定した高遅延と一時的なジッターを区別します。
  2. ローカルでの大容量ファイルのアップロード、バックアップ、ビデオ会議を停止してから再測定します。
  3. リモートデスクトップの解像度と画質を下げ、入力応答を確認します。
  4. ビルドタスクがプロセッサ、メモリ、ディスクを継続的に使用していないか確認します。
クリップボードを同期できない
  1. まず1行のプレーンテキストをコピーし、リッチテキストや大容量コンテンツの影響を除外します。
  2. ローカルからリモート、リモートからローカルの両方向を個別にテストします。
  3. クライアントでクリップボード共有が無効になっていないか確認します。
  4. セッションを再確立して再テストし、機密情報をクリップボードで転送しないでください。
解像度、倍率、カーソル位置が正しくない
  1. フルスクリーンを終了して単一ディスプレイモードに戻します。
  2. ローカルの倍率を固定してから、リモート解像度だけを調整します。
  3. 切断後に再接続し、クライアントが新しい画面設定を読み込んだか確認します。
  4. ローカルディスプレイの解像度、倍率、クライアントバージョンを記録します。
セッションが断続的に切断される
  1. 切断が発生した正確な時刻と継続時間を毎回記録します。
  2. ローカルネットワークで同時にWi-Fiローミングや経路切り替えが発生していないか確認します。
  3. 自動化タスクのタイムラインと照合し、高負荷タスクと重なっていないか確認します。
  4. マスキング済みのクライアントログを保存し、コンソールからチケットを送信します。
CIとデスクトップの並行利用

手動操作が自動ビルドを妨げないようにする

リモートデスクトップとself-hosted runnerは同時に使用できますが、同じ専用物理Macのプロセッサ、メモリ、ディスク、ネットワークを共有します。チームで監視指標と操作範囲を明確にしてください。

並行作業ランブック デスクトップセッションとビルドキューの共存ルール
監視

まずリソース状態を確認

大容量ファイルのコピー、依存関係のインストール、グラフィック操作を開始する前に、プロセッサ、メモリ、ディスク容量、ネットワーク使用量を確認し、実行中のビルドがないか確認します。

分離

作業ディレクトリを分ける

手動デバッグでrunnerが使用中のワークスペースを直接変更しないでください。一時検証には独立したディレクトリを作成し、クリーンアップスクリプトが別タスクのファイルを削除しないようにします。

制限

影響の大きい操作を避ける

ビルド実行中は、重要なプロセスの終了、キャッシュの一括削除、ツールチェーンバージョンの切り替え、デバイスの再起動を不用意に行わないでください。変更が必要な場合は、まず新しいタスクのキュー投入を停止します。

記録

問題のタイムラインを保存

異常の発生時刻、対象リポジトリ、runnerタグ、タスク番号、手動操作を記録します。タイムラインにより、問題がネットワーク、リソース競合、環境変更のどれに起因するか判断しやすくなります。

推奨する検証順序 キューの状態を確認 → リソースを確認 → 単一操作を実行 → 時刻を記録 → ビルドログと照合
接続後の次のステップ

デスクトップが安定してからXcodeとrunnerを設定

サポートガイドにツールのバージョン、作業ディレクトリ、runnerタグを記録してください。接続に問題が残る場合は、発生時刻、ノード、クライアントバージョン、マスキング済みログを保管し、コンソールのチケットまたはサポートメールでチームに連絡してください。

support@globemini.com