ホストとグループ
各項目・スイッチ・設定の働きです。このページには 99 個の項目があります。アプリで各ラベルの横にある ⓘ と同じ文章です。デスクトップではポインターを合わせるかクリックし(または項目内で F1 キーを押し)、スマートフォンではタップします。
各名前の下の行は、コードで使われている ID と、片方のアプリにしかない場合はその旨を示します。
ホスト:基本
Section titled “ホスト:基本”場所: ホスト › 新しいホスト、またはホストの編集.
host.label
一覧に表示されるこのホストの名前です。自分用の名前で、サーバーに送信されることも接続に使われることもありません。
- 例: web-01(本番)
- 注意: 必須。256文字以内。
host.address
サーバーの場所です。ホスト名、IPv4アドレス、IPv6アドレスのいずれかを入力します。ここにはアドレスだけを入力します。ポートとユーザー名には専用のフィールドがあるため、user@hostやhost:22は受け付けません。
- 例: web.example.com、10.0.0.12、2001:db8::1
host.group
このホストが入っているフォルダーです。ホストは自身で設定していない項目を、まずグループから、次にその上位のグループから、最後に設定から引き継ぎます。
- 既定値: グループなし。
- 注意: ホストを別のグループに移動すると、ポート、ユーザー名、鍵、ジャンプホストなど、継承しているすべての値が変わります。
host.tags
ホストの検索や絞り込みに使う自由な言葉です(例: 「prod」「database」)。1つのホストに最大64個のタグを付けられ、タグ名は1~64文字です。
- 例: prod, eu-west, postgres
- 注意: モバイルでは、このフォームのタグの横にある×を押すと、確認のうえ、そのタグがすべてのホストから削除されます。
オペレーティングシステム
Section titled “オペレーティングシステム”host.os
このホストで動作しているシステムで、ホストにアイコンと名前として表示されます。「自動検出」のままにすると、Sternwayは接続時にSSHサーバーの挨拶メッセージと、ホストの読み取り専用の確認(os-releaseファイル、uname、ログインシェルの名前。ログインシェルはスニペットの組み込みの値に何を入れられるかも決めます)からシステムを読み取ります。これは専用のチャネルで行われ、ターミナルに入力されることはありません。Linuxとしか名乗らないルーターなど、読み取れないか誤って読み取られるホストでは、一覧からシステムを選んでください。選択した内容は保持され、検出結果で置き換えられることはありません。
- 既定値: 自動検出。
- 例: 素のFreeBSDのように応答するファイアウォールの場合: pfSenseを選択。
- 注意: 表示が変わるだけです。Sternwayの接続方法は変わりません。
host.notes
このホストについて覚えておきたいこと。メモはホストと一緒に保存され、接続には使われません。最大10,000文字。
- 注意: メモはホストの他の情報と同様に同期されるため、パスワードは書かないでください。
ホスト:ログイン
Section titled “ホスト:ログイン”場所: ホストまたはグループのエディター、アドレスの下.
SSHポート
Section titled “SSHポート”host.port
SSHサーバーが待ち受けるネットワークポート(1~65535)。サーバーが別のポートで設定されている場合にのみ変更してください。MoshとSFTPもこのポートを使います。Telnetには専用のポートがあります。
- 既定値: 22。
- 例: 2222
host.credentials · スマートフォンのみ
このホストのログイン方法です。「保存済みのアイデンティティを使用」では、キーチェーンのアイデンティティからユーザー名、パスワード、鍵を取得します。「直接設定」では、このホスト専用に入力できます。
- 既定値: 直接設定。
- 注意: 切り替えると、もう一方の選択肢の内容は破棄されます。アイデンティティを選ぶとここに入力したユーザー名、パスワード、鍵は削除され、「直接設定」を選ぶとアイデンティティとのリンクが解除されます。
host.username
サーバーにログインするアカウント。空欄にすると、接続時にアプリが確認します。
- 既定値: なし: 接続時に確認されます。
- 例: root、ubuntu、deploy
- 注意: このホストに保存済みのアイデンティティを選ぶと、ここに入力したユーザー名は置き換えられます。
host.password
そのアカウントのパスワードです。接続時に1回試されるので、入力を求められずに済みます。毎回入力を求めるようにする場合や、代わりに鍵でログインする場合は空欄にしてください。
- 既定値: なし。
- 注意: ホストと一緒にボールトに保存され同期されます。ただし、設定 › セキュリティ › 「鍵とアイデンティティを同期」がオフの場合は、このデバイスに保存されます。デスクトップでは、フィールドを空にすると「パスワードなし」を意味し、グループから与えられるパスワードもブロックします。再び継承するには「上書きを解除」を使います。
アイデンティティ
Section titled “アイデンティティ”host.identity
キーチェーンに保存されたログイン情報です。ユーザー名とパスワード、鍵、またはその両方を一度保存し、複数のホストで共有します。アイデンティティを変更すると、それを使うすべてのホストに反映されます。
- 既定値: なし。
- 注意: アイデンティティは全体として優先されます。アイデンティティを選んでいる間は、同じホストやグループで入力したユーザー名、パスワード、鍵は無視されます。
host.key
このホストがパスワードの代わりにログインに使う秘密鍵です。サーバーがすでにその公開鍵を信頼している必要があります(キーチェーン › ホストにインストールで設定できます)。Sternwayから提示されるのはこの鍵1つだけです。デスクトップでは、設定 › 接続とSSHで、コンピューター自身のSSHエージェントの鍵を追加できます。
- 既定値: なし。
- 注意: パスフレーズで保護された鍵は、使用時にパスフレーズを求めます。
個人用認証情報を使用
Section titled “個人用認証情報を使用”host.personalCredentials · デスクトップのみ
共有チームボールト内のホスト向け: チームがホストに保存した情報ではなく、個人用ボールトに保存した自分のユーザー名、パスワード、鍵でログインします。これにより、チームメイトはそれぞれ自分のアカウントを使います。
- 既定値: オフ。
- 注意: このホストに個人の認証情報が保存されていない場合は、接続時に入力を求められます。
ホスト:詳細設定
Section titled “ホスト:詳細設定”場所: ホストまたはグループのエディター › 詳細設定(デスクトップ)、フォームの下部のセクション(スマートフォン).
起動時のスニペット
Section titled “起動時のスニペット”host.startupSnippet · デスクトップのみ
準備ができたと判断され次第(起動時のコマンドを参照)、セッションに入力されてEnterが送られる保存済みのスニペットです。セッションが再接続するたびに再度入力されます。起動時のコマンドと両方設定されている場合はこちらが使われます。スニペットがその後削除された場合は起動時のコマンドが使われます。
- 既定値: なし。
- 注意: 自分で入力したのと同じようにカーソル位置に入力されるため、ターミナルとシェルの履歴に表示されます。再接続後にも再度実行されるため、繰り返しても安全なスニペットを使ってください。
起動時のコマンド
Section titled “起動時のコマンド”host.startupCommand
準備ができたと判断され次第、セッションに入力されてEnterが送られるコマンドです。シェル統合がプロンプトを報告した場合は最初のプロンプトで、そうでない場合は出力が0.5秒途絶えた後に入力されます。接続ごとに1回入力されるため、自動でも再接続ボタンでも、再接続のたびに再度入力されます(再接続では新しいシェルが起動するため)。特定のフォルダーに移動したり、tmuxにアタッチしたりするのに使います。最大4096文字。
- 既定値: なし。
- 例: cd /srv/app && tmux attach || tmux
- 注意: 別途実行されるのではなく、入力されます。ログインが遅い場合やTelnetのログインプロンプトでは、画面に表示中のものに入力される可能性があり、ターミナルとシェルの履歴にも表示されます。再接続後にも再度実行されるため、繰り返しても安全なコマンドを使ってください。パスワードは絶対に含めないでください。
host.proxy
一部の企業ネットワークで必要なように、直接ではなくプロキシサーバー経由でサーバーに接続します。SOCKS5、SOCKS4、HTTPプロキシに対応しています(HTTPプロキシにはCONNECTメソッドで単純なトンネルを開くよう要求するため、サーバーのポートに対してそれが許可されている必要があります)。ジャンプホストがある場合、プロキシが中継するのは最初のジャンプホストへの接続だけです。
- 既定値: なし(直接接続)。
- 注意: プロキシが設定されたホストではMoshを使えません。
プロキシホスト
Section titled “プロキシホスト”host.proxyHost
プロキシサーバーのアドレス(ホスト名またはIPアドレス)。
- 例: proxy.corp.example.com
プロキシポート
Section titled “プロキシポート”host.proxyPort
プロキシが待ち受けるポート(1~65535)。
- 既定値: プロキシの種類に関係なく1080が入力されます。これは一般的なSOCKSのポートなので、HTTPプロキシの場合は変更してください(多くは3128または8080)。
- 例: SOCKSは1080、HTTPは3128または8080
プロキシのユーザー名
Section titled “プロキシのユーザー名”host.proxyUsername
プロキシ自体が求めるユーザー名(求められる場合)。SOCKS4には実際のログインはなく、「ユーザーID」と呼ばれる名前が送られるだけで、ほとんどのSOCKS4プロキシはこれを無視します。サーバー上のアカウントではありません。
- 既定値: なし。
プロキシのパスワード
Section titled “プロキシのパスワード”host.proxyPassword
プロキシ自体が求めるパスワード。SOCKS4にはパスワードがないため、その場合このフィールドは非表示になります。
- 既定値: なし。
- 注意: HTTPプロキシには簡易的なエンコードだけで送られるため、プロキシまでの経路上の誰でも読めます。ホストのパスワードと同様に保存・同期されます。
ホストチェーン(ジャンプホスト)
Section titled “ホストチェーン(ジャンプホスト)”host.jumpHosts
接続先に直接到達できない場合に、途中で順に経由するサーバーです(sshではProxyJumpと呼ばれ、このようなサーバーはよく踏み台と呼ばれます)。アプリはまず最初のサーバーにそのホスト自身の保存済みログイン情報でログインし、そこを経由して次へトンネルし、順にこのホストまで到達します。最大8台で、それぞれ同じボールトの保存済みホストである必要があります。ジャンプホスト自身のプロキシは無視され、最初のジャンプホストへの接続にはこのホストのプロキシだけが使われます。最初のジャンプホスト自身のジャンプホストも経由します。
- 既定値: 直接接続、またはグループのチェーン。
- 例: bastion → このホスト
- 注意: 各ジャンプホストは次の接続先を把握できます。Moshはジャンプホスト経由では使えず、Telnetはジャンプホストを無視します。
host.env
リモートシェルの起動時に渡される名前付きの値です(LANGや、スクリプトが読み取る変数など)。名前には英字、数字、アンダースコアが使え、数字で始めることはできません。値は最大4096文字です。SSHセッションでのみ送信されます。設定がある最も近いレベルが全体として優先されます。ホストのリストはグループのリストを置き換え、統合はされません。
- 既定値: なし。
- 例: LANG = en_US.UTF-8
- 注意: ほとんどのサーバーは、SSHサーバー設定(sshd_config)のAcceptEnvに列挙された名前(多くはLANGとLC_*のみ)しか受け付けず、それ以外は通知なく破棄します。値は通常の設定として保存・同期されるため、機密情報は入れないでください。
接続タイムアウト(秒)
Section titled “接続タイムアウト(秒)”host.connectTimeout · デスクトップのみ
サーバーの応答と、その後のログインハンドシェイクを待つ秒数です。これを過ぎると中止します。遅い回線や遠距離の回線では大きくしてください。1~300。
- 既定値: 15秒(設定 › 接続とSSH)。
host.autoReconnect
セッションが予期せず切断されたとき、確認せずに再接続します。まず1、2、4、8、16秒待って5回すばやく試行し、その後はタブが開いている間1分ごとに試行します。ネットワークが変わったときやデバイスがスリープから復帰したときはすぐに試行します(「再試行をやめる」で終了)。このホストを経由する実行中のポート転送も再試行します(約5分間に最大10回、ネットワークが変わるとすぐに)。サーバーのホスト鍵が拒否された場合やログインをキャンセルした場合は、すぐに停止します。再び承認が必要になった転送は承認を待ちます。
- 既定値: オン(設定 › 接続とSSH)。
- 注意: 再接続では、今回のアプリ起動中に入力したパスワードで再度ログインします(スマートフォンでは、アプリがロックされるか、サインアウトするか、自動ロックの時間を超えてバックグラウンドにあるまで)。鍵のパスフレーズは、確認時に「記憶する」にチェックした場合のみ再利用されます。
キープアライブ間隔(秒)
Section titled “キープアライブ間隔(秒)”host.keepaliveInterval · デスクトップのみ
キープアライブは、接続に通信がない間に送る小さな「応答していますか?」というメッセージで、ルーターやファイアウォールに接続を切られないようにし、切れた回線を検出します。これはその送信間隔の秒数で、0にするとオフになります。0~3600。
- 既定値: 30秒(設定 › バックグラウンドとキープアライブ)。
キープアライブの最大欠落回数
Section titled “キープアライブの最大欠落回数”host.keepaliveCountMax · デスクトップのみ
接続が失われたと判断して閉じるまでに、連続して応答がなくてもよいキープアライブメッセージの数です。デフォルト値では約1分半です。1~100。
- 既定値: 3(設定 › バックグラウンドとキープアライブ)。
エージェント転送
Section titled “エージェント転送”host.agentForwarding
接続先のサーバーが、あなたの鍵を使ってさらに別のサーバーにログインできるようにします(例: サーバー上でGitHubからgit pull)。秘密鍵がこのデバイスの外に出ることはありません。「認証鍵」はサインインに使った鍵だけを、「すべての鍵」はこのホストとそのジャンプホストの鍵を提供します。サーバーは署名を求めることはできますが、鍵を読み取ることはできません。要求されるのはターミナルセッションのみで、SFTPやポートフォワーディングでは要求されません。パスワード、またはこのコンピューターのSSHエージェントの鍵でログインした場合、「認証鍵」は何も提供しません。「すべての鍵」は、セキュリティキー(ハードウェア)の鍵と、パスフレーズが保存も記憶もされていない暗号化された鍵を除外し、それらのパスフレーズを確認することもありません。
- 既定値: オフ(設定 › 接続とSSH)。
- 注意: 接続中は、そのサーバーの管理者権限を持つ人なら誰でも、転送された鍵を使って他の場所にあなたとしてログインできます。信頼できるサーバーでのみ有効にしてください。
レガシーアルゴリズムを許可
Section titled “レガシーアルゴリズムを許可”host.legacyAlgorithms · デスクトップのみ
最新のSSHでは廃止された古い暗号方式(SHA-1の鍵交換と署名、CBC暗号、ssh-rsaホスト鍵)も提供します。古いルーター、スイッチ、サーバーがこれらなしでは接続を拒否する場合にのみオンにしてください。
- 既定値: オフ(設定 › 接続とSSH › 詳細)。
- 注意: これらの方式は脆弱です。インターネットから到達できるものではオフのままにしてください。
耐量子鍵交換
Section titled “耐量子鍵交換”host.pqc · デスクトップのみ
サーバーが対応している場合、将来の量子コンピューターにも耐える、新しいセッション暗号鍵の合意方式(mlkem768x25519と呼ばれる方式)を優先します。通常の方式もその後に提供されます。サーバーがこれで正しく動作しない場合にのみオフにしてください。
- 既定値: オン(設定 › 接続とSSH › 詳細)。
SFTPの開始パス
Section titled “SFTPの開始パス”host.sftpStartPath · デスクトップのみ
このホストで初めてファイルブラウザーを開いたときのフォルダー。以降は最後に開いていたフォルダーをアプリが記憶します。
- 既定値: サーバー上のホームフォルダー。
- 例: /var/www
ターミナルのテーマ
Section titled “ターミナルのテーマ”host.theme
このホストのターミナルの配色です。本番サーバーをテスト用サーバーと違う見た目にできます。セッション内で選んだテーマは、そのセッションでは引き続き優先されます。
- 既定値: アプリのターミナルテーマ(設定 › 外観)。
host.fontFamily · デスクトップのみ
このホストのターミナルの書体。このコンピューターにインストールされているもの、または同梱のもの(JetBrains Mono、Fira Code、Cascadia Code、Source Code Pro、Hack)。
- 既定値: 設定 › ターミナルのフォント(JetBrains Mono)。
フォントサイズ
Section titled “フォントサイズ”host.fontSize · デスクトップのみ
このホストのターミナルの文字サイズ(ピクセル、6~72)。
- 既定値: 設定 › ターミナルのサイズ(14)。
host.lineHeight · デスクトップのみ
ターミナルの1行の高さ(フォントサイズの倍数、0.8~2)。大きいほどゆったりし、1は詰まった表示になります。
- 既定値: 設定 › ターミナルの値(1.2)。
host.charset · デスクトップのみ
サーバーが使う文字コードです。最近のシステムはほぼすべてUTF-8を使います。古いシステムでアクセント付き文字や罫線文字が文字化けする場合にのみ、別のものを選んでください。アプリが双方向に変換し、サーバー側は何も変更されません。
- 既定値: UTF-8。
- 例: ISO-8859-1、windows-1252、Shift_JIS
ターミナルの種類
Section titled “ターミナルの種類”host.termType · デスクトップのみ
アプリがTERM変数としてサーバーに伝える端末の種類です。プログラムはこれを使って、どの色やキーが使えるかを判断します。古いシステムで全画面プログラム(vi、top)が正しく動作しない場合にのみ変更してください。
- 既定値: xterm-256color(設定 › ターミナル › 詳細)。
- 例: 非常に古い機器ではvt100
Backspaceの送信内容
Section titled “Backspaceの送信内容”host.backspace · デスクトップのみ
Backspaceキーが送信する文字です。ほぼすべてのシステムはDELを想定しています。Backspaceで^?が表示されたり文字が消えなかったりする場合はCtrl-Hに切り替えてください。Ctrl+Backspaceではもう一方が送信されます。
- 既定値: DEL。
Telnetポート
Section titled “Telnetポート”host.telnetPort · デスクトップのみ
SSHの代わりにTelnetでこのホストを開くときのポート(1~65535)。Telnetにはアプリが代わりに応答できるログインがないため、サーバーがターミナルでユーザー名とパスワードを求め、そこで入力します。アプリはどちらも保存しません。
- 既定値: 23。
- 注意: Telnetは暗号化されていません。パスワードを含め、入力したすべての内容がネットワーク上で読み取られる可能性があります。
Moshを有効化
Section titled “Moshを有効化”host.moshEnabled · デスクトップのみ
Moshは、不安定な接続や移動中の接続でターミナルを維持する別の方法です。ネットワークの切り替えやスリープに耐え、入力をすぐにエコー表示します。アプリはまずSSHでログインしてから切り替えます。サーバーにはmosh-serverがインストールされUDPポートが開いている必要があり、このコンピューターにはmosh-clientプログラムがインストールされている必要があります(macOSとLinux。MoshはWindowsアプリでは動作しません)。スマートフォンアプリではMoshを実行できないため、これがオンのホストは通常のSSHで接続します。
- 既定値: オフ。
- 注意: Moshがオンの間、ジャンプホストやプロキシのあるホストは接続に失敗します。mosh-clientのないコンピューターでも同様です。デスクトップではSSHへのフォールバックはありません。Moshセッションはセッションログに記録されず、オートコンプリートもありません。
- 詳しく: 続きを読む(英語)
Moshサーバーのコマンド
Section titled “Moshサーバーのコマンド”host.moshServerCommand · デスクトップのみ
Mosh用にサーバー上で起動するプログラム。サーバーのPATHにmosh-serverがない場合にのみ設定してください。プログラム名またはフルパスのみを、引数なしで指定します。
- 既定値: mosh-server。
- 例: /usr/local/bin/mosh-server
- 詳しく: 続きを読む(英語)
MoshのUDPポート範囲
Section titled “MoshのUDPポート範囲”host.moshPortRange · デスクトップのみ
サーバーがMoshに使えるUDPポートまたはポート範囲で、コロンを使ってLOW:HIGHと記述します。サーバーのファイアウォールが通過を許可している範囲に合わせてください。
- 既定値: mosh-serverに任せる(ほとんどのシステムで60000~61000)。
- 例: 60000:61000
- 詳しく: 続きを読む(英語)
host.shellIntegration · デスクトップのみ
bashまたはzshセッションで各コマンドの開始位置と終了位置をアプリが把握できるようにします。これにより「コマンドが実行中か」の判定やワークスペースの復元が機能します。そのために、セッション開始時に小さなスクリプトをシェルに入力します。
- 既定値: オフ。
- 注意: そのシェルセッションのプロンプトフックを変更し、実行した各コマンドラインをアプリに報告します。
オートコンプリート
Section titled “オートコンプリート”host.autocomplete · デスクトップのみ
このホストで入力中に候補を表示するかどうか(デスクトップとスマートフォン)。ホストではオフにすることしかできず、設定 › ターミナルで候補がオフの場合、これでオンにすることはできません。パスワードプロンプトでデスクトップが保存済みパスワードを提案する機能は隠されません。
- 既定値: オン(設定 › ターミナルに従う)。
ホスト上のコマンドとオプションを参照
Section titled “ホスト上のコマンドとオプションを参照”host.autocompleteHostLookup · デスクトップのみ
オートコンプリートがこのホストに、インストール済みのコマンド、マニュアルページのオプション、ブランチ・サービス・ファイル名などの値を問い合わせてよいかどうか。問い合わせは決められた読み取り専用のコマンドで、セッション自身の接続を使ってバックグラウンドで実行され、ターミナルに入力されることはありません。勝手に何も実行されてはならないホストではオフにしてください。その場合、候補は履歴、スニペット、内蔵のコマンド説明から表示されます。スマートフォンアプリもこの設定に従います。
- 既定値: オン(設定 › ターミナルに従う)。
- 注意: 問い合わせはログインしたユーザーとして実行され、ホスト上では他のコマンドと同じように表示されます。
host.tabColor
このホストの色ラベルです。このホストへのすべてのセッションとSFTPタブ、および「セッション」と「ホスト」の行にこの色が付き、ホスト(または本番などの種類)をひと目で区別できます。グループに設定すると、ホスト自身で設定しない限り、グループ内のすべてのホストにこの色が付きます。ホストで「なし」を選ぶとグループの色が外れます。開いているタブは、ホストを変えずにメニューから別の色にできます。色はホストと一緒に同期されます。これはラベルであり、機密情報ではありません。
- 既定値: なし、またはグループの色。
- 例: Productionグループに赤、Stagingに緑。
スマートハイライト
Section titled “スマートハイライト”host.smartHighlight
このホストの通常の出力で認識したもの(アドレス、パス、サイズ、ログレベル、ファイル一覧)にSternwayが色を付けるかどうか。出力を誤認識するデバイスではオフに、設定でオフのときに特定のホストだけオンにできます。色を付ける種類は設定 › ターミナルで設定します。プログラム自身の色は変更されず、コピーにも影響しません。
- 既定値: 設定 › ターミナルに従う。
host.notify
このホストへのすべてのセッションが、毎回指定しなくても通知する内容です。同じ選択肢はセッションのメニュー(「通知する…」)にもあり、そちらはそのセッションにのみ適用されます。コマンドは設定 › 通知で設定した時間以上実行された場合に対象になります。「無音後の出力」は30秒間出力がなかった後の出力、「出力が止まったとき」は設定 › 通知で設定した分数の間出力がない状態(無音の期間ごとに1回)、「行が一致したとき」は設定 › 通知のルールを使用、「コーディングエージェントが入力を求めたとき」はコマンドラインのコーディングエージェントが実行前に行う質問を認識、「プログラムが通知を送ったとき」はリモートのプログラム自身が要求する通知(OSC 9、777、99)です。グループに設定すると、ホスト自身で設定しない限り、グループ内のすべてのホストが同じように通知します。
- 既定値: なし: セッションは依頼した内容についてのみ通知します。
- 注意: 通知にはホストの出力の1行が表示される場合があります。スマートフォンは、アプリが実行中か、バックグラウンドで維持されている間のみ通知します。
セッションのログ記録
Section titled “セッションのログ記録”host.sessionLogging · デスクトップのみ
このホストのセッションの出力をログに記録するかどうか。ホストのボールトでもログ記録がオンの場合にのみ記録されます(設定 › ログ)。出力を残したくないホストではオフにしてください。スマートフォンアプリも同じように記録し、この設定に従います。ログは、そのデバイスで「セッションログを同期」がオンでない限り、記録したデバイスに保存されます。
- 既定値: オン(ボールトがログを記録する場合)。
- 注意: ログには、コマンドが出力した機密情報を含め、ターミナルに表示されたすべてが含まれます。
セッションを録画
Section titled “セッションを録画”host.recordSessions · デスクトップのみ
このホストへのすべてのセッションを開始時からタイミング付きで録画し、後で「録画」で再生できるようにします。ターミナルの表示内容とサイズの変更をすべてasciicastファイルとして記録します。録画はアプリの他のデータと一緒に暗号化されてこのデバイスに保存され、同期やアップロードは一切されません。録画中はセッションに赤い「録画中」バッジが表示されます。グループに設定すると、ホスト側で別の設定をしない限り、グループ内のすべてのホストが録画します。個々のセッションもメニューから録画できます。
- 既定値: オフ。
- 注意: 録画には、コマンドが出力した機密情報を含め、ターミナルに表示されたすべてが含まれます。
- 詳しく: 続きを読む(英語)
入力内容も録画
Section titled “入力内容も録画”host.recordInput · デスクトップのみ
「セッションを録画」がオンのとき、入力した内容も録画に残します。アプリが認識するプロンプト(「password:」「passphrase:」「PIN:」などで終わる行。主なヨーロッパ言語、ロシア語、日本語、中国語、韓国語にも対応し、プログラムがキーごとに*を表示する場合も含む)の後に入力した内容は、Enter、Ctrl-C、Ctrl-Dまで記録されません。
- 既定値: オフ: ターミナルに表示された内容のみ録画されます。
- 注意: 入力したテキストには、アプリが機密情報と認識できないものが含まれる場合があります。コマンドラインに貼り付けたパスワード、トークン、異なる文言のプロンプト(「Verification code:」やドキュメントに記載のない言語)、最終行の末尾にないプロンプトなどです。これらは録画されます。
- 詳しく: 続きを読む(英語)
CPU・メモリ・ディスクのバー
Section titled “CPU・メモリ・ディスクのバー”host.metricsStrip · デスクトップのみ
このホストのターミナルの上に、CPU使用率、メモリ使用量、ルートファイルシステムの使用率を示す細いバーを表示します。ターミナルが画面に表示されている間、Sternwayは5秒ごとに短い読み取り専用のコマンド(Linuxでは/procとdf、macOSとFreeBSDではsysctl、vm_stat、ps)を接続の別チャネルで実行します。シェルには何も入力されず、履歴にも残りません。タブが非表示の間は一時停止し、読み取れないシステムでは非表示のままです。
- 既定値: オフ。
- 注意: 1接続につき1チャネルしか許可しないサーバーでは、シェルと並行して実行できないため、バーは空のままになります。
このセッションをサーバー上に保持
Section titled “このセッションをサーバー上に保持”host.tmuxAttach · スマートフォンのみ
このホストへのSSHセッションをサーバー上のtmux内で実行します。接続時に下記の名前のtmuxセッションにアタッチし、なければ作成します。中で実行しているものは、スマートフォンがスリープしても、ネットワークが切れても、アプリを閉じても動作し続け、自動または再接続ボタンで再接続すると再びアタッチするため、画面は離れたときのまま戻ります。ジャンプホスト経由でも動作します。アタッチの前に、Sternwayは専用のチャネルでtmuxがインストールされているかを確認し、ない場合はその旨を通知して通常のシェルとして続行します。
- 既定値: オフ。
- 例: スマートフォンで開始して後で確認する、長時間のビルドやコーディングエージェント。
- 注意: アタッチコマンドはシェルに入力されるため、画面に表示され、シェルがスペースで始まる行を記録しない設定でない限り履歴にも残ります。起動時のコマンドは、tmuxセッションの作成時にのみ入力され、アタッチのたびには入力されません。tmuxを抜けると(デタッチするか最後のウインドウを終了)、通常のシェルに戻ります。TelnetとMoshでは使われません。
tmuxセッション名
Section titled “tmuxセッション名”host.tmuxSession · スマートフォンのみ
アタッチするtmuxセッション。空欄の場合はホストのラベルから作成されます(「web-01 (prod)」はweb-01-prodになります)。英字、数字、-、_が使え、最大64文字です。同じサーバー上で同じ名前を持つ2つのホストは、1つのtmuxセッションを共有します。
- 既定値: ホストのラベルから作成。
- 例: build
Wake-on-LAN の MAC アドレス
Section titled “Wake-on-LAN の MAC アドレス”host.wakeMac
このマシンを起動するネットワークカードのハードウェアアドレスです。設定すると、ホストに「起動」操作が加わります。このデバイスが「マジックパケット」を送り、ファームウェアで Wake-on-LAN が有効なら、スリープ中や電源オフのマシンが起動します。パケットはこのコンピューターやスマートフォンから、今つながっているネットワークに送られます。サーバーは関与しないため、同じローカルネットワーク上のマシン(またはルーターが転送してくれるマシン)に届きます。
- 既定値: なし(「起動」操作なし)。
- 例: 52:54:00:ab:cd:ef(52-54-00-ab-cd-ef や 5254.00ab.cdef も可)
- 注意: マシンが起動しているときに、そのマシン上で確認してください(Linux では ip link、Windows では ipconfig /all)。電源が抜けているマシンや、カードが無効になっているマシンはパケットを受け取れません。
Wake-on-LAN のブロードキャストアドレス
Section titled “Wake-on-LAN のブロードキャストアドレス”host.wakeAddress
マジックパケットの送り先です。既定値は、このデバイスと同じネットワークセグメント上のすべてのマシンに届きます。マシンがルーターの転送する別のサブネットにある場合はそのネットワークのブロードキャストアドレス(例: 192.168.20.255)を、スリープ中もルーターが到達可能にしている場合はマシン自身のアドレスを使います。
- 既定値: 255.255.255.255(このネットワーク)。
- 例: 192.168.1.255
Wake-on-LAN のポート
Section titled “Wake-on-LAN のポート”host.wakePort
マジックパケットを送る UDP ポートです。ネットワークカードはポートに関係なく受け取ります。ルーターによってはポート 7 か 9 しか転送しません。1〜65535。
- 既定値: 9。
接続前に起動する
Section titled “接続前に起動する”host.wakeBeforeConnect
このホストへのすべての接続(ターミナル、ファイル、ポート転送)で、まずマジックパケットを送り、下の待ち時間を上限にホストの SSH ポートが応答するまで待ってからログインします。ポートの確認は接続を開いてすぐ閉じるだけで、ログインはしません。すでに起動しているホストはすぐに応答するので、その場合は待ち時間はかかりません。
- 既定値: オフ。
- 注意: 踏み台ホストやプロキシ経由で接続するホストでは、ここからポートを確認できません。アプリは待ち時間をすべて待ってから接続します。
起動を待つ時間(秒)
Section titled “起動を待つ時間(秒)”host.wakeWaitSec
「接続前に起動する」で、ホストが応答し始めるのを待つ時間です。過ぎるとそのままログインを試みます。電源オフから起動するマシンは、スリープから復帰するマシンより時間がかかります。5〜600。
- 既定値: 60 秒。
ポートノッキング
Section titled “ポートノッキング”host.knockSequence
このホストへの接続のたびに、接続前に順番に「ノック」するポートです。ノックを確認するまで SSH ポートを閉じておくファイアウォール(knockd など)を使うサーバー向けです。ポートはスペースで区切り、UDP でノックするポートには :udp を付けます(既定は TCP)。TCP のノックは接続を開いてすぐ閉じ、UDP のノックは空のパケットを 1 つ送ります。最大 16 ポート。このホストに踏み台ホスト経由で接続する場合は、踏み台ホストがノックを送ります。
- 既定値: なし(ホストに直接接続)。
- 例: 7000 8000:udp 9000
- 注意: 踏み台ホストの先へのノックは TCP のみで、UDP のノックはプロキシを通せません。ノックの順番はパスワードではありません。あなたとサーバーの間のネットワークを見ている人には分かります。
ノックの間隔(ミリ秒)
Section titled “ノックの間隔(ミリ秒)”host.knockDelayMs
各ノックの後、および最後のノックの後に接続するまで待つ時間です。ファイアウォールが追いつけるようにします。0〜10000 ミリ秒。
- 既定値: 200 ミリ秒。
場所: ホスト › 新しいグループ、またはグループの編集.
group.name
ホスト一覧でのフォルダー名。必須、256文字以内。
- 例: 本番
group.parent
このグループを別のグループの中に入れます。そのホストは上位のグループの設定も継承するようになります。グループを自分自身や自分のサブグループの中に入れることはできません。
- 既定値: なし(最上位)。
クラウドプロバイダーからホストを同期
Section titled “クラウドプロバイダーからホストを同期”group.cloudEnable · デスクトップのみ
このグループに、稼働中のクラウドサーバーを自動で登録し続けます。インスタンスごとにホストが追加され、アドレスが変わると更新され、インスタンスがなくなるとホストが削除されます。アプリはインスタンスの一覧を読み取るだけで、プロバイダー側では何も変更しません。
- 既定値: オフ。
- 注意: 停止または終了したインスタンスのホストは、次回の更新時に、加えた編集内容ごと削除されます。
プロバイダー
Section titled “プロバイダー”group.cloudProvider · デスクトップのみ
インスタンスを読み取るクラウドサービス。現在動作するのはAWS EC2のみで、その他は近日対応予定として表示されます。
- 既定値: AWS EC2。
group.cloudRegion · デスクトップのみ
インスタンスを一覧表示するプロバイダーのリージョン(1つ)。複数のリージョンを使う場合は、リージョンごとにグループを作成してください。
- 例: us-east-1、eu-west-2
名前フィルター
Section titled “名前フィルター”group.cloudFilter · デスクトップのみ
Nameタグが一致するインスタンスだけが追加されます。テキストはNameタグのフィルターとしてAWSに渡されます。名前全体が一致する必要があり、大文字と小文字は区別されます。*は任意の文字列、?はちょうど1文字を表します。たとえば「web」は名前がwebのインスタンスだけを、「web-*」はweb-1やweb-eu-2を見つけます。フィルターを設定すると、Nameタグのないインスタンスは除外されます。リージョン内の実行中または起動中のすべてのインスタンスを対象にするには空欄にしてください。
- 既定値: 空欄(すべてのインスタンス)。
- 例: web-*
更新間隔(分)
Section titled “更新間隔(分)”group.cloudRefresh · デスクトップのみ
アプリが開いている間にインスタンスの一覧を再読み込みする間隔(1~1440分)。
- 既定値: 60。
アクセスキーID
Section titled “アクセスキーID”group.cloudAccessKeyId · デスクトップのみ
EC2インスタンスの一覧取得が許可されたAWSアクセスキーの公開部分。保存済みのものを維持するには、両方のキー欄を空欄のままにしてください。
- 例: AKIA…
- 注意: このデバイスにのみ保存されます。同期されることもチームと共有されることもないため、同期するデバイスごとに設定が必要です。
シークレットアクセスキー
Section titled “シークレットアクセスキー”group.cloudSecretAccessKey · デスクトップのみ
そのAWSアクセスキーのシークレット部分。インスタンス一覧の要求に署名するために使います。
- 注意: このデバイスにのみ保存され、再表示されません。アカウントのメインキーではなく、EC2の読み取りだけができるキーを使ってください。
セッショントークン
Section titled “セッショントークン”group.cloudSessionToken · デスクトップのみ
一時的なAWS認証情報(SSOや引き受けたロールから取得したもの、3つの部分からなる)の場合のみ使います。通常のアクセスキーの場合は空欄にしてください。
- 既定値: なし。
ホスト:クイック接続、移動、タグ
Section titled “ホスト:クイック接続、移動、タグ”場所: ホスト画面.
クイック接続
Section titled “クイック接続”quickConnect.target
ホストを保存せずに1回だけ接続します。アドレスを入力し(必要に応じて@の前にユーザー名、コロンの後にポート)、またはssh://、sftp://、telnet://リンクや「ssh」コマンドを貼り付けてください。コマンドからはユーザー(-l)、ポート(-p)、ジャンプホスト(-J)が使われます。それ以外のオプション、ホストで実行するコマンド、リンク内のパスワードは使われず、どれが使われなかったかが表示されます。貼り付けた内容が実行されることはありません。設定のアプリデフォルト値を使い、グループ、鍵、プロキシは使いません。
- 既定値: ポート22。ユーザー名を省略した場合は確認されます。
- 例: root@203.0.113.10:2222、または ssh -p 2222 -J jump@bastion deploy@web-01
hostSave.label · デスクトップのみ
クイック接続を保存したときにホスト一覧で使われる名前です。アドレス、ポート、ユーザー名は接続から取得されます。入力したパスワードは、パスワードの確認時に保存を選んだ場合のみ一緒に保存されます。保存後は他のホストと同様に編集できます。
hostMove.group · デスクトップのみ
選択したホストの移動先グループ。移動したホストはそのグループの設定を継承し始めます。異なるボールトのホストは、それぞれのボールトの最上位にしか移動できません。
- 既定値: グループなし(最上位)。
hostBulk.tags
選択したすべてのホストに追加する、または外すタグです。タグを 1 回クリックするとすべてに追加(すべてが持っている場合は外す)、もう一度で切り替え、3 回目で変更なしに戻ります。チップには今そのタグを持つホストが表示されます。
- 既定値: すべてのタグを変更しない。
hostBulk.identity
選択したすべてのホストがログインに使う保存済みの ID です。「継承」は各ホストの ID を外してグループから継承させ、「なし」は ID を使わないことを意味します。ホスト自身のユーザー名、パスワード、鍵は残ります。ID が選ばれている間は使われず、ID を外すと再び使われます。
- 既定値: 変更しない。
SSH ポート
Section titled “SSH ポート”hostBulk.port
選択したすべてのホストの SSH ポートです。1〜65535 の数値、または各ホスト自身のポートを外してグループから継承させる「継承」(既定は 22)。
- 既定値: 変更しない。
- 注意: このデバイスで承認したポート転送は、ホストのポートが変わると再び承認を求めます。共有ホストでは、チームメンバーのデバイスが接続前に変更を表示します。
hostBulk.group
選択したすべてのホストを入れるグループ、または保管庫の最上位です。ホストはそのグループの設定を継承するようになります。
- 既定値: 変更しない。
移動先のボールト
Section titled “移動先のボールト”hostTransfer.vault · デスクトップのみ
選択した項目の移動先またはコピー先のボールト。ボールトは個別に暗号化されたコレクションで、個人用のものとチームと共有するものがあります。
- 注意: 移動先のボールトにアクセスできる全員が、そこに入れた内容を閲覧・使用できるようになります。
移動先のグループ
Section titled “移動先のグループ”hostTransfer.group · デスクトップのみ
移動先ボールト内で項目を入れるグループ。
- 既定値: (グループなし)。
共有の認証情報
Section titled “共有の認証情報”hostTransfer.linkMode · デスクトップのみ
コピーしたホストがログインに使うアイデンティティと鍵の扱いです。「リンクをコピー」はそれらも移動先のボールトにコピーします。「個人の認証情報として保持」(個人用ボールトからチームボールトへの場合)はそれらをコピーに含めず、そのホストに対するあなた個人の認証情報として保持します。
- 既定値: リンクをコピー。
- 注意: 「リンクをコピー」を選ぶと、移動先のボールトを開ける全員がコピーされた鍵とパスワードを入手します。
tag.name
タグが使われているすべての場所で名前を変更します。1~64文字。同じボールト内の2つのタグに、大文字・小文字の違いを除いて同じ名前は付けられません。
hostFilter.match
複数のタグを選んだ場合、「いずれか」はそのうち少なくとも1つを持つホストを、「すべて」はすべてを持つホストだけを表示します。
- 既定値: いずれか。
ホスト:Tailscaleからインポート
Section titled “ホスト:Tailscaleからインポート”場所: ホスト › 新規 › Tailscaleからインポート….
デバイスの読み込み元
Section titled “デバイスの読み込み元”tailscale.source · デスクトップのみ
「このコンピューターのTailscale」は、ここで動作しているTailscaleアプリに鍵なしで問い合わせ(tailscale status --json)、このコンピューターから見えるデバイスを一覧表示します。「Tailscale API」はTailscaleアプリのないコンピューター用で、APIキーを使ってapi.tailscale.comに問い合わせます。
- 既定値: このコンピューターのTailscale。
コントロールサーバー
Section titled “コントロールサーバー”tailscale.controlUrl · デスクトップのみ
Tailscale からデバイスを読み取る場合は空欄。Headscale が運用する tailnet の場合は、Headscale サーバーの URL(設定の server_url)を入力します。インポートは代わりに Headscale の API キーでそのノード一覧(/api/v1/node)を読み取り、tailnet 名は不要です。次回のインポートのためにこのデバイスに保存されます。「このコンピューター」ではこれは不要です。Tailscale クライアントは、Headscale を含め、ログインしているサーバーから応答します。
- 例:
https://headscale.example.com - 注意: https:// のみ(暗号化しない http:// はこのコンピューター、localhost へのみ)で、ユーザー名やパスワードを含めないでください。API キーはこのサーバーに送られます。Headscale はノードの OS、MagicDNS 名、Tailscale SSH の使用有無を返さないため、それらのデバイスは Tailscale アドレスで追加されます。
Tailnet
Section titled “Tailnet”tailscale.tailnet · デスクトップのみ
Tailscale管理コンソールのSettings › Generalに表示されるtailnetの名前(多くはメールアドレスのドメイン、またはexample.githubのような名前)。ダッシュ1つ(「-」)はキーのtailnetを意味します。
- 例: example.com
tailscale.apiKey · デスクトップのみ
Tailscale管理コンソール(Settings › Keys)で発行した、tskey-api-で始まるAPIアクセストークン(コントロールサーバーを設定した場合は Headscale の API キー、headscale apikeys create)。デバイス一覧を読み取るためにapi.tailscale.comまたはそのサーバーへ1回だけ送信され、どこにも保存されません。
- 注意: キーを持つ人は誰でも、期限が切れるまでtailnetを管理できます。有効期限を短くし、インポート後に失効させてください。
tailscale.address · デスクトップのみ
新しい各ホストのアドレスです。MagicDNS名(homelab.tail1234.ts.net)はデバイスのTailscale IPが変わっても使え、Tailscale IPv4アドレス(100.x.y.z)はMagicDNSなしで使えます。
- 既定値: MagicDNS名。
Tailscale SSHとしてマーク
Section titled “Tailscale SSHとしてマーク”tailscale.ssh · デスクトップのみ
Tailscale SSHを実行しているデバイス向け: ホストには「Tailscale SSH」タグが付き、パスワードや鍵は設定されません。Tailscaleがtailnet上で本人確認を行い、このコンピューターのユーザー名でログインします。
- 既定値: 選択したすべてのデバイスがTailscale SSHを実行している場合はオン。
ホスト:ファイルを配布
Section titled “ホスト:ファイルを配布”場所: ホスト › ホストを選択 › ファイルを配布….
push.file · デスクトップのみ
選択したすべてのホストにコピーする、このコンピューター上のファイル。コピー先でも同じ名前になります。
ホスト上のフォルダー
Section titled “ホスト上のフォルダー”push.remoteDir · デスクトップのみ
各ホストでのファイルの配置先。~はログインするユーザーのホームフォルダーで、/で始まらないパスはそこからの相対パスになります。フォルダーは存在している必要があります。
- 既定値: ~(ホームフォルダー)。
- 例: ~/bin、/etc/myapp
ファイルがすでにある場合
Section titled “ファイルがすでにある場合”push.conflict · デスクトップのみ
「置き換え」はフォルダー内の同名のファイルを上書きします。「スキップ」はそのままにして、そのホストを「スキップ」とします。
- 既定値: 置き換え。
- 注意: 「置き換え」は、ファイルがあるすべてのホストで確認なしに上書きします。
push.hosts · デスクトップのみ
ファイルを送るホスト: チェックしたホスト、または(タグのルールで)配布開始時に選んだタグを持つホストです。4台ずつコピーし、各ホストはSFTPと同じように接続して、SFTPで尋ねることを尋ねます。
タグのルール
Section titled “タグのルール”fleet.tagRule · デスクトップのみ
チェックしたタグのいずれか、またはすべてを持つホストです。ルールは操作の開始時(と再実行時)に読み取られるため、その後タグを付けたホストは含まれ、外したホストは含まれません。下の行に、現在選ばれるホストが表示されます。
- 既定値: いずれかのタグ。
ホスト:ファイルを収集
Section titled “ホスト:ファイルを収集”場所: ホスト › その他 › ファイルを収集….
ホスト上のファイル
Section titled “ホスト上のファイル”pull.remotePath · デスクトップのみ
選んだ各ホストから収集するファイルです。~ はログインするユーザーのホームフォルダーで、/ で始まらないパスはそこからのパスです。各ホストのコピーは、ZIP内のホスト名のフォルダーに入ります。
- 例: /etc/os-release, ~/.bashrc
収集する最大ファイルサイズ
Section titled “収集する最大ファイルサイズ”pull.cap · デスクトップのみ
これより大きいファイルのホストは除外され「大きすぎ」と表示されます。巨大なログでディスクがいっぱいにならないためです。3台ずつ収集します。
- 既定値: 50 MB。
pull.hosts · デスクトップのみ
ファイルを収集するホスト: チェックしたホスト、または(タグのルールで)開始時に選んだタグを持つホストです。各ホストはSFTPと同じように接続します。すべてのホストが終わるとZIPを書き込み、失敗したホストから再収集するとZIPを書き直します。
ホスト:インベントリ
Section titled “ホスト:インベントリ”場所: ホスト › その他 › インベントリ.
CSVをエクスポート
Section titled “CSVをエクスポート”inventory.export · デスクトップのみ
インベントリをCSVファイルに保存します: ホスト、アドレス、OS、バージョン、アーキテクチャ、このデバイスが最後に接続した日時(UTC)。内容は各接続時のOSチェックによるもので、このボールトを持つデバイスから一度も接続していないホストは空欄になります。ファイルは暗号化されません。暗号化なしのエクスポートをポリシーでブロックしているチーム(または今ポリシーを読めないチーム)のホストは含まれず、その数がダイアログに表示されます。
ホスト:tmuxセッション
Section titled “ホスト:tmuxセッション”場所: ホスト › ホスト › tmuxセッション….
ペインを検索
Section titled “ペインを検索”tmux.search · デスクトップのみ
ホスト上のすべてのtmuxセッションの各ペインに表示されている内容から語句を探します。各ペインの最後の200行、最大64ペインで、大文字と小文字は区別しません。テキストは専用チャネルで読み取り(ターミナルには入力しません)、このコンピューター上で検索します。結果には、どのセッション、ウインドウ、ペインかが「アタッチ」とともに表示されます。
tmux.name · デスクトップのみ
tmux のセッション名またはウィンドウ名、またはペインのタイトルで、128 文字までです。スペース、引用符などの文字は入力したとおりに残ります (# も同じで、tmux は表示するだけで書式として読みません)。改行、タブ、その他の制御文字は拒否され、セッション名では tmux がウィンドウとペインの指定に使う : と . も拒否されます。「開始」はホスト上でセッションを作成して実行したままにします。「開始して接続」は新しいタブでも開き、名前をターミナルに入力するため、英字、数字、- と _ だけが使えます。
© 2026 IRONPINE LABS LLC
ALL RIGHTS RESERVED.