接続
SSHまたはVNCで接続できない
接続タイムアウト、ホストフィンガープリントの変更、認証情報の拒否、GUIセッションの中断、再接続後の表示異常に適用します。
接続診断を見る
サポートセンター
まず問題を切り分け、次の手順へ
RunnerVPSクラウドMacの接続、システム、ネットワーク、ストレージ、ビルド、アカウントに関する情報をまとめています。まず症状から検索し、診断手順に沿って一つずつ確認しましょう。
ドキュメント2026.09販売中の5ノードを掲載
RUNNER SUPPORT
接続診断レポート
順番に確認
A
デバイス状態を確認
デバイスID、リージョン、現在のアクセス状態を確認
開始
B
接続経路を切り分け
SSHとGUI接続を個別にテスト
分岐
C
再現可能な証拠を収集
時刻、エラー、ネットワーク環境、マスク済みログを記録
引き継ぎ
- 対応方針
- 一度に変更する変数は一つ
- サポートへエスカレーション
- デバイスを関連付けてチケットを送信
問題の分類
症状から確認箇所へ
6つの問題カテゴリを同時に表示しています。各カードで、よくある症状、優先確認項目、このページ内の場所を確認できます。
システム
ツールチェーンのバージョンが変わった
Xcodeの選択ミス、コマンドラインツールのパス変更、システム更新後の依存関係不整合、環境変数の無効化に適用します。
設定方法を見る
ネットワーク
取得、アップロード、ポート転送に失敗する
Git取得の中断、SFTP転送の失敗、SSHトンネルへの接続不能、DNS解決エラー、ローカルネットワークの制限に適用します。
転送のヒントを見る
ストレージ
ビルドキャッシュでディスクが埋まる
DerivedData、アーカイブ、依存関係キャッシュ、ログの増加により、ビルド失敗、書き出し中断、書き込み速度低下が起きた場合に適用します。
容量を確認
ビルド
署名、アーカイブ、自動化タスクに失敗する
証明書と署名ファイルの不一致、runner環境の違い、依存関係キャッシュの汚染、アーカイブ成果物の未生成に適用します。
ビルド設定を見る
アカウント
注文やデバイス情報を確認したい
利用期間、デバイスID、注文履歴、通知用メールアドレス、チケットの関連対象を確認する場合に適用します。
コンソールへ
接続診断
同じ順序で問題範囲を絞り込む
認証情報のリセット、ネットワークの切り替え、システム設定の変更を同時に行わないでください。元のエラーを残し、一度に一項目だけ確認すると結果を比較できます。
01
ノードの状態
コンソールでデバイスID、リージョン、利用期間、アクセス状態を確認します。操作対象が目的のデバイスか確かめ、状態が変化した時刻を記録してください。
02
アクセス認証情報
ユーザー名、SSH秘密鍵のパス、ファイル権限を確認します。秘密鍵、パスワード、完全な接続情報をメール、チャット、通常のログに貼り付けないでください。
03
SSHチャネル
まずホストフィンガープリントを確認し、詳細出力で失敗箇所を特定します。DNS、TCP接続、鍵交換、ユーザー認証を分けて確認しましょう。
04
GUIセッション
SSHは正常でVNCに問題がある場合、クライアントアドレス、セッション状態、解像度設定を確認します。切断後は元のセッションが解放されるまで待ち、同じデバイス情報で再接続してください。
05
システムファイアウォール
リモートアクセスに必要なプロセスが動作し、対象ポートが想定どおり待ち受けていることを確認します。ルールを変更する前に現在の設定を保存してください。
06
ローカルネットワーク
最後にローカルネットワークを変更して比較します。ルートを書き換える可能性のあるプロキシやVPNを一時停止し、社内、家庭、モバイルの各ネットワークで結果を比較してください。
リモートデスクトップ
GUIセッションを復旧可能にする
VNCはXcode、プレビュー、GUIツールを使う作業に適しています。接続前にSSHチャネルを利用できる状態にしておけば、GUIに問題があってもコマンドラインで確認できます。
管理されたVNCクライアントを準備
信頼できるソースからクライアントをインストールし、完全な認証情報ではなくデバイス名を保存します。初回接続ではリージョンとデバイスIDを確認し、暗号化とキーボードマッピングを設定してください。
- デバイス名とアクセスアドレスを別々に保存
- チームメンバーは各自の管理された接続方法を使う
- 管理されたネットワークまたはSSHトンネルを優先
まず解像度を調整してから速度を判断
リモート画面は解像度、色深度、ローカルネットワークの影響を受けます。まず表示領域を狭くして比較し、クライアント、ネットワーク、システム表示設定を同時に変えないでください。
- 低い解像度から入力応答を確認
- 大きなファイルの転送中に画面の滑らかさを評価しない
- 異常の直前に変更した設定を記録
セッションをロックし、プロセスを強制終了しない
短時間離席する場合はGUIセッションをロックし、実行中のビルドを直接閉じないでください。再接続後は元のタスク状態を確認してから、ツールを再起動するか判断します。
- 離席前にプロジェクトと未コミットの変更を保存
- 画面が固まってもすぐにタスクを再起動しない
- メンバーがチームを離れたらアクセス方法を速やかに無効化
ビルド環境
ツールチェーンを固定し、再生成可能なデータを整理
継続的なビルドでは、タスク間で環境が記録なく変化することが最大のリスクです。バージョン選択、署名素材、キャッシュ整理をチームの運用手順に記録してください。
Xcodeとコマンドラインツールを固定
プロジェクト設定とrunner初期化スクリプトにXcodeのバージョンを記録し、実行前に現在の開発者ディレクトリを確認します。システムやXcodeが変わった後は、最小テストを実行してから完全なパイプラインに戻してください。
証明書、署名ファイル、コードリポジトリを分離
証明書、署名ファイル、トークン、環境変数はチーム独自のシークレット管理フローから注入します。長期認証情報をGitに登録したり、機密フィールドを含む元ログを通常の添付ファイルで転送したりしないでください。
出所ごとにキャッシュを整理
まず、容量を使っているのがDerivedData、依存関係キャッシュ、アーカイブ、シミュレータデータ、プロジェクト素材のどれか確認します。再生成できるデータを優先して削除し、返却が必要な成果物と問題発生時の状態は残してください。
環境チェックリスト
タスク実行前
- Xcode
- バージョンがプロジェクト要件と一致
- 開発者ディレクトリ
- 目的のツールチェーンを指定
- 署名素材
- タスクごとに一時注入
- ディスク容量
- キャッシュ、アーカイブ、書き出しを確認
- 最小テスト
- 取得、コンパイル、成果物生成を先に検証
一度に一項目を変更
結果をビルドログに記録
ネットワークとファイル
接続チャネルとファイルチャネルを分けて検証
まず小さなファイルで経路と権限を確認し、その後にリポジトリ、素材、ビルド成果物全体を転送します。失敗時は方向、サイズ、時刻、具体的な段階を記録してください。
必要なポートだけ転送
ローカルポート、接続先アドレス、用途を明確にし、広範囲の待ち受けを避けます。トンネル確立後はSSH自体と転送先サービスを個別に確認し、認証問題とアプリケーション問題を切り分けます。
まずディレクトリ権限を確認
専用のプロジェクトディレクトリでファイルを受け取り、まず小さなサンプルをアップロードして読み書き権限を確認します。大きなファイルの完了後はサイズまたはチェックサムを確認してください。
リポジトリ認証情報の範囲を制限
自動化タスクには最小権限の認証情報を使い、必要なリポジトリに限定します。取得に失敗したら、DNS、リモート到達性、ホストフィンガープリント、認証権限、リポジトリアドレスを個別に確認してください。
返却後に元ファイルを整理
成果物にタスクID、バージョン、チェックサム情報を付けます。接続先で完全に受信したことを確認してからノード上の中間ファイルを削除し、再ビルドして元の結果を失う事態を避けてください。
ナレッジ記事
操作手順からチーム運用へ
以下の記事を公開日順に掲載し、システム更新、接続セキュリティ、サービス選定、音声・動画、Unity iOSビルド、M4開発タスクの検証を扱います。
ナレッジ記事を準備中
記事公開までは、このページの接続診断、システム設定、ネットワーク転送、ビルド環境のチェックリストをご利用ください。
有人サポート
調査可能な状態でチケットを送信
技術的な問題は、具体的なデバイスと注文を関連付けられるため、コンソールから送信してください。ログインできない場合は、support@runnervps.com support@runnervps.com宛てにメールを送れますが、パスワード、秘密鍵、完全な支払い情報は添付しないでください。
デバイスID
コンソールに表示されるデバイス名。アクセスパスワードは送信しない
リージョン
シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部のいずれか
問題発生時刻
タイムゾーンと、最後に正常だった操作の時間帯を記載
再現手順
コマンド、操作、実際の結果を実行順に記載
マスク済みログ
トークン、鍵、パスワード、リポジトリ認証情報、個人データを削除