> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 用 CLI 设置自定义域名

> 在终端中为 Square Cloud 网站绑定自定义域名，查看需要创建的 DNS 记录，并列出账户下所有域名和共享域名。

设置自定义域名分两步：先用 `app network domain` 把域名绑定到应用，再在你的 DNS 服务商处创建 `app network dns` 打印出的 DNS 记录。帮助中心提供了[分步的自定义域名指南](https://help.squarecloud.app/en-us/article/how-to-set-up-your-own-domain-cnamedns-1fzbrgh/)，并解释了[为什么域名需要一段时间才能生效](https://help.squarecloud.app/en-us/article/why-hasnt-my-domain-propagated-yet-dns-f5jzoy/)。

`[appID]` 和 `--app` 是可选的：参见 [CLI 如何找到你的应用](/zh/cli-reference/quickstart#cli-如何找到你的应用)。

## `squarecloud app network domain`

```bash 用法 theme={"system"}
squarecloud app network domain <hostname> [--app <appID>]
```

设置应用的自定义域名，替换之前的域名。Standard、Pro 和 Enterprise 套餐可以使用自定义域名。要移除自定义域名，请把 `@` 作为主机名传入。

```bash theme={"system"}
squarecloud app network domain www.example.com
```

```bash 输出 theme={"system"}
✓ Custom domain www.example.com configured successfully
Run 'squarecloud app network dns' to see the DNS records you need to create.
```

## `squarecloud app network dns`

```bash 用法 theme={"system"}
squarecloud app network dns [appID] [--json]
```

打印自定义域名需要创建的 DNS 记录，包括每条记录的类型、名称、值和状态。没有自定义域名时，它会提示你先配置一个。

## `squarecloud app domains`

```bash 用法 theme={"system"}
squarecloud app domains [--json]
```

列出你所有应用中已配置的每个域名：主机名、类型以及所属应用的 ID。

## `squarecloud app load-balancers`

```bash 用法 theme={"system"}
squarecloud app load-balancers [--json]
```

**别名：** `lb`

列出绑定到多个应用的自定义域名（负载均衡器），按主机名分组，并附带共用该域名的每个应用的 ID、名称和集群。输出开头会显示你的套餐允许每个域名绑定多少个应用。

```bash theme={"system"}
squarecloud app lb --json
# 以 JSON 格式打印原始负载均衡器列表。
```

## 相关内容

| 命令 | API | JavaScript SDK |
| - | - | - |
| `network domain` | [`POST .../network/custom`](/zh/api-reference/endpoint/apps/network/custom) | [`api.apps.network.setDomain()`](/zh/sdks/js/network) |
| `network dns` | [`GET .../network/dns`](/zh/api-reference/endpoint/apps/network/dns) | [`api.apps.network.dns()`](/zh/sdks/js/network) |
| `domains` | [`GET /v2/apps/domains`](/zh/api-reference/endpoint/apps/domains) | [`api.apps.domains()`](/zh/sdks/js/managing_application) |
| `load-balancers` | [`GET /v2/apps/load-balancers`](/zh/api-reference/endpoint/apps/network/load-balancers) | [`api.apps.loadBalancers()`](/zh/sdks/js/managing_application) |

网站的流量、错误和缓存请参阅[边缘分析](/zh/cli-reference/edge-analytics)。