ドキュメント · 1.0

コンソールとリモートデスクトップ

この章では、仮想マシンの画面を見てキーボードを操作する方法を説明します。Web のグラフィックコンソール（VNC）とシリアルコンソール、RDP クライアントでの接続、ホストに直接つないだモニター（Ctrl-Alt-F1 … F12 と情報画面）、USB リダイレクト、画面録画です。仮想マシンの電源操作と設定変更は仮想マシンを参照してください。

1. Web のコンソール

仮想マシンが稼働中のとき、一覧の各行と詳細ページの上部にコンソールボタンがあります。シリアルコンソールと、VNC をオンにした仮想マシンには画面（VNC）も表示されます（一覧ではアイコンで、マウスを置くとヒントが出ます）。VNC をオンにしていない仮想マシンにはグラフィックコンソールがありません。仮想マシン §2.5を参照してください。詳細ページの左側には guest の画面の小さな画像があり、5 秒ごとに更新されます。押すと VNC コンソールが開きます。仮想マシンに画面がないときは画面なしと表示されます。

各コンソールには 3 つの開き方があります。

• 別ウィンドウで開く：ボタン自体を押します（詳細ページではボタンに ↗ が付いています）。
• このページで開く：詳細ページのボタンの横にあるこのページで開く。
• フローティング：常に最前面にあり、ブラウザーの外へドラッグできます（タブごとに 1 つ。ブラウザーの対応が必要です）。一覧のアイコンボタンはこの方法で開きます。

ブラウザーがポップアップをブロックした場合は通知が出て、自動的にこのページで開く方式に切り替わります。このサイトのポップアップを許可すれば、別ウィンドウが使えます。

1.1 画面（VNC）

Web が仮想マシンの画面を直接表示します。キーボードとマウスが使え、起動画面、BIOS、インストーラーまで見られます。上部にいくつかボタンがあります。

• Ctrl-Alt-Del：このキーの組み合わせを仮想マシンに送ります（実際のキー入力はブラウザーが横取りします）。
• 全画面、ウィンドウに合わせる。
• 切断されたら再接続を押します。状態は接続中…、接続済み、切断されましたのいずれかが表示されます。

同時に見られるのは 1 人だけです。ほかの人が使っているときは、ページに「○○ が ○○ からこの画面を使っています」と表示されるので、引き継ぐ（相手は切断されます）を押して奪います。奪われたほうには「○○ がこの画面を引き継ぎました」と表示されます。

注意：グラフィックスカードをパススルーした仮想マシンは、ドライバーが動き出すと画面がそのカードにつながったモニターに出るため、Web コンソールが起動画面のまま止まって見えることがあります。固まっているわけではありません。Intel 内蔵 GPU をパススルーした仮想マシンでは、Web コンソールに内蔵 GPU の画面が約 10 フレーム/秒で表示されます。滑らかな表示が必要なときは RDP を使ってください。

1.2 シリアルコンソール

仮想マシンのシリアルポート（テキスト）です。Linux、BSD、ルーターでカーネルやログイン端末をシリアルにつないでいるときに便利です。複数の人が同時に見られますが、同時に入力できるのは 1 人だけです。

• ステータスバーには入力できます、または閲覧のみ · ○○ が入力中 / 閲覧のみ · 入力している人はいません、そして N 人接続中と表示されます。
• 閲覧のみのページで入力を引き継ぐを押すと入力を始められ、入力をやめるを押すと手放します。ほかの人が引き継いだときは通知が出ます。
• 仮想マシンが稼働していないときは「稼働していません。起動したら接続します」と表示され、起動後に自動で接続されます。切断されたときも自動で再接続します。

シリアルの内容は、詳細ページ上部のログのシリアルタブにも残っています。仮想マシン §10を参照してください。

2. RDP で仮想マシンの画面に接続する

keelOS はホスト上に RDP サービス（keel-rdp）を備えており、すべての仮想マシンがホストの 3389 ポートを共用します。ユーザー名で仮想マシンを選びます。接続先は仮想マシンの画面そのものであり、guest 内のリモートデスクトップではありません。guest 内には何もインストールする必要がなく、起動画面、BIOS、インストーラー、ネットワークのない仮想マシンでも見て操作できます。

仮想マシンの詳細ページの RDP 行には アドレス:ポート、ユーザー名 仮想マシン名 と書かれ、その下の行でパスワードが何かが説明されます。この guest 専用の RDP パスワード（編集ページのリモートコンソールで設定）、管理者パスワード（未設定の場合。ユーザー名はやはり仮想マシンの名前）、またはホストの RDP パスワードのいずれかです。

• Windows：.rdp ファイルをダウンロードを押し、ダブルクリックすると、リモート デスクトップ（mstsc）が接続します。パスワードは mstsc が尋ねます。
• その他の OS：任意の RDP クライアント（FreeRDP、Remmina、各プラットフォームの「Windows App」）に、同じアドレス、ポート、ユーザー名、パスワードを入力します。
• kRDPclient：keel 独自のクライアントで、mstsc に加えて、動画エンコードされた画面、USB リダイレクト、サウンドに対応します。関連ソフトを参照してください。

RDP サービスは mDNS と同じく、システムで丸ごとオフにできます。システム：メンテナンス、時刻、ホストコンソールを参照してください。

2.1 コンソールの映像（kRDPclient 用）

編集ページのリモートコンソールセクションにあるコンソールの映像で、kRDPclient が受け取る映像を調整します（mstsc には影響しません）。次回の RDP 接続から反映されます。

• フレームレート：既定は 60。
• 画質：バランス（既定）、速度優先（CPU 少なめ）、画質優先（CPU と帯域を多く使う）。
• エンコードスレッド：自動（既定）、または最大 N 個。

2.2 サウンド

編集ページのデバイスにあるサウンドカード（HD Audio）：自動（keel が決める）、オン、オフ。音声は keel-rdp が RDP クライアントに送り、guest は OS 標準のドライバーを使います。自動の場合、Windows Vista 以降と Linux デスクトップにはサウンドカードが付き、Windows XP、Server 2003、ルーター、NAS、画面のない仮想マシンには付きません。次回のコールドスタートで反映されます。詳細ページのサウンドカード行に、現在あるかどうか、ない場合はその理由（たとえば「PCI スロット 3～27 が使い切られている」）が書かれます。

2.3 USB リダイレクト

ユーザーのパソコンの USB メモリ、USB-シリアル変換、ドングルを、RDP クライアント経由で仮想マシンに接続できます。編集ページのデバイスで USB リダイレクト（RDP クライアント側のデバイス）にチェックを入れます。keel は仮想マシンに空の USB ポートを 2 つ（USB 2 と USB 3）追加し、クライアントが接続すると、デバイスがここにつながります。

• mstsc：ローカル リソース → 詳細… → その他のサポートされている RemoteFX USB デバイス。kRDPclient は画面上で選びます。
• UHCI の USB を使う仮想マシン（Windows 7 以前）では、今のところ使えません。ホストの bhyve が古い場合は、チェックボックスの横に USB リダイレクトには新しい bhyve が必要ですと表示されます。
• 詳細ページに USB デバイスカードが現れ、各ポートのデバイス、挿した人（アカウントと接続元アドレス）、挿した時刻が一覧表示されます。監査ログにも記録されます。取り外すボタンは現在、要求を記録するだけで強制的には外しません。ユーザーにクライアント側でチェックを外してもらってください。
• USB から一度だけ起動：RDP 経由で起動用 USB メモリを接続してこのボタンを押すと、次回の起動（稼働中なら先にリセット）が USB メモリからになります。1 回限りで、UEFI の仮想マシンだけにあり、USB と電源の権限が必要です。USB メモリがなければ通常どおりハードディスクから起動します。

3. 画面録画

詳細ページの画面録画カードはドライブレコーダーのようなものです。オンにすると、仮想マシンの実行中は常に、非常に低いフレームレートで画面を記録します。約 1 分ごとに 1 区切りで、容量がいっぱいになると古いものから削除します。最新の数区切りは診断パッケージに含まれ、問題が起きたときにそれ以前に何が起きたか確認できます。

• オン / オフ：スイッチです。設定で録画の容量上限（MiB）（16～65536）と毎秒フレーム数（1～10）を変更できます。
• 表示：再生ウィンドウが開き、区切りごとに時刻順に一覧します（開始、長さ、サイズ。録画中のものは録画中）。行を押すと再生します。時刻はホストのタイムゾーンで表示されます。すべて削除でこの仮想マシンの録画をすべて消去します。
• 設定の変更には仮想マシンの書き込み権限、表示にはコンソール権限が必要です。

4. ホスト自身のモニター：画面（F1–F12）

ホストにモニターとキーボードがつながっていると、仮想マシン → 画面（F1–F12）サブページが現れます（ローカル画面機能がオフのとき、またはホストにモニターがつながっていないときは表示されません）。

• Ctrl-Alt-F1 がホスト自身のコンソールで、Ctrl-Alt-F2、F3 … で各仮想マシンの画面に切り替えます。どこでも同じキー体系です。VNC をオンにした仮想マシンだけが 1 つのキーを占め、既定では名前順に並びます。
• ページ上部は F1 … F12 のキーバーで、各キーに現在の画面が表示されます（5 秒ごとに更新）。表示中で、モニターが今どのキーにあるかが分かります。切り替えボタンはそのキーを押すのと同じです。GPU をパススルーした仮想マシンには「GPU パススルー、表示できません」と書かれます。仮想マシンの名前をキーにドラッグするか、キーの中で選ぶと、使うキーを変更できます。自動に戻すで名前順に戻ります。手作業で並べたあとに新しく作った仮想マシンは、最初の空きキーに入ります。
• 電源が入っていない仮想マシンの画面にはメッセージが出て、Enter を押すとそのまま起動します。
• Ctrl-Alt-Fn そのものを仮想マシンに送りたいとき（たとえば Linux デスクトップからテキスト端末に戻すとき）は、Ctrl-Alt-Shift-Fn を押します。
• 仮想マシンの画面では、Ctrl-Alt-Fn 以外のキーはすべてそのまま仮想マシンに渡されます。
• 内蔵 GPU の SR-IOV VF を使う仮想マシンは、ホストからは画面が見えません。画面キーにドラッグしておくと、そのキーを押したときに表示用仮想マシンがその keelagent の画面を表示します（guest 内で keelagent を動かし、デスクトップにログインしている必要があります）。この項目は実験的な機能で、情報画面カードでは既定でオフです（VF ゲストを画面キーに表示（実験的））。13420H のようなマシンでは GPU のビデオエンジンが固まり、仮想マシンがブルースクリーンになるので、オフのままにしてください。

注意：各キーに対応する仮想マシンは、keelOS の基盤の再起動（reload）後も元の画面に戻ります。

4.1 情報画面

F2 は既定で情報画面です（ページには情報画面と書かれています）。管理者パスワードを設定する前は keelOS のロゴとログインアドレスを表示し、設定後は時計、ホスト情報、CPU、メモリ、仮想マシン一覧を表示します。キーバーの下の「情報画面」カードでオンにでき、表示するキーでどのキーを占めるかを選べます（キーなし = 占めない）。6 つのテンプレート（ホスト概要、システム、フォトフレーム、動画、天気、時計）がリアルタイムのプレビューで並び、押すとそれに切り替わります。カード上部で、情報画面の言語を設定できます（システムに従う場合はタイムゾーンで決まります）。

ホストのモニターで ← → または数字キー 1～6 でテンプレートを切り替えます（1 ホスト概要、2 システム、3 フォトフレーム、4 動画、5 天気、6 時計）。↑ ↓ またはスペースで写真を切り替えます（動画ページでは動画を切り替えます）。情報画面に切り替えると、下部にこれらのキーのヒントが出ます。

各テンプレートの下に、それぞれのオプションがあります。

• 時計：デジタルまたはアナログ。デジタルではフォント（既定、等幅、7 セグメント）を選べます。
• フォトフレーム：間隔（スライダー。5 秒から 1 時間）、切り替え（フェード、左右スライド、ブロック、なし）、写真を全面に拡大するか全体を表示するか。カードに画面の出力方式が表示されます。出力：表示 VM、リフレッシュに合わせてページ切り替えのときは、左右スライドでもティアリングが起きません。フリップなしやホストが直接描画のときは、動く画面でティアリングが起きることがあり、その場合はブロックとフェードのほうがきれいです。
• 天気：現在の天気に合わせて画面全体の空を描画し、アニメーション（雨、雪、雲、星）を付けます。アニメはオフにできます。
• 動画：動画フォルダー…にある動画（MP4、MKV、WebM、MOV。H.264、HEVC（10 ビットを含む）、VP9、AV1）を名前順に繰り返し再生します。表示用仮想マシンが内蔵 GPU でハードウェアデコードするので、CPU はほとんど使いません。オプションで全体表示（黒帯あり）か全面表示か、時計を表示するかを選べます。今のところ音は出ません。動画カードの下のプレーヤー…で小さなプレーヤーが開きます。動画の選択、シーク、再生/一時停止、前へ/次へができます。再生、シーク、動画の選択をすると情報画面が動画ページに切り替わり、画面がほかのページに切り替わると自動で一時停止し、戻ると続きから再生します。再生できない動画はスキップされ、画面にその理由が表示されます。

天気…：地域を検索して選びます（地域が未設定のときは天気ウィジェットは空です）。選ぶと、ホスト概要とフォトフレームに天気と数日先の予報が表示されます。予報は既定でその地域の国の気象機関のモデル（中国は中国気象局、Open-Meteo 経由）から取得し、予報で手動で別のものに切り替えて比較できます。Open-Meteo の無料 API は非商用利用のみ可能です。企業は Open-Meteo API キーに自分のキーを入力してください。

写真フォルダー…と動画フォルダー…：フォトフレームの写真は、既定ではアルバム受信箱の写真ライブラリーから取得します。データセットやディレクトリを指定することもできます（写真は JPEG、PNG、WebP に対応。HEIC は今のところ非対応）。各ディレクトリの横の「開く」から、ファイルブラウザーで閲覧、アップロード、削除ができます。まだディレクトリがない場合は「<プール>/photos を作成」（動画は <プール>/videos）を押すと、keel が作ります。動画フォルダーを設定すると、表示用仮想マシンは 512 MB 余分にメモリを使います（表示用仮想マシンは自動で 1 回再起動します）。動画を再生できるのは、表示用仮想マシンがモニターを引き継いでいる（内蔵 GPU がそちらにパススルーされている）ときだけです。

同じダイアログで「Wikimedia Commons の風景写真も表示」にチェックを入れると、keel は自由ライセンスの厳選風景写真を約 100 枚（約 70 MB）一度だけダウンロードして、ローカルの写真と一緒にスライドショーにします。作者とライセンスは写真の下に表示されます。チェックを入れなければ、ネットには接続しません。

5. 1.0 でまだ対応していないこと

• Web の VNC は同時に 1 人しか見られません。複数人で同時に見るには、RDP かシリアルコンソールを使ってください。
• USB リダイレクトの取り外すは記録するだけで強制的には外しません（§2.3）。UHCI の古い OS ではリダイレクトできません。
• 情報画面の動画には、今のところ音がありません。