設定

［Settings］の設定は、次の3つに分かれます。設定の各ページの左の一覧も、この3つに分けて並べます。

• 全体：［General］。どのマシン・どのプリセットでも同じ値です。
• プリセット：［Appearance］、［Terminal］、［SFTP］、［Keyboard shortcuts］、［Key bar］、［Notifications］、［Vault］。一覧の上の［編集するプリセット］で選んだプリセットを編集します。
• マシン：［Machines］。Syncで同期しているマシンごとに、使うプリセットとポートを選びます。

どの設定も~/.ssh/sshcに保存され、Syncでほかのマシンへ同期されます。［Open connections］は設定ではなく、このマシンで開いている接続をまとめて閉じるページです。

［Menu］は、各ページを名前と一言の説明で並べ、設定の各ページもここから直接開けます。接続先ごとの項目は、［Connections］の［表示とターミナル］タブにあります。

設定がどこまで効くかは、ページの名前の横の札で分かります。

札	効く範囲
［全マシン共通］	すべてのマシン。プリセットに関係なく同じ値
プリセットの名前（例: プリセット: 標準）	そのプリセットを使うマシン
［マシンごと］	マシンごとに別の値（Machinesの一覧）
［このマシンだけ］	このマシンだけ。同期しない

ターミナルの「…」にある切り替えも、同じ札の見出しの下に並びます。接続先の［表示とターミナル］で空欄にした項目は、そのマシンが使うプリセットの値に従います。

プリセット

スマホとPCで文字の大きさを変えたいときのように、マシンごとに違う値を使うにはプリセットを作ります。プリセットには、外観、ターミナル、SFTPの転送、ショートカット、スマホのキーバー、通知音、Vaultの自動ロック、画面を消さない設定、タッチの扱いが入ります。左ナビや接続先の一覧の幅、Homeの表示形式、SFTPの左右の分割は、プリセットに入れず、ブラウザごとに覚えます。

• 最初からある［標準］は、プリセットを選んでいないマシンが使うプリセットです。
• このマシンが使っているプリセットには［このマシンで使用中］と出ます。ほかのプリセットを開いているときは、［このマシンで使う］を押すと、このマシンはそのプリセットを使います。ほかのマシンが使うプリセットは［Machines］で選べます。
• 「…」の［新しいプリセット］は、開いているプリセットの値を写して作ります。［名前を変更］と［削除］は［標準］には使えません。プリセットを削除すると、そのプリセットを使っていたマシンは［標準］に戻ります。プリセットは［標準］を含めて16個まで作れます。
• プリセットの値を変えると、そのプリセットを使うマシンには、変更が同期されたときに効きます。

スマホでは、設定の各ページの上でプリセットを選びます。

General

どのマシン・どのプリセットでも同じ値の設定です。変えるとすぐに保存します。

• ［表示言語］：［ブラウザに合わせる］、English、日本語。［Menu］→［Preferences］でも切り替えられます
• ターミナルの接続：［接続が切れたときの再接続］、［接続のログ］、OSC 52（クリップボードへの書き込みを許可）
• セッションのログ：［セッションのログをファイルに保存する］、［保存しない接続先］（セッションのログ）
• SFTPの転送：［完了した項目］を一覧から消すまでの時間、［通信が切れたとき］に［自動で再開する］か、［再接続の上限］
• 背景画像：［ライブラリの容量］（1〜1024 MiB、既定16 MiB）

Machines

Syncで同期しているマシンを、このマシンを先頭にして並べます。マシンは、そのマシンで初めてこのバージョンのsshcエンジンが起動したときに一覧に加わります。

• ［使うプリセット］：そのマシンが使うプリセットです。変えると、そのマシンには変更が同期されたときに効きます。
• ［ポート］：そのマシンのsshcエンジンが待ち受けるポートです。次の起動から効きます。
• ［最後の起動］：そのマシンでsshcエンジンが最後に起動した時刻です。
• 「…」：［名前を変更］、［ログの保存先を変更…］、［一覧から外す］。［ログの保存先を変更…］は、そのマシンがセッションのログを置くフォルダを変えます。空にすると、OSの決まった場所に戻ります。使わなくなったマシンを一覧から外せます。このマシンは外せません。外したマシンでも、sshcエンジンをもう一度起動すると一覧に戻ります。

デスクトップ版は、ブックマークとインストールしたWebアプリで同じURLを使えるよう、マシンごとの固定ポートを使用します。

• ［ポート］が空欄なら、最初は127.0.0.1:54447を試し、使用中なら選んだ空きポートをそのマシンに保存します。
• Web UI自体は固定URLから開けますが、初めて使うブラウザを登録するときだけsshcコマンドが一度限りの登録URLを開きます。
• ポートを変更した後は、新しいURLでブラウザを登録し直してください。
• Android版のポートは変えられません。アプリの画面はポートごとに保存内容を分けるので、ポートを変えるとブラウザの登録が消えるためです。

外観

［Settings］→［Appearance］では、アプリ全体のテーマ、さし色、セッションが無いときの背景、動きを減らすかを、編集中のプリセットに設定します。

• テーマ：システムに合わせる／ライト／ホワイトブルー／ホワイトパープル／ダーク／ダークブルー／ダークパープル。ライトとダークの灰色は色みを持ちません。ホワイトブルーとダークブルーは灰色を青に寄せ、ホワイトパープルは紫に寄せます。ホワイトパープルは、さし色が薄紫のときはそれを少し濃い紫にします。ダークパープルは地が一段明るい無彩色で、さし色が薄紫のときはそれをテーマの紫にし、ターミナルの選択とカーソルも紫にします
• さし色：薄紫／青／水色／ピンク／モノクロ／カスタム。選んでいる項目、ボタン、フォーカスしているターミナルの枠に使います。カスタムでは、カラーピッカーか色コード（#rrggbb）で好きな色を1つ選べます。選んだ色はライトとダークの両方で使います。その配色の背景と見分けにくい色を選ぶと、画面に知らせが出ます
• セッションが無いときの背景：なし／ネットワーク／等高線／地球儀／水槽。開いているセッションが無いときのターミナルに出す、動く絵です（Terminal）。既定はネットワークです
• 動きを減らす：システムに合わせる／オン／オフ。オンにすると、セッションが無いときの背景の絵を止め、パネルの開閉や画面の切り替えのアニメーションを省きます。システムに合わせるでは、OSの「動きを減らす」設定に従います

設定の各ページの左には、設定のページの一覧があり、ほかのページへ移れます。

テーマ、さし色、セッションが無いときの背景、動きを減らすかはプリセットの設定で、ほかのマシンへ同期されます。テーマは、次に開いたときに最初の画面からその色で出せるよう、ブラウザにも写しを置きます。未読の通知（橙）、接続済み（緑）、エラー（赤）と見分けがつくよう、用意した色にこの3色は入れていません。

表示言語（日本語／English）は［General］か、［Menu］→［Preferences］で切り替えます。

Terminalのカラーパレット、フォント、背景、色合いは［Settings］→［Terminal］で設定します。

Vaultの作成／ロック解除画面でも、テーマと言語を切り替えられます。

Keyboard shortcuts

［Menu］→［Keyboard shortcuts］で、コマンド検索、Terminal内検索、コピー・貼り付け、前後のプロンプトへの移動、文字の大きさ（大きく・小さく・戻す）、クイックコマンド、新しいセッション、セッションを閉じる、前後のセッションへの切り替え、分割表示の前後のペインへの移動、右に分割・下に分割、ナビゲーションの開閉、Home・SFTPへの移動を設定できます。

割り当て欄を押して、Ctrl・Alt・Win（Macは⌘）を含む組み合わせ、またはファンクションキーを入力します。Escで中止、Tabで次の項目に移動します。

重複する割り当ては保存できません。［解除］で無効化できます。

操作	既定のキー
前後のセッションへの切り替え	Alt+PageDown／Alt+PageUp
文字の大きさ（Macでは⌘）	Ctrl+=（JISキーボードではCtrl+;も）で大きく、Ctrl+-で小さく、Ctrl+0で設定の大きさに戻す
前後のプロンプトへの移動	Ctrl+Shift+↑／↓（Macでは⌘↑／↓）
新しいセッション、セッションを閉じる、ペインへの移動、分割、クイックコマンド、ナビゲーションの開閉	なし

既定のキーが無い操作があるのは、ほかのターミナルが使うキー（Ctrl+Shift+T、Ctrl+Shift+W、Altと矢印）を、ブラウザかターミナルの中のプログラムが先に使うためです。

• 文字の大きさは、ピンチと同じく、そのターミナルだけに効き、保存しません。
• セッションを閉じるときは、×と同じく確認を出します。
• 前後のプロンプトへの移動は、シェルがOSC 133（シェル統合）でプロンプトの位置を知らせているときに、長い出力をさかのぼってプロンプトの行まで移ります。モバイルではターミナルの「…」から選べます。
• コピー・貼り付け・Terminal内検索・プロンプトへの移動・文字の大きさ・クイックコマンドはTerminal内で有効です。貼り付けの確認・編集は通常と同じです。

［キーの割り当て］の選択欄で、名前を付けた割り当てを切り替えます。次のように扱われます。

• 選択欄の横の「…」で、複製・名前の変更・削除ができ、［標準の割り当てに戻す］で全項目を戻せます。
• キーの割り当てはSyncで同期され、すべてのマシンで共通です。どれを使うかは、設定のプリセットごとに選びます。
• 標準の割り当てを編集すると、自分用の割り当てが新しく作成されます。
• sshcの更新で割り当てられる操作が増えても、作った割り当てはそのまま使えます。増えた操作はキー無しで入るので、使うなら割り当ててください。
• PCでナビゲーションを開閉すると、閉じたあいだは左に細い列だけが残り、そこの［ナビゲーションを開く］で戻せます。開閉はブラウザごとに覚えます。
• 選択中の割り当てが削除されると、標準の割り当てに戻ります。
• 同時編集で保存できなかった場合は、再読み込みしてください。

ブラウザやOSに予約されているキーは、そちらが優先される場合があります。ブラウザ標準の貼り付け操作は引き続き使えます。

貼り付けの初期設定はCtrl+V（Macでは⌘V）です。Ctrl+Shift+Vも使えます。

Key bar

［Menu］→［Key bar］で、スマホのターミナルの下に出すキーバーの並びを決めます。

• ［キーの並び］のキーを押して選び、［前へ］［後ろへ］で動かし、［「…」へ］で「…」の中へ、［いつも出す段へ］で戻し、［外す］で外します。
• ［置けるキー］のキーを押すと、選んだキーの後ろに入ります（選んでいなければ、いつも出す段の最後）。

置けるキーは、入力の切り替え（キーボードの印）・Ctrl・Alt・Esc・Tab・Enter、⌫・Del・Ins・矢印・Home・End・PgUp・PgDn、^C・^D・^Z・^L・^R・^A・^E、F1〜F12、記号です。

［自作のキーを作る］で、決まった文字やコマンドを1回のタップで送るキーを作れます。キーに出す文字（8文字まで）と送る内容を入れ、［送ったあとEnterを押す］を選ぶと、コマンドをそのまま実行します。送る内容は打ったのと同じように送り、改行はEnterとして送ります。Tabと改行のほかの制御文字は送れません。作ったキーは、選んで［編集］で直せます。

［キーの並び］の選択欄で、名前を付けた並びを切り替えます。次のように扱われます。

• 選択欄の横の「…」で、複製・名前の変更・削除ができ、［標準の並びに戻す］で標準の並びに戻せます。
• キーの並びはSyncで同期され、すべてのマシンで共通です。どれを使うかは、設定のプリセットごとに選びます。
• 標準の並びを変えると、自分用の並びが新しく作成されます。
• 同期しているマシンは、自分用の並びを使う前にすべて更新してください。古いsshcが設定を保存し直すと、自分用の並びが消えます。

Vault

［Settings］→［Vault］では、Vaultの自動ロックとマスターパスワードを設定します。自動ロックまでの時間はプリセットの設定です。マスターパスワードはマシンごとのVaultのもので、同期されません。

自動ロック

既定では、利用者の操作によってVault内のシークレットを最後に読み書きしてから12時間が過ぎると、Vaultをロックします。1〜999の数値を入力し、単位として分または時間を選択できます。Vaultの状態表示、Terminalへの出力、自動同期によるシークレットの参照では、この時間は延長されません。

「自動ロックしない」を選ぶと、手動でロックするかsshcを再起動するまでロック解除状態が続きます。自分で管理しているマシンでのみ使用してください。

パスワードなしのVaultには自動ロックも手動ロックも適用されません。sshcの起動時に自動でロックが解除され、この設定は適用されません。画面では自動ロックの欄を変更できず、その理由を表示します。パスワード変更時の「現在のマスターパスワード」欄も表示されません。パスワードを設定すると、自動ロック、「現在のマスターパスワード」欄、ロック操作が再び利用できます。

Terminal

［Settings］→［Terminal］は、編集中のプリセットのターミナルの設定です。スマホでは、すべてを節ごとに並べます。

タブ	内容
［表示］	配色・フォント・背景
［接続］	上限
［操作］	開始フォルダ・ローカルシェル・クリップボードとキーボード・タッチ操作とそのときのリンクの下線

接続が切れたときの再接続、接続のログ、OSC 52、セッションのログは［General］にあります。

設定のどのページも［保存］ボタンは無く、保存したことは、変えた欄の下に短く表示します。選択肢とチェックボックスは変えるとすぐに保存し、数値と開始フォルダは入力後にフォーカスを移すかEnterを押すと保存します。

• 最大セッション数（1〜200、既定50）
• 再接続時の出力復元に使うバッファ（画面上の［上限］の［再生バッファ］、16 KiB〜4 MiB、既定256 KiB）
• ブラウザのスクロールバック（1,000〜100,000行、既定5,000行）
• 裏に残すターミナル（1〜99、既定3）。最近表示したターミナルを、表示から外れても裏に残し、戻ったときにスクロールバックをすべて見せます。1つごとにスクロールバックをブラウザのメモリに持ちます（5,000行で数MB）
• フォントサイズ、配色、フォント、背景、色合い
• 選択時のコピー、右クリックでの貼り付け
• JISキーボードの円記号キーをバックスラッシュとして送信
• スマホの入力欄でEnterを押したときに送信するか（既定は改行）
• 合字（リガチャ）を使うか（既定は使わない）
• プログラムが出すVT320のステータス行を表示するか（既定は表示する。表示しないときは、ステータス行への出力も画面に出さない）
• シェル統合（OSC 133）のコマンドの印、さかのぼっている出力のコマンドを上に表示するか、スクロールバーのコマンドの印（どれも既定は表示する）
• ローカルシェルで動いているコマンドの名前を、ペイン名の前に出すか（既定は出す。LinuxとmacOSで動くsshcエンジンだけ。タイトルと通知）

［再生バッファ］は、ブラウザが再接続したときに復元する直前の出力を、sshcエンジンのメモリへ保持します。ブラウザのスクロールバックは、Terminalの画面でさかのぼれる行数です。用途と上限は別で、どちらもディスクには書き込みません。出力が画面の描画より速く流れ続け、ブラウザが［再生バッファ］の大きさを超えて遅れたときは、残っていない部分を飛ばして続け、そのことを画面に表示します。

［再生バッファ］に残っていない古い出力が要るとき（裏に残す数を超えて戻ったターミナル、新しく開いたタブなど）は、sshcエンジンが覚えている画面を先に表示してから、残っている出力を復元します。Claude Codeのように一度描いた画面の変わった所だけを書き直すプログラムでも、前に描いた内容は欠けません。［再生バッファ］より前の行は、スクロールしてもさかのぼれません。

文字コードは、接続先ごとに上書きできます。OSC 8リンクやKitty keyboard protocolの自動検出に対応しています。

描画には既定でWebGLを使います。利用できない環境や背景画像を使用する場合はDOM描画へ自動的に切り替わります。文字が二重に見える、または残像が残るGPU・ブラウザ環境では「WebGL描画を使用する」を無効にして、常にDOM描画を使えます。

「合字（リガチャ）を使う」を有効にすると、->、!=、===などを1つの記号のように表示します（既定は無効）。字体がJetBrains Monoのときに効きます。合字も元の文字と同じマス数を使うので、カーソルや選択の位置はずれません。カーソルや選択の端が合字の中にあるときは、1文字ずつ表示します。

背景画像の「変更」を押すと、検索と選択をまとめた画像ライブラリが開きます。通常の設定画面には選択中の画像だけを表示し、名前変更と削除は各画像の … にまとめています。画像は圧縮・変換せず、アップロードしたバイト列のまま保存します。

ライブラリの容量は［General］で設定します（既定16 MiB、1〜1024 MiB）。容量を下げても既存画像は削除・圧縮しません。大きな画像や多数の画像は、ローカル容量だけでなく暗号化同期の転送量とメモリ使用量も増やします。

名前を変更すると拡張子は実際の画像形式から決まり、プリセットと接続別設定の参照も同時に更新されます。同名の画像は上書きしません。画像を削除すると、その画像を使っている設定の参照も同時に解除されます。

ローカルシェル

OS上で利用できる既定のシェルプロファイルと、開始フォルダを、［Settings］→［Terminal］の［操作］で選べます。どちらもプリセットの設定です。WindowsではPowerShell系、Unix系ではzsh、fish、bashなど、検出された候補が表示されます。SFTPのローカルフォルダから［ここでターミナルを開く］を選ぶと、同じ既定プロファイルを使い、表示中のフォルダを開始場所にします。［新しいセッション］に並ぶローカルシェルは1つで、ここで選んだシェルを、ここで設定した開始フォルダで開きます。シェルを選んでいなければ、システムのログインシェルを開きます。

SFTP

［Settings］→［SFTP］では、編集中のプリセットに、SFTPの転送の速度上限、同時実行数、分割転送、転送の除外を設定します。SFTP画面の転送マネージャーにある［転送設定］からも、このページへ移動できます。そのプリセットを使うマシンでは、ブラウザとCLIの転送に同じ設定が効きます。完了した項目の自動消去と、通信が切れた後の自動再開は［General］にあります。詳細は転送マネージャーを参照してください。

通知

ブラウザの通知権限が要求されるのは、利用者が通知を有効にしたときだけです。ターミナル内で動くプログラムがOSC 9／99／777で通知を送ったときの通知音と音量を、編集中のプリセットに設定し、通知をテストできます。詳細はタイトルと通知を参照してください。

保存場所

設定は~/.ssh/sshcに保存され、バックアップとSyncの対象になります。

• 全体の設定とプリセット：~/.ssh/sshcのメタデータ（metadata.json）。接続先ごとのsshc設定も同じファイルです
• マシンごとの設定（名前・使うプリセット・ポート）：~/.ssh/sshc/machines/<マシンのID>.json
• マシンごとの画面の状態（リモートセッションで選んでいるsshcエンジン、SFTPのタブと分割、転送マネージャーの表示、ワークスペースの折りたたみと非表示のワークスペースを表示するかどうか、転送の処理を止めているかどうか）：~/.ssh/sshc/machines/<マシンのID>.state.json

どのマシンかを見分ける~/.ssh/sshc/machine-idだけは同期しません。ブラウザには、テーマと表示言語の写し（次に開いたときに最初の画面をその色と言語で出すため）、ブラウザの登録情報、更新の結果を表示したかどうかだけを保存します。

ブラウザには登録トークンを保存しますが、~/.sshや同期スナップショットには含めません。sshcエンジン側がディスクへ保存するのは、照合に使う一方向のハッシュと発行・最終使用の時刻、sshcエンジンのポート番号だけです。Vault内のシークレットとS3の認証情報は、平文の設定ファイルへ保存しません。

対象	期限と上限
登録トークン	sshcエンジンの再起動後に再ログインするたびに新しいものへ差し替わり、最後に使ってから30日で失効する
登録の数	16件まで。上限に達すると、最後に使ってから最も時間の経った登録から削除する
ブラウザのセッション	12時間使わないか発行から7日で期限切れになる。登録が有効なら次の読み込みで自動的に再ログインする

sshcエンジンのポートが変わった場合や、差し替え前の古いトークンが提示された場合は登録が失効するため、sshc（またはsshc open）で新しいURLを開いて登録し直します。

［Menu］→［Preferences］の［このブラウザからサインアウト］は、セッションと登録の両方を削除します。Vaultがロックされているあいだは、ロック画面の同じボタンからマスターパスワードなしでサインアウトできます。その後に開くにはsshc（またはsshc open）のURLが必要です。