SSH で接続
このコンピューターから、Linux サーバーや別のコンピューターの Octoboard を、デスクトップアプリまたはブラウザで SSH 経由で使います。相手のマシンへの暗号化された直接接続で、中継サービスやクラウドサービスは使いません。
この方法が自分に合っているかわからない場合は、接続方法を選ぶで、SSH が不要なブラウザ専用の方法と比べてみてください。
このコンピューターのデスクトップアプリ · SSH フォワード経由のブラウザ ⟷ SSH ⟷ Linux サーバーまたは別のコンピューター
はじめての方へ
- ホスト: Octoboard が動いていて、つなぎたい相手のマシンのことです。Linux サーバー、または別の Mac や Windows PC です。
- サーバー: ここでは、ネットワーク越しにサインインする Linux マシンのことです。たいていは借りているもので、画面はありません。
- SSH: 別のマシンに安全にサインインして、コマンドを入力するための、標準的で暗号化された方法です。macOS、Windows、Linux に標準で入っています。
- ターミナル: コマンドを入力するウィンドウです。macOS ではターミナル、Windows では PowerShell を使います。
- SSH フォワード: ホスト上にあるものを自分のコンピューター上に見せるための SSH コマンドです。これで、自分のブラウザからそれを開けるようになります。
- フィンガープリント(ホスト鍵): マシンの SSH を見分けるための短いコードです。一度確認しておけば、正しいマシンにつながったとわかります。
- 鍵ファイル: パスワードの代わりにサインインに使うファイルです。サーバーの提供元から渡されることがあります。
-
SSH でホストにサインインする方法。Linux サーバーなら、アドレスとユーザー名は提供元から案内されます。サインインできるか確かめるには、ターミナル(macOS)または PowerShell(Windows)を開き、自分のユーザー名とサーバーのアドレスを入れて次のコマンドを実行します。初回は、サーバーを信頼するか尋ねられるので、
yesと答えます。Terminal window ssh <you>@<server>ホストが Mac や Windows PC の場合は、そのシステム設定で SSH ログインをオンにします。やり方は別のコンピューターをホストにするで説明します。
-
Linux サーバーの場合は、そこにインストールして起動した Octoboard。やり方はインストール › Linux サーバーにあります。Octoboard のサーバー用プログラム octoboardd を、アプリでは「デーモン」と呼びます。
-
このコンピューターに入れた Octoboard アプリ。macOS 用または Windows 用です。ブラウザだけで使う場合は不要です。
Linux サーバーに接続する
Section titled “Linux サーバーに接続する”-
Octoboard を動かしているユーザーとしてサーバーに SSH でサインインし、次のコマンドを実行して、
octoboard+ssh://で始まる行をコピーします。これは接続情報で、アプリに、どこへどうやってつなぐかを伝えるものです。Terminal window octoboardd connectionこのコンピューターからサーバーへ別のアドレスや SSH ポートでつなぐ場合は、コマンドに
--hostまたは--ssh-portを付けると、正しい接続情報が表示されます。あわせて QR コードも表示されます。中身は同じ行ですが、読み取れるアプリはまだありません。
-
このコンピューターの Octoboard アプリで、左側のレールからリモートデバイスを開きます。macOS ではメニューバーからリモート › リモートデバイスを選んでも開けます。Windows では、ウィンドウのシステムメニューや、タスクバーアイコンのジャンプリストからリモートデバイスを選ぶこともできます。
-
リモートデーモンを追加を選び、続けて接続情報の下の貼り付けを選んで、入力欄を埋めます。
-
認証の下で、アカウントのパスワードでサインインするならパスワードを選びます。サーバーの提供元から代わりに鍵ファイルを渡されている場合(
id_ed25519のような名前や、.pemで終わる名前のことが多いです)は鍵ファイルを選び、このコンピューター上の場所を入力します。 -
保存を選び、続けて接続を選びます。聞かれたらパスワードを入力します。
接続情報を貼り付けた場合は、サーバーの身元(フィンガープリント)も一緒に入っているので、アプリが自動で確認します。アドレスを手で入力した場合は、初回にアプリがフィンガープリントを表示します。正しいマシンにつながったことを確かめるため、サーバー上で次のコマンドを実行して表示されるものと見比べ、一致したときだけ接続してください。
Terminal window ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
別の Octoboard ウィンドウが開いて、サーバーのプロジェクトとセッションが表示されれば成功です。
別のコンピューターをホストにする
Section titled “別のコンピューターをホストにする”Octoboard アプリが動いている Mac や Windows PC につなぐこともできます。
- つなぎたいコンピューターで、Octoboard の設定 › リモートアクセスを開きます。
- そこでシステム設定を開く(macOS)または 設定を開く(Windows)を選び、その行が示す手順に従ってリモートログイン(macOS)または OpenSSH Server(Windows)をオンにします。これで、このコンピューターが SSH でのサインインを受け付けるようになります。管理者の権限が必要です。Octoboard に戻ると、その行にオンと表示されます。
- リモートアクセスを許可をオンにし、許可を選んで確定します。Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
- Octoboard アプリタブで接続情報をコピーを選び、もう一方のコンピューターに、たとえばメールやチャットで送ります。
- 作業に使うコンピューターで、Linux サーバーに接続するの手順 2 から 5 と同じようにホストを追加し、送られてきた情報を貼り付けます。ホストのユーザー名とパスワードでサインインします。
別のウィンドウが開いて、ホストのプロジェクトとセッションが表示されれば成功です。
ブラウザから接続する
Section titled “ブラウザから接続する”-
SSH フォワードのコマンドを手に入れます。
-
ホストが Mac または Windows の場合は、まず別のコンピューターをホストにするの手順 1 から 3 を行います。続いてブラウザタブの手順 1: SSH フォワードを見ます。コマンド中のアドレスをクリックして、もう一方のコンピューターがこのコンピューターに届くときの経路を選び(またはアドレスを自分で入力を選んで、あとで
<server>を自分で置き換え)、フォワードのコマンドをコピーを選びます。さらに、手順 2: ブラウザのアドレスの下でアドレスをコピーも選びます。 -
ホストが Linux サーバーの場合は、サーバーで次のコマンドを実行します。ブラウザのアドレスに続けて、実行する SSH コマンドが表示されます。
Terminal window octoboardd addressコマンド中の
<server>を、サーバーのアドレスに置き換えます。
-
-
ブラウザを使うコンピューターで、ターミナル(macOS)または PowerShell(Windows)から SSH コマンドを実行します。パスワードを聞かれることがあり、その後は何も表示されませんが、正常です。作業している間はウィンドウを開いたままにしてください。閉じると、ブラウザの接続が切れます。
-
http://127.0.0.1:で始まるブラウザのアドレスを、ブラウザで開きます。
サインインを求められずに、ブラウザのタブで Octoboard が開けば成功です。
このアドレスを使えるのは、SSH フォワード経由で Octoboard に届く人だけです。ほかの人に知られないようにしてください。アドレスに含まれるキーでフルコントロールができ、ブラウザの履歴やブックマークに残ります。ブラウザの同期がオンなら、ほかのデバイスにも同期されます。
うまくいかないとき
Section titled “うまくいかないとき”- 「サーバーに接続できませんでした」と表示される、または SSH コマンドが「Connection refused」と表示されたりタイムアウトしたりする: ホストで SSH ログインがオフになっているか、アドレスまたは SSH ポートが違っています。リモートログインまたは OpenSSH Server がオンになっているか、上の
sshコマンドでサインインできるかを確認してください。 - 「サインインできませんでした」と表示される、または「Permission denied」と表示される: ユーザー名、パスワード、鍵ファイルのどれかが違っています。
- 「ホスト鍵が一致しません」と表示される: 応答しているマシンが、以前に接続したものと別のマシンです。サーバーを入れ直したあとに起きることがありますが、何か問題が起きている可能性もあります。理由がわかるまで、先へ進まないでください。
- ブラウザのページが開かない: SSH のウィンドウが閉じられたか、コマンドが止まっています。もう一度実行して、ページを再読み込みしてください。
セキュリティ
Section titled “セキュリティ”- 公開ポートを増やさない: Octoboard はホスト自身からの接続しか受け付けません。そのため、別のコンピューターからつなぐには、まず SSH でホストにサインインする必要があります。SSH が必要なのも、中継サービスのどれかが必要なのも、このためです。
- どのマシンにつながるかを確認する: アプリは初めて接続できたときに、ホスト鍵(マシンの SSH の身元)を記憶し、あとでその身元が変わると、警告を出して接続を止めます。
- パスワードは保存しない: パスワードまたは自分の鍵ファイルで最初にサインインしたあと、アプリはこのコンピューター専用の別の SSH 鍵を作り、以降のサインインにはそれを使います。
- コンピューターのアクセスを取り消す: ホストの、許可する SSH 鍵の一覧(Linux と macOS では
~/.ssh/authorized_keys)から、そのコンピューターのエントリを削除します。その鍵では二度とサインインできなくなります。すでに開いている接続は、終了するまで残ります。
リモートウィンドウでの操作
Section titled “リモートウィンドウでの操作”- SSH の接続先ごとに 1 つのウィンドウ: ユーザー名、ホスト、SSH ポートのどれかが違う接続は、それぞれ別のウィンドウで開きます。プロジェクト、セッション、通知が混ざることはありません。
- 接続ごとの状態を見る: macOS ではアプリのメニューバーのアイコン、Windows では通知領域のアイコンを開くと、接続ごとのタブが表示されます。
- リモートのウェブサイトをここで開く: エージェントがホスト上でウェブサイトを起動したときは、表示される
localhostのリンクをクリックします。アプリが SSH 経由で、そのウェブサイトをこのコンピューターで開きます。 - リモートのファイルをここで開く: リモートウィンドウでファイルを表示したり、コピーをダウンロードして、このコンピューターでそのファイルの既定のアプリで開いたりできます。
- 自動で再接続する: ネットワークが切れても、つながるか、ウィンドウを閉じるまで、ウィンドウが再接続を試み続けます。