安装 Aqua | Mister Morph

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. 快速开始（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 快速开始（跨网络）

使用 --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. 快速开始（Machine A / Machine B）

4. Relay 快速开始（跨网络）

5. 数据目录

6. 参考