インストールスクリプトの内容
🚫
このページは情報提供のみを目的としています。 ここに記載されているコマンドを手動で実行しないでください。必ず Zeabur コンソールで提供されるインストールスクリプトを使用してください。 コマンドを順序通りに実行しないと、マシンが壊れた状態になる可能性があります。
このページでは、Wonder Mesh インストールスクリプトがマシンに対して行う処理を正確に説明します。私たちは完全な透明性を信条としています。実行前に、ハードウェア上で何が動作するかを把握しておくべきです。
スクリプトは root 権限(sudo bash)で実行され、以下の手順を行います:
1. Tailscale のインストール
- 公式 Tailscale インストールスクリプトをダウンロードして実行します
- システムのパッケージマネージャー(apt、dnf、yum など)を通じて
tailscaleパッケージをインストールします tailscaledsystemd サービスを有効化して起動します(起動時に自動起動)
⚠️
すでに Tailscale がインストールされ、別のネットワークに接続されている場合、この手順で既存の Tailscale 設定が上書きされます。
2. Wonder バイナリのダウンロード
cdn.zeabur.comから Wonder Mesh クライアントをダウンロードします/usr/local/bin/wonderに配置し、実行可能にします
3. メッシュネットワークへの参加
wonder worker joinを実行して、プライベートな WireGuard ベースのメッシュネットワークにデバイスを接続します- メッシュネットワークは Zeabur がホストする Headscale コーディネーションサーバーによって管理されます
- デバイスには
100.x.x.x範囲の Mesh IP アドレスが割り当てられます
4. SSH のインストールと設定
openssh-serverがインストールされていない場合はインストールしますsshdsystemd サービスを有効化して起動します- パスワード認証を有効にするために SSH 設定を変更します:
/etc/ssh/sshd_configを編集してPasswordAuthentication yesを設定します/etc/ssh/sshd_config.d/00-zeabur-password-auth.confをドロップインオーバーライドとして作成します
⚠️
以前 SSH パスワード認証を無効にしている場合(鍵認証のみ)、この変更により再度有効になります。SSH ポートはメッシュネットワーク経由でのみ到達可能で、パブリックインターネットからはアクセスできません。
5. システムユーザーの作成
zeaburユーザーが存在しない場合、/bin/bashをシェルとして作成します- ランダムに生成されたパスワードを設定します
sudo(またはwheel)グループに追加します/etc/sudoers.d/zeaburを作成し、パスワードなしの sudo アクセスを付与します
⚠️
zeabur ユーザーのパスワードを手動で変更しないでください。Zeabur はこの資格情報を使用して SSH 経由でデバイスを管理しています。変更すると接続が切断され、デプロイメントができなくなります。
6. Zeabur への報告
- Mesh IP(
tailscale ip -4)とパブリック IP(curl ifconfig.me)を取得します - Mesh IP、SSH 資格情報、パブリック IP を Zeabur API に送信します
- これにより、Zeabur はメッシュネットワーク経由の SSH でデバイス上のデプロイメントを管理できるようになります
7. 進捗報告
各ステップの進捗はリアルタイムで Zeabur API に報告されるため、コンソールからインストールを監視できます。エラーが発生した場合、エラー出力の最後の数行が報告されます。
追加されるファイルとサービス(Linux)
| 種類 | パス / 名前 | 説明 |
|---|---|---|
| バイナリ | /usr/local/bin/wonder | Wonder Mesh クライアント |
| パッケージ | tailscale | メッシュネットワーキング(WireGuard) |
| パッケージ | openssh-server(未インストールの場合) | SSH サーバー |
| 設定 | /etc/ssh/sshd_config.d/00-zeabur-password-auth.conf | パスワード認証を有効化 |
| 設定 | /etc/sudoers.d/zeabur | zeabur ユーザーのパスワードなし sudo |
| ログ | /tmp/zeabur-install.log | インストールログ |
| システムサービス | tailscaled | Tailscale デーモン(起動時に自動起動) |
| システムサービス | sshd | SSH デーモン(起動時に自動起動) |
| システムユーザー | zeabur | sudo アクセス権を持つユーザー |
ネットワーク変更(Linux)
| 変更 | 説明 |
|---|---|
| WireGuard トンネル | 100.x.x.x IP を持つメッシュネットワークインターフェースを追加 |
| Tailscale コントロールサーバー | Zeabur の Headscale インスタンスを指す(公式 Tailscale サービスではない) |
| SSH ポート 22 | メッシュネットワーク経由でパスワード認証によりアクセス可能 |
| アウトバウンド接続 | インストール中に tailscale.com、cdn.zeabur.com、wonder-net.strrl.dev、api.zeabur.com、ifconfig.me に接続。セットアップ後は、メッシュネットワーキングとプラットフォーム通信のために Tailscale コーディネーションサーバーと api.zeabur.com への継続的な接続が維持されます。 |