画面を操作するならVNCまたはmacOS画面共有、ビルドやスクリプトの実行だけならSSHを使います。接続先は仮想マシンではなく、Apple Silicon搭載の専有物理ノードです。
すでにご注文済みですか？コンソールのインスタンス詳細でIPアドレス、ユーザー名、接続ポートを確認し、以下の手順で接続してください。本文中のホスト名とポートは設定例です。
ローカルのVNCクライアントまたはmacOS画面共有
SSHトンネル → ノードのデスクトップローカル端末またはCIランナー
SSH → コマンドラインとビルドプロセスポート番号は実際に提供されたインスタンス情報をご確認ください。VNCと画面共有は通常、同じ画面共有サービスを利用するため、別々のデスクトップが用意されるわけではありません。
Windows、Linux、iPadからの接続に適しています。Xcodeの起動、ビルド設定の確認、クリック操作が必要なシステムダイアログの対応に使えます。
選ぶ目安：手元の端末はMacではないが、macOSのデスクトップを使いたい。
手元の端末がMacなら、まずはこちらをお試しください。macOS標準の画面共有を使うため、別途ビューアをインストールする必要はありません。
選ぶ目安：手元もMacで、クライアントの設定をできるだけ簡単にしたい。
xcodebuildの実行、ログの確認、プロジェクトの同期、ランナーの管理に適しています。デスクトップ画面を常時転送しないため、長時間のビルドにも向いています。
選ぶ目安：コマンドで実行できる作業、またはCIパイプラインに組み込む作業。
以下はSSHポート22、VNCサービスのポート5900を例にしています。実際のポートが異なる場合は、該当する番号を置き換えてください。画面共有のパスワードとSSHユーザーのパスワードが同じかどうかは、提供時の案内とノードの現在の設定をご確認ください。パスワードを混同しないようご注意ください。
| ローカルOS | おすすめの画面共有クライアント | 画面共有アドレスとポートの入力方法 | SSH接続 |
|---|---|---|---|
| Windows | TigerVNC Viewer。ノードで現在有効なVNC認証方式に対応していることを確認してください。 | 直接接続する場合は、クライアントのHost / Port欄を使用します。以下の手順でトンネルを作成した後は、Hostに 127.0.0.1、Portに 15900を入力します。 |
Windows TerminalでOpenSSHクライアントを使い、次を実行します： ssh -p 22 build@HOST_IP。 |
| Linux | RemminaのVNCモード、または対応する認証方式を使えるTigerVNC Viewer。 | トンネル経由で 127.0.0.1:15900に接続します。クライアントにポート専用欄がある場合は、アドレスとポートを別々に入力してください。ディスプレイ番号は入力しません。 |
端末でOpenSSHを使用します。通常のSSH接続を確認してから、ローカルポート転送を設定してください。 |
| macOS | macOS標準の「画面共有」。 | 直接接続する場合のアドレスは vnc://HOST_IP:5900です。トンネル経由の場合は vnc://127.0.0.1:15900を使います。 |
端末で sshを実行します。また、 open コマンドで画面共有アドレスを開くこともできます。 |
| iPad | macOS認証とSSHトンネルに対応したVNCクライアント。 | クライアントでSSHホストと認証を設定し、画面共有の接続先をノード側の 127.0.0.1:5900に指定します。項目名はクライアントによって異なります。 |
鍵をインポートできるSSHクライアントを使用します。まず鍵認証を確認し、その後クライアント内蔵のポート転送を有効にしてください。 |
コンソールでノードのIPアドレス、SSHポート、ユーザー名を確認します。初回接続時はホストのフィンガープリントを照合してください。コンソールに表示されない場合は、サポートチケットでお問い合わせください。再インストール後にフィンガープリントが変わることがあります。確認してからローカルの記録を更新し、ホスト検証を無効にするオプションで警告を回避しないでください。
初回ログイン後、 passwd を実行して現在のユーザーのパスワードを変更し、画面共有サービスの認証方式を確認してください。VNC専用パスワードを使っている場合は、それも別途変更します。パスワードをリポジトリ、ビルドログ、共有スクリプトに書き込まないでください。
ローカルで生成した公開鍵を、ノードの ~/.ssh/authorized_keysに追加します。秘密鍵は信頼できるクライアントだけに保存してください。新しい端末を開いて鍵認証の成功を確認してから、パスワード認証の制限を検討します。変更前の接続はそのまま残し、設定ミスでノードにアクセスできなくなるのを防いでください。
デスクトップ操作が必要なときだけ画面共有サービスを有効にします。macOSの「システム設定 → 一般 → 共有 → 画面共有」で、アクセスできるユーザーを制限してください。サービスを停止または変更する場合は、先にSSH接続が使えることを確認します。トンネルを暗号化しても、リモート側のポートがインターネットから自動的に遮断されるわけではありません。
以下のコマンドはローカルで実行します。build と HOST_IP は提供された値に置き換えてください。鍵を生成するときは、秘密鍵にパスフレーズを設定します。
ssh-keygen -t ed25519 -f ~/.ssh/armvnc_build
cat ~/.ssh/armvnc_build.pub
ssh -p 22 build@HOST_IPノードにログインしたら、ディレクトリを作成し、公開鍵ファイルを編集してアクセス権を設定します。前の手順で表示された公開鍵全体を1行で貼り付けてください。秘密鍵は貼り付けないでください。
mkdir -p ~/.ssh
chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keysローカルに戻り、次のコマンドで確認します：ssh -i ~/.ssh/armvnc_build -p 22 build@HOST_IP
ローカルポートには15900、リモート側の接続先には5900を使います。転送先はローカルのループバックアドレスに限定されるため、同じネットワーク上のほかの端末からはアクセスできません。
ssh -i ~/.ssh/armvnc_build -p 22 \
-N -T \
-o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 \
-o ServerAliveCountMax=3 \
-L 127.0.0.1:15900:127.0.0.1:5900 \
build@HOST_IPコマンドが実行中でエラーが出ていなければ、画面共有クライアントからローカルの15900ポートに接続します。macOSでは別の端末を開いて、次を実行できます：
open 'vnc://127.0.0.1:15900'トンネルを使ってもVNC認証は省略されません。使い終わったら画面共有クライアントを終了し、トンネルを実行している端末で Ctrl + C を押して転送を終了します。
以下はトラブルシューティング用の初期設定であり、帯域幅や遅延を保証するものではありません。色深度や圧縮を調整できるかは、プロトコルの実装によって異なります。一度に変更する項目は1つにして、Xcodeウィンドウの移動、ログのスクロール、文字入力など、同じ操作で比較してください。
文字の読みやすさを優先します。クライアントのウィンドウが小さい場合は、まず縦横比を保った拡大縮小を有効にしてください。リモート側の解像度とローカル側の拡大率を同時に上げないでください。
用途：Xcodeの設定、ログ確認、ときどき行うGUI操作。
まずデスクトップアニメーションや不要なプレビューを無効にします。高圧縮では画面の細部が粗くなることがあります。転送量は減らせますが、ネットワークの往復時間は短縮できません。
用途：遠距離のノード、モバイル回線、断続的なパケットロスがある環境での一時的な操作。
画面を見る必要がない場合は、ビルドログと成果物を保存してください。画面共有クライアントが切断されてもmacOSからログアウトするわけではなく、タスクの停止方法としても使えません。
用途：常時稼働のCI、無人実行スクリプト、繰り返し実行するビルドタスク。
ノード選びでは用途も考慮してください。デスクトップ操作では手元からノードまでのネットワーク経路が重要です。ビルドだけを行う場合は、リポジトリの取得、依存関係のダウンロード、成果物のアップロード経路も考慮します。マウス操作が一度スムーズだったからといって、コンパイル性能まで判断しないでください。
まずSSHをテストし、次に画面共有を試します。SSHは使えるのにVNCが失敗する場合は、画面共有サービスとトンネルの接続先を確認してください。両方とも使えない場合は、インスタンスの状態、アドレス、ローカルネットワーク、ポートを確認します。いきなりOSを再インストールしないでください。
まず接続の切断とタスクの終了を区別してください。SSHまたは画面共有に再接続したら、実行中のプロセスとログを確認します。archiveをすぐに再実行すると、タスク同士がリソースを奪い合ったり、成果物が重複して公開されたりするおそれがあります。
前述のSSHキープアライブ設定は、接続経路の障害検知に役立ちますが、継続的なパケットロスを解消するものではありません。ローカルの有線接続や別の信頼できるネットワークを試し、同じノードで比較してください。長時間のタスクは、端末を開いたままにするのではなく、ランナーサービスまたは管理されたバックグラウンドプロセスで実行してください。
pgrep -fl xcodebuild
tail -n 80 ~/build.log2つ目のコマンドは、ログをこのパスに保存している場合にのみ使えます。ファイルがない場合は、ビルドスクリプトに設定したログの保存先を確認してください。
まず画面共有クライアントを切断してから再接続し、「表示のみ」モードが有効になっていないことを確認してください。クライアントに認証画面が表示されるかも確認します。認証後に画面が真っ黒になる場合と、まったく接続できない場合では、原因が異なります。
SSHが使える場合は接続を維持し、画面共有の設定、アクセスユーザー、現在のセッションを確認してください。システムの画面共有プロセスを繰り返し強制終了したり、ビルド実行中にノードを再起動したりしないでください。復旧しない場合は、コンソールからサポートチケットを送信し、ロック前と後のどちらで画面が黒くなったか、クライアント名とバージョンを記載してください。
クライアントでクリップボード共有が許可されていることを確認し、「表示のみ」の制限を解除してください。まず短いテキストで双方向のコピーを試します。画像、ファイル、リッチテキストは同じクリップボード経由で転送できるとは限りません。
クライアントにクリップボードの個別送信機能が必要か確認し、必要に応じて切断してからセッションを再接続してください。プロジェクトファイルの転送にはSCPまたはSFTPを使います。機能テストのために、パスワード、秘密鍵、署名情報一式を共有クリップボードに入れないでください。
タイムアウトは通常、認証が始まる前に発生します。IPアドレスとポートを確認し、ローカルネットワークでそのポートが制限されていないか調べてください。詳細ログを使うと、接続がどの段階で止まるか確認できます。 Permission denied と表示される場合は、ユーザー名、公開鍵の内容、ファイル権限、クライアントで選択している秘密鍵を重点的に確認してください。
ssh -v -i ~/.ssh/armvnc_build -p 22 build@HOST_IPログを送信する前に、ユーザー名、IPアドレス、ローカルの機密パスなど不要な情報を削除してください。秘密鍵やパスワードは絶対に送らないでください。ホストのフィンガープリントが変わった場合は、再インストールやインスタンス変更があったか確認し、検証記録をすぐに削除しないでください。
画面が切れている場合は、まずクライアントのウィンドウに合わせる設定や拡大縮小を確認し、次にノードの「システム設定 → ディスプレイ」を確認してください。クライアントのウィンドウサイズを変えても、リモートデスクトップの解像度が変わるとは限りません。
キー入力がずれる場合は、ローカルのキーボード配列、クライアントのキー割り当て、リモート側の入力ソースを確認してください。パスワードやコマンドを入力する前に、テキストエディタで英字、数字、記号をテストします。WindowsのCtrl / AltとmacOSのCommand / Optionは、個別の割り当てが必要な場合があります。
利用ガイドに沿って環境を準備してください。利用開始、接続、料金に関する問題はヘルプセンターをご確認ください。まだ契約していない場合は、注文ページでマシンタイプとノードを選べます。
お支払い方法はUSDT-TRC20、Visa / Mastercard / Amex（Stripe）のみです。決済通貨はUSDです。実際に利用できる決済ゲートウェイは、チェックアウト時の表示をご確認ください。