# 客户端管理

> 添加用户、分享连接信息和管理访问密钥。

## 添加客户端

```
meridian client add alice
```

这会为"alice"创建一个唯一的连接密钥并显示：
- **终端中的二维码** — 用 VPN 应用扫描它即可立即连接
- **连接 URL** — 每个协议的 VLESS 链接（Reality、XHTTP 和 WSS（如果启用了域名模式））
- **可共享的页面 URL** — 托管在您的服务器上，可通过任何信使发送
- **本地保存的 HTML 文件** — 离线共享的备份

### 收件人看到的内容

可共享的 URL 打开一个连接页面，包括：
- 安装 VPN 应用（v2RayTun、v2rayNG、Hiddify 或 v2rayN）的分步说明
- 每个连接协议的二维码
- 一键"在应用中打开"的深度链接
- 连接状态和使用统计

通过电子邮件、iMessage、Telegram 或任何信使发送该 URL。收件人打开它、安装应用、扫描二维码并连接。无需任何技术知识。

## 显示连接信息

要在任何时候重新显示现有客户端的连接信息：

```
meridian client show alice
```

这会输出相同的二维码、连接 URL 和可共享的页面链接——不会创建新密钥。在以下情况下使用：
- 您需要与某人重新分享连接页面
- 您丢失了原始二维码或 HTML 文件
- 您想验证客户端的连接看起来如何

## 列出客户端

```
meridian client list
```

显示所有客户端及其协议连接（Reality、XHTTP、WSS）。

## 删除客户端

```
meridian client remove alice
```

立即撤销访问权限。客户端的 UUID 将从服务器上的所有入站中删除。

## 多服务器

使用 `--server` 来针对特定的命名服务器：

```
meridian client add alice --server finland
meridian client show alice --server finland
meridian client list --server finland
```

如果您只有一个服务器，它会自动选择。

## 凭证存储位置

当您从笔记本电脑运行 `meridian deploy` 时，Meridian 会在本地保存服务器凭证：

```
~/.meridian/credentials/<IP>/proxy.yml   # 密钥、UUID、面板访问
~/.meridian/servers                      # 服务器注册表
```

在服务器上，相同的数据存储在 `/etc/meridian/proxy.yml`。Meridian 在 `client add` 和 `client remove` 后自动同步。

因此 `meridian client add alice` 不需要指定服务器 — Meridian 会在本地注册表中查找。如果有多个服务器，使用 `--server NAME`。

如果凭证不同步（例如从另一台机器添加了客户端），`client show` 会自动从服务器面板恢复数据。

## Web 管理面板

Meridian 部署 3x-ui 管理面板用于流量监控。通过凭证中显示的秘密 HTTPS 路径访问：

```
cat ~/.meridian/credentials/<IP>/proxy.yml | grep -A5 panel
```

面板 URL、用户名和密码列在其中。不需要 SSH 隧道 — nginx 通过随机 HTTPS 路径反向代理面板。

## 工作原理

客户端名称映射到带有协议前缀的 3x-ui `email` 字段：
- `reality-alice` — Reality 入站
- `xhttp-alice` — XHTTP 入站
- `wss-alice` — WSS 入站（域名模式）

每个客户端在服务器上所有入站中获得唯一的 UUID。