デバイスターミナル
無料 デスクトップ v8.6+ Windows、Linux、macOS
このページの内容 13セクション
マイデバイスには、お使いのコンピューターがCPU、メモリ、ディスクの使用状況とともに一覧表示され、ブラウザーからそのどれでも実際のシェルを開けます。有効にするには、マシン上でコマンドを1つ実行するだけです。コンピューター側で公開ポートを待ち受ける必要はありません。
仕組み #
マシン上で localtonet --terminal enable を実行し、表示された短いコードをダッシュボードで承認します。それ以降は、ターミナルボタンを押すと、そのマシンのシェルがブラウザーのタブで開きます。同じシェルには、ダッシュボードに表示される ssh コマンドを使って任意のターミナルからも接続できます。
- デバイスは外向きの接続のみを行います。開放する受信ポートも、インストールするSSHサーバーも不要です。
- ブラウザーからシェルを開くたびに、認証アプリの新しいコードが必要です。
- ターミナルを有効にできるのは、ローカルのコマンドだけです。ダッシュボードから有効にすることはできません。
始める前に #
- マシンにLocaltonetがあること。この機能を使うために必要なLocaltonetアプリの最小バージョンはデスクトップ v8.6です。ダウンロードページから入手してください。
- そのマシン用のAuthToken。コンピューターごとに専用のトークンを使ってください。1つのトークンを2台目のコンピューターで実行すると、1台目の接続が切断されます。ターミナルは個人アカウントのトークンで動作し、チームのトークンでは動作しません。AuthTokenを参照してください。
- 二要素認証。シェルを開くには、アカウントに認証アプリが設定されている必要があります。まだ設定していない場合、マイデバイスに二要素認証をオンにするが表示されます。アカウントとセキュリティを参照してください。
マイデバイスは、個人用ダッシュボードのメニューにあります。チームを選択している間は表示されません。
デバイスを追加する #
-
「デバイスを追加」を開く #
マイデバイスを開き、デバイスを追加を選択します。
-
トークンを選ぶ #
既存のトークンを選ぶか、新しいトークンを生成を選択して新規作成し、コマンドに組み込みます。このコンピューターですでにLocaltonetを実行している場合は、そのトークンを選んでください。一覧には、オンラインのトークンや、すでに別のデバイスで使われているトークンが表示されます。現在接続中のトークンには警告が表示されます。同じコンピューターでLocaltonetを実行している場合にのみ使用してください。
-
コンピューターでコマンドを実行する #
ダイアログからコマンドをコピーし、追加したいコンピューターのターミナルで実行します。そこで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: と尋ねられ、現在のアカウントが候補として表示されます。これらの権限がない場合、シェルはコマンドを実行したアカウントで動作します。
-
コードを入力して承認する #
ダイアログに戻り、2. 表示されたコードを入力しますの下に承認コードを入力します。大文字とハイフンは自動的に補われ、コマンドが表示した行全体を貼り付けることもできます。認証アプリの6桁のコードを入力し、デバイスを承認を選択します。
コンピューター側のコマンドが Terminal enabled. Shells will run as … と表示し、デバイスが一覧に追加されます。Localtonetが実行されている間は、オンラインと表示されます。
承認コードの有効期間は15分です。コードは8文字で、I、L、O、U、0、1は含まれません。期限が切れた場合はコマンドがその旨を表示するので、もう一度実行してください。
承認後、コンソールで手動で起動したコマンドは、通常のLocaltonetの実行としてそのまま続行されます。スクリプトから実行した場合や、このトークンですでにデバイス上でLocaltonetが実行されている場合は、ターミナルが有効になった時点でコマンドが終了します。
コンピューターの前に誰もいない場合 #
スクリプトでセットアップしたサーバーなど、コードを読み取れる人がいないマシンでは、承認コードの代わりにワンタイムキーを使います。
- デバイスを追加ダイアログで、トークンを選び、認証アプリのコードを入力します。
- そのコンピューターでコードを読み取れる人がいませんか?を開き、ワンタイムキーを作成を選択します。キーの有効期間は1時間で、1回だけ使えます。
- コマンドをコピーし、
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 | 現在のプロセッサー負荷。デバイスがオンラインの間に表示されます。 |
| メモリ | 合計に対する使用中のメモリ。デバイスがオンラインの間に表示されます。 |
| ディスク | 合計に対する使用中のディスク容量。デバイスがオンラインの間に表示されます。 |
| 操作 | ターミナル、キー、接続履歴、名前の変更、削除。 |
ブラウザーでターミナルを開く #
-
「ターミナル」を選択する #
デバイスの行にあるターミナルを選択します。このボタンは、デバイスがオンラインの間だけ使えます。ダイアログには、シェルがどのアカウントで動作するかが表示されます。
-
認証アプリのコードを入力する #
認証アプリの6桁のコードを入力し、ターミナルを開くを選択します。シェルが新しいブラウザータブで開きます。
sshで接続する #
ターミナルダイアログには、または、インストール不要で任意のターミナルからの下にコマンドも表示されます。sshクライアントがあれば、どのコンピューターからでも使えます。コマンドは次の形式で、<DEVICE> はデバイスの名前、<NODE> はそのデバイスが接続しているLocaltonetサーバーです。
ssh -p 24 <DEVICE>@<NODE>ダイアログからコマンドをコピーしてください。お使いのデバイス用の正確なコマンドが表示されます。
- ダイアログにはサーバーのフィンガープリントが表示されます。sshは初回接続時にフィンガープリントを表示します。一致していれば、Localtonetに接続できています。
- SSHキーを追加していない場合、sshはブラウザーで承認するためのリンクを表示します。接続を承認ページには、デバイス名と、リクエストの送信元のIPアドレスが表示されます。認証アプリのコードを入力して接続を許可を選択し、ターミナルに戻ります。リクエストの有効期限は5分です。
接続を承認するのは、たった今ご自身でsshコマンドを実行した場合だけにしてください。リクエストを出した人は、そのコンピューターのシェルを取得します。
SSHキー #
お使いのコンピューターのSSH公開鍵を追加すると、ssh、scp、sftp が、ブラウザーでの承認なしで接続できます。
- マイデバイスでSSHキーを選択します。
- 名前を入力し、公開鍵ファイル(たとえば
~/.ssh/id_ed25519.pub)の1行を公開鍵に貼り付けます。秘密鍵は絶対に貼り付けないでください。 - 認証アプリのコードを入力し、キーを追加を選択します。
使用できる鍵の種類は、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台のコンピューターにアクセスできます。キーを持つ人は誰でもそこでコマンドを実行できるため、非公開で管理してください。
- デバイスの行にあるキーを選択します。
- 名前を入力し、有効期間(日)を設定して、認証アプリのコードを入力します。キーは指定した日数が過ぎると使えなくなります。最大は3650日です。
- キーを作成を選択し、すぐにキーをコピーします。キーは二度と表示されません。
キーの使い方:
- 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 を実行してください。