クイックスタート

イントロダクション

2台のデバイスを安全なプライベートネットワークに接続する方法を紹介します。今回の例では、1台をMac、もう1台をクラウド上で動作するLinuxを利用していきます。

現在、CLIを利用したインストール方法のみに対応しています。macOS、Windows、Linuxのデスクトップアプリは、2025年2月中旬にリリース予定です。

Step 1: SSOログインでアカウントを登録する

お好きなSSOアカウントを利用して、ユーザー登録を完了します。2025年2月現在、Google・Microsoft・GitHubに対応しています。2025年3月をめどに、Okta・OneLoginなどのIDaaSに対応予定です。

Step 2: インストールコマンドを実行

SSOログインが成功したら、Runetaleクライアントをデバイスにダウンロードします。

Ubuntu

curl -fsSL http://pkgs.runetale.com/linux/install.sh | sudo sh

MacOS

curl -fsSL http://pkgs.runetale.com/macos/install.sh | sudo sh install.sh

パッケージがインストールされたら、以下のコマンドでログインしてください。端末にログインURLが表示されているのを確認。正常に表示されていたら、URLをクリックしブラウザでセッションを完了します。

sudo runetale login

端末にログインURLが表示されているのを確認。正常に表示されていたら、URLをクリックしブラウザでセッションを完了します。セッションを完了すると端末にこのようなメッセージが表示されます。

Your runetale ip => [100.105.218.190/16]
Successful login
2025-02-02T19:31:57.559+0900    info    runetale login  Successfull Login, Your Node IP => 100.105.218.190/16

Successful loginと表示されていることが確認できれば、ログインは成功しています。 IPアドレスも表示されていることも確認してください。

続いて、sudo runetaled upを実行してRunetaleを起動します。

sudo runetaled up -userspace-networking=true -daemon=false

デーモンによる動作

システムのバックグラウンドでrunetaleを動作することが可能で、デフォルトでONになっています。

このようなログが表示されると、問題なく動作しています。

2025-02-02T20:49:45.376+0900    info    runetaled up    HashiLocalBackend.SetControlClientStatus Send From UpdateNetworkMap
2025-02-02T20:49:45.377+0900    info    runetaled up    [v2] netstack: registered IP 100.105.218.190/32
2025-02-02T20:49:45.377+0900    info    runetaled up    Wonderwall: SetNetworkMap
2025-02-02T20:49:45.377+0900    info    runetaled up    HashiLocalBackend Completed NetworkMap
2025-02-02T20:49:45.377+0900    info    runetaled up    HashiLocalBackend: Set Completed Packet Filter
2025-02-02T20:49:45.377+0900    info    runetaled up    ReICE reason 'reconfig-userspace'
2025-02-02T20:49:45.426+0900    info    runetaled up    SEND INITIAL OFFER
2025-02-02T20:49:45.426+0900    info    runetaled up    START GATHERING FOR REMOTE NODE => [Qs7tOO2YqbdFedNan73MC9C2ZFRNvBWvyF3HsHu4FnM=]
2025-02-02T20:49:45.471+0900    info    runetaled up    SEND INITIAL OFFER
2025-02-02T20:49:45.471+0900    info    runetaled up    START GATHERING FOR REMOTE NODE => [d3V9Hq1qzdmYwRqPHdPpe8J49rlGQATZhQ/hdC8lNTY=]
2025-02-02T20:49:45.471+0900    info    runetaled up    UpdateIces Status {3 0 0}
2025-02-02T20:49:45.529+0900    info    runetaled up    SEND INITIAL OFFER
2025-02-02T20:49:45.529+0900    info    runetaled up    START GATHERING FOR REMOTE NODE => [Wg1qPrU2FIY3SR3nOV5FCAMA21xZcvF0k1zWVs+QZFM=]
2025-02-02T20:49:45.566+0900    info    runetaled up    PeerAPI: serving on http://100.105.218.190:56459
2025-02-02T20:49:45.566+0900    info    runetaled up    HashiLocalBackend.SetControlClientStatus Complete Set NetMap

デーモンで実行した場合は、お使いのデーモンプロセスの確認コマンドを実行してください。

Linux

sudo systemctl status runetale.service

以下のメッセージを確認できれば、システムが正しく動いています。

● runetale.service - runetale daemon
     Loaded: loaded (/etc/systemd/system/runetaled.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2024-09-23 09:49:46 JST; 6h ago
   Main PID: 175492 (runetaled)
      Tasks: 22 (limit: 76989)
     Memory: 8.1M
     CGroup: /system.slice/runetale.service
             └─175492 /usr/bin/runetaler up -daemon=false

リモートの環境でも、同じセットアップを繰り返します。
完了したら、立ち上げに成功した2つのデバイスがダッシュボードに表示されてることを確認してください。

デバイス

リソース

Step 3: 接続状態の確認

次にローカルから設定したノードに対してpingを実行します。初期設定のアクセスコントロールは、すべてのトラフィックを拒否する仕様となっています。

そのため、どちらのデバイスもPingが通らないことを確認してください。

MacからPing

ping 100.105.200.20

LinuxからPing

ping 100.105.218.190

Step 4: アクセスコントロールの設定

デバイスの接続を許可するために、アクセスコントロールを設定します。

まずダッシュボードにアクセスして、Create New ACL+をクリックします。

次にアクセスコントロールの名前を設定し、通信元となるノードと通信先となるノードを選択します。今回はMacを通信元、Linuxを通信先として設定します。

最後に通信プロトコルの設定を行います。今回はPingを行いたいためICMPv4を選択します。

全て設定できたら、Previewをクリックし作成をクリックします。

Step 5: 通信の確認をする

アクセスコントロールで設定されている内容が、正しく動作しているか確認します。

MacとLinuxでrunetaledを立ち上げます。

sudo runetaled up -userspace-networking=false -daemon=false

Macの端末でLinuxに対してPingを送信します。

ping 100.105.200.20

Pingが通っていることが確認できれば成功です🎉

これでRunetaleのセットアップは完了です！ WireGuardをベースとした、P2P型プライベートネットワークが構成されました。

トラブルシューティング

上手くRunetaleが立ち上がらないなど問題があれば、support@runetale.comまでお問い合わせください。

クイックスタート

On this page