---
title: 自定义域名
description: 使用你自己的主机名而非 lida.sh 提供链接。Free 套餐包含 1 个自定义域名。
sidebar:
  label: 域名
  order: 7
---
Free 套餐包含 1 个自定义域名，Professional 套餐包含 5 个，Growth 套餐不限数量。详见[定价](/zh/pricing)。

自动生成的 ID 与 `lida.sh` 上的 slug 共用同一个公共命名空间，每个自定义域名则各自拥有独立的命名空间。使用品牌域名创建的链接不会同时发布到 `lida.sh` 上。如果某个词在 `lida.sh` 上已被占用，可以添加一个主机名，然后使用 `--domain` 重试。

## CLI

```bash
linkdash domains add docs.example.com
linkdash domains connect docs.example.com
linkdash domains verify docs.example.com
linkdash domains list
linkdash domains remove docs.example.com
```

先配置 DNS（CNAME 或根域名 ALIAS 记录，再加上 Unkey 返回的 TXT 记录），然后进行验证。如果 Unkey 返回了应用 URL（适用于 Cloudflare、Vercel DNS 等服务商），域名功能会提供一键式 Domain Connect 配置。`domains connect` / `GET /domains/:host/connect` 会返回该应用 URL，没有时返回 `null`。对于其他所有服务商，按 add 返回的记录手动配置同样可行。在创建或更新链接时，通过 `--domain` 指定域名：

```bash
linkdash links create --url https://example.com --slug welcome --domain go.example.com
```

## HTTP

```bash
POST /domains          { "hostname": "docs.example.com" }
GET /domains/:host/connect
POST /domains/:host/verify
DELETE /domains/:host
GET /domains
```

添加域名后，按返回结果创建 DNS 记录（CNAME 或 ALIAS，再加上 TXT），然后进行验证。在创建或更新链接时，通过 JSON 中的 `domain` 字段指定域名。
