メインのマシンは NAT の内側に置けます。ポートは誰も開けません。

メインのマシンにする。

メインのマシンにするマシンで、ターミナルから一度だけ実行します。ダッシュボードにはこのためのボタンがありません。home は自分で決める名前です。最初にこれを行ってください。下のリレーのコマンドは、メインのマシンでしか動きません。

リレーをオンにする。

マシンに harnsy Max のキー（ライセンスのページ）が必要です。このコマンドは、当社のホスト型リレー（ベータ版）を使います。

このマシンで harnsy を再起動する。

動作中のメインのマシンは、リレーの設定を起動時にしか読みません。反映するには harnsy を再起動してください。Linux：systemctl --user restart harnsy.service。macOS：launchctl kickstart -k gui/$(id -u)/com.github.butschster.harnsy。Windows：schtasks /End /TN harnsy、続けて schtasks /Run /TN harnsy。

相手のマシン用に参加用の行を発行する。

ダッシュボードで Nodes を開き、“Add to the cluster” を選びます。“Node” を選び、マシンに名前を付け（例：server）、権限を設定して、“Master address” は空のままにします。そうすると、行にリレーのアドレスが入ります。“Issue token” を押します。“manage” はメインのマシンのシェルへのアクセスです。自分のマシンにだけ与えてください。

見えるもの “Shown once. Copy it now.” と “Run this on server.” が表示され、その下に harnsy debug cluster init server --join harnsy-relay://… --token <token> の行が出ます。

リレーがつながっているか確認する。

メインのマシンで Nodes を開きます。リレーのパネルは、参加トークンができ、ライセンスがほかのマシンを許可するまで “waiting” と表示します。ターミナルでは、コマンドがリレーと、メンバーが参加するアドレスを表示します。

見えるもの “connected since …”、“address for members”（harnsy-relay://…）、そして “relay access: renews automatically” が見えます。

もう一方のマシンで参加する。

もう一方のマシンのダッシュボードで Nodes を開き、“Join a master” を選び、行を貼り付けて “Join” を押します。ターミナルで行を実行しても構いません。行は全部貼り付けてください。ピンのない、リレー経由の参加は拒否されます。

見えるもの “Joined … connecting…” と表示されます。メインのマシンでは、メンバーが Nodes の一覧に現れ、その行に “route: via relay …” と出ます。

メインのマシンを用意する。

ケース1と同じように設定するか、同僚が到達できるアドレスを持つメインのマシンを使います。

同僚がどの harnsy Max を使うか決める。

自分の harnsy Max のキーを持つマシンは、席を使いません。持たないマシンは、空きの席があるあいだ、メインのマシンから harnsy Max を借ります。席の数はあなたのキーで決まります。

見えるもの License の “Seats for connected machines” パネルに、“Taken: 1 of 3.” と出ます。

同僚のトークンを発行する。

ダッシュボードで：Nodes → “Add to the cluster”、“Node”、相手のマシンの名前、権限、“Issue token”。必要なものだけ渡してください。read と send です。“manage” はあなたのシェルへのアクセスです。

見えるもの トークンは一度だけ表示されます：“Shown once. Copy it now.”

行を、非公開で渡す。

その行には秘密であるトークンが入っています。メインのマシンのピンも入っているので、相手のマシンは、話している相手があなたのマシンだと確認できます。

同僚が参加する。

相手のマシンで：Nodes → “Join a master”、行を貼り付けて、“Join”。ターミナルで行を実行しても構いません。

見えるもの “Connected.” 自分のキーがなく、メインのマシンにも空きの席がない場合は：“Connected. The master has not lent harnsy Max yet: its license may have no free seat.”

確認する。

メインのマシンの Nodes の一覧に、同僚のマシンが出ます。席を借りていれば、License で使用中として表示されます。メインのマシンには、相手のエージェント名、ハーネス、状態、フォルダーが見えます。ログインは相手のマシンに残ります。

サーバーがメンバーの場合：直接参加させる。

メンバーは常に自分から接続し、ポートを開けません。そのため、NAT やファイアウォールの内側のサーバーも、到達できるメインのマシンに直接参加できます。トークンを発行し、ケース2と同じように参加します。

サーバーがメインのマシンの場合：リレーを使う。

サーバー自身がメインのマシンで、ほかから到達できないなら、ケース1と同じように設定します。メンバーはリレーのアドレス経由でそれに参加し、ポートは開きません。

ケース1と同じようにリレーを設定する。

ケース1の手順1と2です。再起動はこの次です。

直接のメンバーのためにクラスターのポートを開く。

これが必要なのは同じネットワークのマシンだけです。リレー経由のメンバーしかいないメインのマシンには、開いたポートは要りません。クラスターのアドレスを付けて、インストーラーをもう一度実行します。サービスが書き換えられて harnsy が再起動します。これはリレーの設定に必要な再起動も兼ねます。0.0.0.0 はこのマシンのすべてのアドレスを意味します。自分のネットワークだけにポートを開くには、そこでのマシンのアドレス（例：192.168.1.10:7789）を指定します。このポートは、それ自身で TLS を提供します。

リレー経由のメンバーのトークンを発行する。

“Master address” は空のままにします。行にリレーのアドレスが入ります。

直接のメンバーのトークンを発行する。

“Master address” に、自分のネットワーク上でのメインのマシンのアドレスを入れます。

各マシンに、それぞれの行で参加させる。

ケース1の手順6と同じです。それぞれのマシンで行います。

見えるもの Nodes の各行に経路が出ます：“via relay …” または “direct, port 7789”。

そのトークンを探す。

メインのマシンで：Nodes → メンバーのトークンの横の “revoke”。これで完了です。ターミナルでは、先にトークンの一覧を出します。

ターミナルで、番号を指定して取り消す。

番号は一覧から取ります。

見えるもの ダッシュボードで取り消すとメンバーの接続はすぐに閉じ、ターミナルからでは20秒以内に閉じます。そのメンバー宛てに溜まっていたものは破棄されます。席はその時点で空きます。License の使用中の数が1つ減ります。harnsy Max を借りていたメンバーは、最後の付与が切れるまで、最長3日間それを使えます。