VNTerm ドキュメント

インストールからデバイス間のホスト同期までの簡潔なガイド。

アプリのインストール

ダウンロードページからお使いの OS 用のインストーラーをダウンロードしてください。

macOS (11+, Apple Silicon & Intel)

1. VNTerm_<バージョン>_aarch64.dmg ファイルを開き、VNTerm を Applications フォルダにドラッグします。
2. 初回起動時に macOS が開発元を確認できないと表示した場合は、アプリを右クリック → Open を選択してください。

Ubuntu / Debian (22.04+, x86_64)

sudo apt install ./vnterm_*_amd64.deb

またはインストール不要の AppImage 版を使用：

chmod +x VNTerm_*_amd64.AppImage && ./VNTerm_*_amd64.AppImage

Windows 10/11 (x64)

VNTerm_*_x64-setup.exe（GPO/Intune での展開には VNTerm_*_x64_en-US.msi）を実行します。SmartScreen の警告が表示された場合は、More info → Run anyway を選択してください。

アカウントを作成

アカウントはデバイス間で vault を同期するために使用します。アプリ内または登録ページから登録できます。

• マスターパスワード（8 文字以上）はお使いのデバイス上で vault 全体を暗号化します。サーバーに送信されることはなく、当社はそれを復元することができません。
• 登録後、アプリにリカバリーキーが一度だけ表示されます — 必ず保存してください（リカバリーキーを参照）。
• 別のデバイスで同じアカウントにサインインすると、すべてのホスト、キー、スニペットを受け取れます。デバイス一覧と取り消しボタンはアカウントページにあります。

ホストを追加

1. Hosts セクションで New host をクリックします。
2. Address（IP またはホスト名）、Label を入力し、必要に応じて Parent Group と Tags を選択します。
3. SSH ポート（デフォルト 22）、Username と Password を設定するか、Keychain からキー／Identity を割り当てます。
4. ホストカードをダブルクリックして接続します。初回接続時にはサーバーのフィンガープリントが表示されるので確認してください。フィンガープリントは Known Hosts に保存され、変更された場合は警告が表示されます。

既存の設定がありますか？New host → Import from ~/.ssh/config を選択すると一括でインポートできます。ホストの詳細設定では、エージェント転送、起動スニペット、ホストチェーン（ジャンプホスト）、SOCKS5/HTTP プロキシ、個別のターミナルテーマを設定できます。

Keychain & Identity

• キーを生成：Keychain → Generate key で ed25519（推奨）、ECDSA、RSA のいずれかを選び、必要に応じてパスフレーズを設定します。
• キーをインポート：既存の秘密鍵ファイル（OpenSSH / PEM）を貼り付けるか選択します。
• サーバーの ~/.ssh/authorized_keys に公開鍵を追加し、Credentials セクションでキーをホストに割り当てます。
• Identity はユーザー名とパスワード／キーを 1 つのセットにまとめ、複数のホストで再利用できます。パスワードを一度変更するだけで、その Identity を使うすべてのホストに反映されます。

Quick connect: SSH, Mosh, Telnet

Hosts ページの検索ボックスにアドレスを入力し、Enter または Connect を押します。構文：

[ssh|mosh|telnet] [user@]host[:port]
[email protected]
mosh [email protected]
telnet 10.0.0.5:23
[2001:db8::1]:2222

プロトコルを指定しない場合、アプリが SSH、Mosh、Telnet のいずれかを選ぶよう求め、必要に応じて認証情報を尋ねます。

• SSH — デフォルトはポート 22。パスワード、キー、エージェント認証に対応しています。
• Mosh — システムの mosh クライアントをタブ内で実行し、ネットワークが不安定なときや Wi-Fi を切り替えたときもセッションを維持します。お使いのマシンに mosh、サーバーに mosh-server のインストールが必要です。
• Telnet — デフォルトはポート 23。古いネットワーク機器向けです。Telnet は暗号化されないため、信頼できるネットワーク内でのみ使用してください。

SFTP

SFTP タブを開きます。左ペインはお使いのマシン、右ペインは保存済みのホストです。フォルダの閲覧、右クリックメニューからのアップロード／ダウンロード、フォルダの作成、名前変更、削除、権限変更（chmod）が行えます。⌘/Ctrl を押しながらクリックすると複数のファイルを選択できます。

Port forwarding

Port Forwarding セクションではルールを vault と一緒に保存し、各ルールを個別にオン／オフできます。

データベース

Databases では MySQL、MariaDB、PostgreSQL、SQLite に接続できます。接続情報（パスワードを含む）はホストと同じくエンドツーエンドで暗号化され、vault に保存されます。SSH ホスト経由で接続でホストを選ぶと、ポートフォワーディングのルールなしで SSH トンネルを通ります。デスクトップとスマートフォンの両方で利用できます。

• 左のツリー — フォルダ → 接続 → データベース → テーブル、ビュー、関数、イベント、クエリ。それぞれタブで開き、右クリック（スマートフォンでは長押し）でメニューを表示します。
• データ — セルをクリックして編集し、ポインターを外すと保存されます。行番号で行を選択し、⌘/Ctrl+C、⌘/Ctrl+V で新しい行を追加できます。フィルタ、並べ替え、CSV / JSON / SQL のエクスポート、CSV のインポートに対応。
• テーブルデザイナー — フィールド、インデックス、外部キー、トリガー、チェック制約、オプション。保存前に SQL をプレビューできます。
• 読み取り専用 — クエリは読み取り専用で始まります。書き込むにはスイッチをオフにしてください。

Serial

Hosts ページ → Serial：ポート（例：/dev/ttyUSB0、COM3）とボーレート（300 – 921600、デフォルト 9600）を選択します。Advanced セクションでデータビット、パリティ、ストップビットを設定できます。Linux では、シリアルポートを開くためにアカウントが dialout グループに属している必要があります。

Remote Desktop

デスクトップアプリのタブで Windows マシンを直接操作できます。Windows 側でのインストールや設定は不要で、リモートデスクトップが有効（Settings → System → Remote Desktop）かつポート 3389 に届けば十分です。

1. New host → Remote Desktop を選び、アドレス、ユーザー名（必要ならドメイン付き、例: CORP\admin）、パスワードを入力します。
2. ホストをダブルクリックすると Windows の画面が開きます。解像度はタブの大きさに合わせて変わります。
3. タブのツールバー: 画質（回線速度に応じた自動、または固定）、GFX（RDP 8 以降のグラフィックス、既定でオン）、Ctrl + Alt + Del ボタン、画面分割、フローティングウィンドウ、共有。

• テキストのコピー / 貼り付けはお使いのコンピュータと Windows の間で双方向に使えます。
• ショートカットは Windows に送られます。Mac では ⌘ + C / V / X / Z / A / F / S が Ctrl に、その他の ⌘ の組み合わせは Windows キーになります。⌘ W は引き続きタブを閉じます。
• 回線が遅いとき: 自動モードが画質を下げて操作を軽快に保ち、回線が回復すると元に戻します。

タブ & タブグループ

• 各セッションは 1 つのタブです。同じホストに複数のセッションを開くと、Onik (1)、Onik (2) のように番号が付きます。
• タブを別のタブにドラッグ＆ドロップするとグループにまとめられます。グループは解除することも、まとめて閉じることもできます。
• タブバーの + ボタンでクイック接続またはローカルターミナルを開きます。

フローティングウィンドウ

タブを右クリック → Float on top で、ターミナル（またはリモートデスクトップ画面）を常に最前面の小さなウィンドウに切り出せます。別の作業中にログやビルドを見守るのに便利です。フローティングウィンドウを閉じるとセッションはタブに戻ります。

Multiplayer

タブを右クリック → Multiplayer で共有リンクを作成します。受け取った人はアカウント不要でブラウザで開けます。内容はエンドツーエンド暗号化され、鍵はリンクの # の後ろにあるためサーバーは読めません。閲覧者の入力（またはリモートデスクトップの操作）の可否を切り替え、いつでも共有を停止できます。

テーマ & 外観

Settings で、デフォルトのターミナルテーマ、フォントサイズ、表示言語を選択します。各ホストには個別のテーマを設定できます（ホストの編集パネル内）。テーマを設定していないホストはアカウントのデフォルトテーマを使用します。これらの設定は vault と一緒に同期されます。

キーボードショートカット

同期 & エンドツーエンド暗号化

VNTerm は保管庫をデバイス上で暗号化します。サーバーは暗号化されたデータだけを保存し、マスターパスワードを受け取ることはありません。Google / Apple / Telegram のクイックサインインがオンの間（既定）、新しいデバイスで保管庫を開けるよう、サーバーは保管庫キーの暗号化されたコピーも保管します。オフにするにはアプリの 設定 → アカウント へ。

• マスターパスワード → PBKDF2-SHA256（600 000 回）→ master key。そこから auth key（サインイン時にサーバーへ送信され、サーバーは Argon2id で保存）と enc key（お使いのデバイス上にのみ存在）が導出されます。
• 各ホスト、キー、スニペットなどは、同期前にランダムな vault key で AES-256-GCM 暗号化されます。vault key は enc key でラップされます。
• すべての API リクエストは、HTTPS の内側でさらにもう一層暗号化されます（X25519 + AES-256-GCM、エンドポイントと時刻に紐付け、リプレイ攻撃を防止）。
• リビジョンベースの同期：2 台のデバイスで同じアイテムを同時に編集すると、黙って上書きするのではなく競合として検出されます。

リカバリーキー

リカバリーキーは、マスターパスワードを忘れたときに vault のデータを保持する唯一の方法です。

1. キー（XXXX-XXXX-… 形式）は、パスワードマネージャーや印刷物など安全な場所に保管してください。
2. パスワードを忘れた場合：パスワードをお忘れの方にアクセスし、メールで届いた 6 桁のコードを入力して新しいパスワードを設定し、リカバリーキーを貼り付けます — vault はそのまま保持されます。
3. リカバリーキーがない場合：古い vault は削除され、空の vault と新しいリカバリーキーが発行されます。パスワードのリセット後、すべてのデバイスがサインアウトされます。

Team vault

1. 上部バーの Vaults ▾ ボタン → Add vault: 名前を付け、メールでメンバーを招待します。
2. ホストのメニュー → Move to vault で、ホスト（と付随する鍵 / identity）をチーム保管庫に移します。
3. Vaults ▾ メニューで保管庫をクリックすると表示 / 非表示を切り替え、only でその保管庫だけを表示します。この設定は現在のデバイスにのみ適用されます。
4. Manage vaults（Settings → Invite People）にメンバーと保留中の招待が表示されます。削除するとすぐにアクセス権が取り消されます。

新しいメンバーはアプリを一度開いて鍵ペアを作成します。すると鍵を持つメンバーが自動で保管庫の鍵を封印して渡します。

プランとお支払い

料金ページでプランを確認・購入できます。カード（Stripe）または PayPal で、月払いか年払い。割引コードも使えます。前払い制で自動で引き落とされることはなく、期限前にお知らせメールが届き、アカウントページで更新できます。

• 支払いの数秒後（またはアプリに戻ったとき）にアプリで機能が解放されます。
• Team / Business プランはシート単位で、チーム保管庫のメンバーはプランの機能を使えます。
• プランが終わってもデータは失われません。保管庫はすべてのデバイスに取得でき、プランの機能だけが再びロックされます。

ほかにご質問がありますか？バグを報告するか、機能をリクエストしてください。