コンテンツへスキップ
Localtonet Localtonet ダッシュボード

デバイスターミナル

無料 デスクトップ v8.6+ Windows、Linux、macOS

このページのヘルプ
このページの内容 13セクション
  1. 仕組み
  2. 始める前に
  3. デバイスを追加する
  4. 「デバイスを追加」を開く
  5. トークンを選ぶ
  6. コンピューターでコマンドを実行する
  7. コードを入力して承認する
  8. コンピューターの前に誰もいない場合
  9. コマンドのオプション
  10. デバイス一覧
  11. ブラウザーでターミナルを開く
  12. 「ターミナル」を選択する
  13. 認証アプリのコードを入力する
  14. sshで接続する
  15. SSHキー
  16. Localtonetクライアントを使う
  17. スクリプトとAIエージェント用のアクセスキー
  18. Elio
  19. 接続履歴
  20. デバイスの名前変更、削除、無効化
  21. セキュリティに関する注意
  22. トラブルシューティング
  23. 関連ページ

マイデバイスには、お使いのコンピューターがCPU、メモリ、ディスクの使用状況とともに一覧表示され、ブラウザーからそのどれでも実際のシェルを開けます。有効にするには、マシン上でコマンドを1つ実行するだけです。コンピューター側で公開ポートを待ち受ける必要はありません。

仕組み #

マシン上で localtonet --terminal enable を実行し、表示された短いコードをダッシュボードで承認します。それ以降は、ターミナルボタンを押すと、そのマシンのシェルがブラウザーのタブで開きます。同じシェルには、ダッシュボードに表示される ssh コマンドを使って任意のターミナルからも接続できます。

  • デバイスは外向きの接続のみを行います。開放する受信ポートも、インストールするSSHサーバーも不要です。
  • ブラウザーからシェルを開くたびに、認証アプリの新しいコードが必要です。
  • ターミナルを有効にできるのは、ローカルのコマンドだけです。ダッシュボードから有効にすることはできません。

始める前に #

  • マシンにLocaltonetがあること。この機能を使うために必要なLocaltonetアプリの最小バージョンはデスクトップ v8.6です。ダウンロードページから入手してください。
  • そのマシン用のAuthToken。コンピューターごとに専用のトークンを使ってください。1つのトークンを2台目のコンピューターで実行すると、1台目の接続が切断されます。ターミナルは個人アカウントのトークンで動作し、チームのトークンでは動作しません。AuthTokenを参照してください。
  • 二要素認証。シェルを開くには、アカウントに認証アプリが設定されている必要があります。まだ設定していない場合、マイデバイスに二要素認証をオンにするが表示されます。アカウントとセキュリティを参照してください。

マイデバイスは、個人用ダッシュボードのメニューにあります。チームを選択している間は表示されません。

デバイスを追加する #

  1. 「デバイスを追加」を開く #

    マイデバイスを開き、デバイスを追加を選択します。

  2. トークンを選ぶ #

    既存のトークンを選ぶか、新しいトークンを生成を選択して新規作成し、コマンドに組み込みます。このコンピューターですでにLocaltonetを実行している場合は、そのトークンを選んでください。一覧には、オンラインのトークンや、すでに別のデバイスで使われているトークンが表示されます。現在接続中のトークンには警告が表示されます。同じコンピューターでLocaltonetを実行している場合にのみ使用してください。

  3. コンピューターでコマンドを実行する #

    ダイアログからコマンドをコピーし、追加したいコンピューターのターミナルで実行します。そこでLocaltonetをサービスとして実行している場合は、管理者権限のターミナルか sudo を使ってください。

    コンピューター上で
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    コマンドは承認コードを表示して待機します。

    出力
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    管理者またはrootとして実行すると、最初に Run shells as user: と尋ねられ、現在のアカウントが候補として表示されます。これらの権限がない場合、シェルはコマンドを実行したアカウントで動作します。

  4. コードを入力して承認する #

    ダイアログに戻り、2. 表示されたコードを入力しますの下に承認コードを入力します。大文字とハイフンは自動的に補われ、コマンドが表示した行全体を貼り付けることもできます。認証アプリの6桁のコードを入力し、デバイスを承認を選択します。

    コンピューター側のコマンドが Terminal enabled. Shells will run as … と表示し、デバイスが一覧に追加されます。Localtonetが実行されている間は、オンラインと表示されます。

承認コードの有効期間は15分です。コードは8文字で、I、L、O、U、0、1は含まれません。期限が切れた場合はコマンドがその旨を表示するので、もう一度実行してください。

承認後、コンソールで手動で起動したコマンドは、通常のLocaltonetの実行としてそのまま続行されます。スクリプトから実行した場合や、このトークンですでにデバイス上でLocaltonetが実行されている場合は、ターミナルが有効になった時点でコマンドが終了します。

コンピューターの前に誰もいない場合 #

スクリプトでセットアップしたサーバーなど、コードを読み取れる人がいないマシンでは、承認コードの代わりにワンタイムキーを使います。

  1. デバイスを追加ダイアログで、トークンを選び、認証アプリのコードを入力します。
  2. そのコンピューターでコードを読み取れる人がいませんか?を開き、ワンタイムキーを作成を選択します。キーの有効期間は1時間で、1回だけ使えます。
  3. コマンドをコピーし、ACCOUNT を、そのコンピューターでシェルを実行するユーザーアカウントに置き換えます。
コンピューター上で
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

有効なキーを使うと、デバイスはすぐに承認され、コードは表示されません。

コマンドのオプション #

オプション動作
--terminal enableこのコンピューターでリモートターミナルを有効にし、ペアリングを開始します。
--terminal disableこのコンピューターでターミナルを無効にし、お使いのアカウントからデバイスを削除します。
--terminal statusターミナルが有効かどうかと、シェルがどのアカウントで動作するかを表示します。
--terminal-user <ACCOUNT>rootまたは管理者として有効にする場合に、シェルを実行するアカウントです。スクリプトなど、コンソールなしでコマンドを実行する場合は必須です。
--pairing-key <PAIRING_KEY>ダッシュボードのワンタイムキーです。指定すると承認コードは不要になります。

デバイス一覧 #

ページを開いている間、一覧は自動的に更新されます。

列表示内容
デバイスコンピューターの名前、オペレーティングシステムとアーキテクチャ、シェルを実行するアカウント。
ステータスオンラインは、コンピューターでLocaltonetが実行され、接続されていることを示します。
CPU現在のプロセッサー負荷。デバイスがオンラインの間に表示されます。
メモリ合計に対する使用中のメモリ。デバイスがオンラインの間に表示されます。
ディスク合計に対する使用中のディスク容量。デバイスがオンラインの間に表示されます。
操作ターミナル、キー、接続履歴、名前の変更、削除。

ブラウザーでターミナルを開く #

  1. 「ターミナル」を選択する #

    デバイスの行にあるターミナルを選択します。このボタンは、デバイスがオンラインの間だけ使えます。ダイアログには、シェルがどのアカウントで動作するかが表示されます。

  2. 認証アプリのコードを入力する #

    認証アプリの6桁のコードを入力し、ターミナルを開くを選択します。シェルが新しいブラウザータブで開きます。

sshで接続する #

ターミナルダイアログには、または、インストール不要で任意のターミナルからの下にコマンドも表示されます。sshクライアントがあれば、どのコンピューターからでも使えます。コマンドは次の形式で、<DEVICE> はデバイスの名前、<NODE> はそのデバイスが接続しているLocaltonetサーバーです。

任意のターミナル
ssh -p 24 <DEVICE>@<NODE>

ダイアログからコマンドをコピーしてください。お使いのデバイス用の正確なコマンドが表示されます。

  • ダイアログにはサーバーのフィンガープリントが表示されます。sshは初回接続時にフィンガープリントを表示します。一致していれば、Localtonetに接続できています。
  • SSHキーを追加していない場合、sshはブラウザーで承認するためのリンクを表示します。接続を承認ページには、デバイス名と、リクエストの送信元のIPアドレスが表示されます。認証アプリのコードを入力して接続を許可を選択し、ターミナルに戻ります。リクエストの有効期限は5分です。

接続を承認するのは、たった今ご自身でsshコマンドを実行した場合だけにしてください。リクエストを出した人は、そのコンピューターのシェルを取得します。

SSHキー #

お使いのコンピューターのSSH公開鍵を追加すると、ssh、scp、sftp が、ブラウザーでの承認なしで接続できます。

  1. マイデバイスでSSHキーを選択します。
  2. 名前を入力し、公開鍵ファイル(たとえば ~/.ssh/id_ed25519.pub)の1行を公開鍵に貼り付けます。秘密鍵は絶対に貼り付けないでください。
  3. 認証アプリのコードを入力し、キーを追加を選択します。

使用できる鍵の種類は、ssh-ed25519、ecdsa-sha2-nistp256、ecdsa-sha2-nistp384、ecdsa-sha2-nistp521、ssh-rsa です。鍵はアカウントのすべてのデバイスに適用されます。鍵の横の削除を選択すると、その鍵は使えなくなります。ダイアログには、お使いのデバイスの1つに対する scp の例も表示されます。

任意のターミナル
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Localtonetクライアントを使う #

接続元のコンピューターにLocaltonetがインストールされている場合は、localtonet ssh でも接続でき、セッションはデバイスまで暗号化されたままです。

任意のターミナル
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

鍵がない場合は、リンクとともに Approve this connection in your browser と表示され、承認すると処理が続行されます。-- 以降はすべて、シェルを開く代わりにデバイス上で1つのコマンドとして実行されます。

スクリプトとAIエージェント用のアクセスキー #

アクセスキーを使うと、スクリプトやAIエージェントがブラウザーなしで1台のコンピューターにアクセスできます。キーを持つ人は誰でもそこでコマンドを実行できるため、非公開で管理してください。

  1. デバイスの行にあるキーを選択します。
  2. 名前を入力し、有効期間(日)を設定して、認証アプリのコードを入力します。キーは指定した日数が過ぎると使えなくなります。最大は3650日です。
  3. キーを作成を選択し、すぐにキーをコピーします。キーは二度と表示されません。

キーの使い方:

  • ssh。ダイアログに表示されるsshコマンドを実行します。sshが求めたら、キーを貼り付けます。
  • Localtonetクライアント。下の例のように、--key オプションでキーを渡します。
  • MCP。LocaltonetのMCPサーバーに接続したAIエージェントは、キーを RunDeviceCommand ツールに渡せます。
スクリプト
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

ダイアログには、デバイスのキーが有効期限とともに一覧表示されます。削除を選択すると、キーを無効にできます。

Elio #

マイデバイスのElioボタンは、Localtonetが提供する無料のオープンソースSSHクライアント、Elioに関するものです。elio.shからダウンロードし、Elioでサインインして、ダッシュボードで二要素認証のコードを使ってリクエストを承認します。すると、Elioからデバイスの名前とステータスが見えるようになります。デバイスでシェルを開くには、引き続きそのデバイスのアクセスキーか承認が必要です。ダイアログには、サインイン中のElioが一覧表示され、1つを削除するとそのElioはサインアウトされます。

接続履歴 #

デバイスの行にある時計ボタンを選択すると、最新の接続が表示されます。各行には、接続した日時、接続方法、接続元のIPアドレスが表示されます。接続方法は次のいずれかです。ブラウザーターミナル、SSHキーによるssh、アクセスキーによるssh、ブラウザーで承認したssh、アクセスキーまたはブラウザーでの承認による localtonet ssh、アクセスキーを使ったMCP経由のAIエージェント。一覧には直近50件の接続が保存されます。

Localtonetが保持するのはこの記録だけです。入力したコマンドとその出力は保存されません。身に覚えのない接続がないか一覧で確認し、見つかった場合は、不要なアクセスキーとSSHキーを削除してください。

デバイスの名前変更、削除、無効化 #

操作場所結果
名前の変更行にある鉛筆ボタン。一覧に表示され、sshコマンドで使われる名前を変更します。使用できるのは、英字、数字、ドット、ダッシュ、アンダースコアです。
削除行にあるゴミ箱ボタン。コンピューターをアカウントから削除します。そのキーは使えなくなり、再度使うには改めて承認が必要です。
無効化コンピューター本体で実行します。ローカルでターミナルを無効にし、アカウントからデバイスを削除します。
コンピューター上で
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

無効化は、ダッシュボードに接続できない場合でも、コンピューター上で常に実行できます。その場合、コマンドはダッシュボードでもデバイスを削除するよう案内します。

セキュリティに関する注意 #

  • マシンのシェルは、そのアカウントができることすべてへの完全なアクセスです。シェルを実行するアカウントは慎重に選んでください。権限のないアカウントを使えば、セッションで変更できる範囲を制限できます。
  • シェルにつながり得る操作はすべて、新しい認証アプリのコードが必要です。デバイスの承認、ターミナルを開くこと、アクセスキーの作成、SSHキーの追加、ssh接続の承認が該当します。
  • アクセスキーと追加済みのSSHキーは、そのコードなしで接続できます。キーの有効期間は短くし、パスワードと同様に保管して、使わなくなったものは削除してください。
  • 短時間に試行回数が多すぎると、ダッシュボードは 試行回数が多すぎます。1分ほど待ってからもう一度お試しください。と応答します。
  • ときどき接続履歴を確認してください。見覚えのない接続がある場合は、想定外のキーまたは承認が使われたことを意味します。
  • デバイスを削除するか、デバイスで --terminal disable を実行すると、そのデバイスのすべてのキーによるアクセスが終了します。

トラブルシューティング #

承認コードが正しくないか、有効期限が切れています。

コマンドが表示したコードと照らし合わせてください。コードの有効期間は15分で、コマンドに指定したトークンのアカウントに紐づきます。コマンドをもう一度実行して、新しいコードを取得してください。

Remote terminal is available on personal tokens only

コマンドのトークンがチームのものです。個人アカウントでトークンを作成して、そちらを使ってください。

The pairing key is not valid or has expired

ワンタイムキーは1回だけ、1時間のみ有効です。デバイスを追加ダイアログで新しいキーを作成してください。

--terminal-user でシェルのアカウントを選ぶ

コマンドがコンソールなしでrootまたは管理者として実行されているため、アカウントを尋ねることができません。--terminal-user <ACCOUNT> を追加してください。

ターミナルボタンが無効になっている、または「このデバイスはオフラインです。」と表示される

ターミナルは、デバイスがオンラインの間だけ開けます。同じトークンで、そのコンピューターのLocaltonetを起動してください。

認証コードが正しくありません。

Localtonetについて認証アプリが表示する6桁のコードを入力してください。パスワードでも、コンピューターに表示されるコードでもありません。30秒ごとに変わります。

このリクエストは期限切れです。マイデバイスからやり直してください。

ターミナルを開くリクエストや、ssh接続を承認するリクエストの有効期間は短くなっています。ターミナルをもう一度選択するか、sshコマンドをもう一度実行してください。

SSH公開鍵ではないようです。

.pub ファイルの行全体を、鍵の種類から始めて貼り付けてください。

The terminal is already enabled on this device

何もする必要はありません。マシンをもう一度ペアリングするには、先に --terminal disable、次に --terminal enable を実行してください。

サポート