Aqua のインストール

1. Aqua をインストール

方法 A: release インストーラースクリプト。

curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/aqua/refs/heads/master/scripts/install.sh; \
sudo bash /tmp/install.sh

方法 B: Go でソースからインストール。

go install github.com/quailyquaily/aqua/cmd/aqua@latest

2. インストール確認とニックネーム設定

aqua version
aqua id &lt;ニックネーム&gt;

aqua version が返れば導入完了です。

3. Quick Start（Machine A / Machine B）

Machine A	Machine B
`aqua id alice`, note `<A_PEER_ID>`	`aqua id bob`, note `<B_PEER_ID>`
`aqua serve` copy one `address: ...` as `<A_ADDR>`	`aqua serve` copy one `address: ...` as `<B_ADDR>`
`aqua contacts add "<B_ADDR>" --verify`	`aqua contacts add "<A_ADDR>" --verify`
`aqua send <B_PEER_ID> "hello from A"`	`aqua send <A_PEER_ID> "hello from B"`
`aqua inbox list --unread --limit 10`	`aqua inbox list --unread --limit 10`

4. Relay Quick Start（跨ネットワーク）

--relay-mode auto を使うと、Aqua はまず直結を試し、不可なら relay に自動フォールバックします。

# 1) 各ノードで peer ID を取得
aqua id &lt;nickname&gt;

# 2) relay endpoint 付きで起動
aqua serve --relay-mode auto \
  --relay /dns4/&lt;relay-host&gt;/tcp/6372/p2p/&lt;relay_peer_id&gt; \
  --relay /dns4/&lt;relay-host&gt;/udp/6372/quic-v1/p2p/&lt;relay_peer_id&gt;

# 3) 相手の relay-circuit アドレスを追加
aqua contacts add &#34;&lt;peer_relay_circuit_addr&gt;&#34; --verify

# 4) メッセージ送信
aqua send &lt;peer_id&gt; &#34;hello via relay&#34;

公式 relay endpoints:

TCP: /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E
UDP (QUIC): /dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E

5. データディレクトリ

デフォルト: ~/.aqua

上書き方法:

--dir <path>
環境変数 AQUA_DIR

1. Aqua をインストール

2. インストール確認とニックネーム設定

3. Quick Start（Machine A / Machine B）

4. Relay Quick Start（跨ネットワーク）

5. データディレクトリ

6. 参照