コンテンツにスキップ
Octoboard ドキュメント

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 用です。ブラウザだけで使う場合は不要です。

  1. Octoboard を動かしているユーザーとしてサーバーに SSH でサインインし、次のコマンドを実行して、octoboard+ssh:// で始まる行をコピーします。これは接続情報で、アプリに、どこへどうやってつなぐかを伝えるものです。

    Terminal window
    octoboardd connection

    このコンピューターからサーバーへ別のアドレスや SSH ポートでつなぐ場合は、コマンドに --host または --ssh-port を付けると、正しい接続情報が表示されます。

    あわせて QR コードも表示されます。中身は同じ行ですが、読み取れるアプリはまだありません。

  2. このコンピューターの Octoboard アプリで、左側のレールからリモートデバイスを開きます。macOS ではメニューバーからリモート › リモートデバイスを選んでも開けます。Windows では、ウィンドウのシステムメニューや、タスクバーアイコンのジャンプリストからリモートデバイスを選ぶこともできます。

  3. リモートデーモンを追加を選び、続けて接続情報の下の貼り付けを選んで、入力欄を埋めます。

  4. 認証の下で、アカウントのパスワードでサインインするならパスワードを選びます。サーバーの提供元から代わりに鍵ファイルを渡されている場合(id_ed25519 のような名前や、.pem で終わる名前のことが多いです)は鍵ファイルを選び、このコンピューター上の場所を入力します。

  5. 保存を選び、続けて接続を選びます。聞かれたらパスワードを入力します。

    接続情報を貼り付けた場合は、サーバーの身元(フィンガープリント)も一緒に入っているので、アプリが自動で確認します。アドレスを手で入力した場合は、初回にアプリがフィンガープリントを表示します。正しいマシンにつながったことを確かめるため、サーバー上で次のコマンドを実行して表示されるものと見比べ、一致したときだけ接続してください。

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

別の Octoboard ウィンドウが開いて、サーバーのプロジェクトとセッションが表示されれば成功です。

別のコンピューターをホストにする

Section titled “別のコンピューターをホストにする”

Octoboard アプリが動いている Mac や Windows PC につなぐこともできます。

  1. つなぎたいコンピューターで、Octoboard の設定 › リモートアクセスを開きます。
  2. そこでシステム設定を開く(macOS)または 設定を開く(Windows)を選び、その行が示す手順に従ってリモートログイン(macOS)または OpenSSH Server(Windows)をオンにします。これで、このコンピューターが SSH でのサインインを受け付けるようになります。管理者の権限が必要です。Octoboard に戻ると、その行にオンと表示されます。
  3. リモートアクセスを許可をオンにし、許可を選んで確定します。Octoboard は起動したままにしてください。終了すると、リモートアクセスも止まります。
  4. Octoboard アプリタブで接続情報をコピーを選び、もう一方のコンピューターに、たとえばメールやチャットで送ります。
  5. 作業に使うコンピューターで、Linux サーバーに接続するの手順 2 から 5 と同じようにホストを追加し、送られてきた情報を貼り付けます。ホストのユーザー名とパスワードでサインインします。

別のウィンドウが開いて、ホストのプロジェクトとセッションが表示されれば成功です。

  1. SSH フォワードのコマンドを手に入れます。

    • ホストが Mac または Windows の場合は、まず別のコンピューターをホストにするの手順 1 から 3 を行います。続いてブラウザタブの手順 1: SSH フォワードを見ます。コマンド中のアドレスをクリックして、もう一方のコンピューターがこのコンピューターに届くときの経路を選び(またはアドレスを自分で入力を選んで、あとで <server> を自分で置き換え)、フォワードのコマンドをコピーを選びます。さらに、手順 2: ブラウザのアドレスの下でアドレスをコピーも選びます。

    • ホストが Linux サーバーの場合は、サーバーで次のコマンドを実行します。ブラウザのアドレスに続けて、実行する SSH コマンドが表示されます。

      Terminal window
      octoboardd address

      コマンド中の <server> を、サーバーのアドレスに置き換えます。

  2. ブラウザを使うコンピューターで、ターミナル(macOS)または PowerShell(Windows)から SSH コマンドを実行します。パスワードを聞かれることがあり、その後は何も表示されませんが、正常です。作業している間はウィンドウを開いたままにしてください。閉じると、ブラウザの接続が切れます。

  3. http://127.0.0.1: で始まるブラウザのアドレスを、ブラウザで開きます。

サインインを求められずに、ブラウザのタブで Octoboard が開けば成功です。

このアドレスを使えるのは、SSH フォワード経由で Octoboard に届く人だけです。ほかの人に知られないようにしてください。アドレスに含まれるキーでフルコントロールができ、ブラウザの履歴やブックマークに残ります。ブラウザの同期がオンなら、ほかのデバイスにも同期されます。

  • 「サーバーに接続できませんでした」と表示される、または SSH コマンドが「Connection refused」と表示されたりタイムアウトしたりする: ホストで SSH ログインがオフになっているか、アドレスまたは SSH ポートが違っています。リモートログインまたは OpenSSH Server がオンになっているか、上の ssh コマンドでサインインできるかを確認してください。
  • 「サインインできませんでした」と表示される、または「Permission denied」と表示される: ユーザー名、パスワード、鍵ファイルのどれかが違っています。
  • 「ホスト鍵が一致しません」と表示される: 応答しているマシンが、以前に接続したものと別のマシンです。サーバーを入れ直したあとに起きることがありますが、何か問題が起きている可能性もあります。理由がわかるまで、先へ進まないでください。
  • ブラウザのページが開かない: SSH のウィンドウが閉じられたか、コマンドが止まっています。もう一度実行して、ページを再読み込みしてください。
  • 公開ポートを増やさない: Octoboard はホスト自身からの接続しか受け付けません。そのため、別のコンピューターからつなぐには、まず SSH でホストにサインインする必要があります。SSH が必要なのも、中継サービスのどれかが必要なのも、このためです。
  • どのマシンにつながるかを確認する: アプリは初めて接続できたときに、ホスト鍵(マシンの SSH の身元)を記憶し、あとでその身元が変わると、警告を出して接続を止めます。
  • パスワードは保存しない: パスワードまたは自分の鍵ファイルで最初にサインインしたあと、アプリはこのコンピューター専用の別の SSH 鍵を作り、以降のサインインにはそれを使います。
  • コンピューターのアクセスを取り消す: ホストの、許可する SSH 鍵の一覧(Linux と macOS では ~/.ssh/authorized_keys)から、そのコンピューターのエントリを削除します。その鍵では二度とサインインできなくなります。すでに開いている接続は、終了するまで残ります。
  • SSH の接続先ごとに 1 つのウィンドウ: ユーザー名、ホスト、SSH ポートのどれかが違う接続は、それぞれ別のウィンドウで開きます。プロジェクト、セッション、通知が混ざることはありません。
  • 接続ごとの状態を見る: macOS ではアプリのメニューバーのアイコン、Windows では通知領域のアイコンを開くと、接続ごとのタブが表示されます。
  • リモートのウェブサイトをここで開く: エージェントがホスト上でウェブサイトを起動したときは、表示される localhost のリンクをクリックします。アプリが SSH 経由で、そのウェブサイトをこのコンピューターで開きます。
  • リモートのファイルをここで開く: リモートウィンドウでファイルを表示したり、コピーをダウンロードして、このコンピューターでそのファイルの既定のアプリで開いたりできます。
  • 自動で再接続する: ネットワークが切れても、つながるか、ウィンドウを閉じるまで、ウィンドウが再接続を試み続けます。