---
title: 共享与访问权限
description: 每个链接、文件、片段和文件夹默认都是受限的。你可以通过邮箱共享给他人，向所有知道链接的人开放，或通过短链接设为公开。
sidebar:
  label: 共享
  order: 6.5
---
每个链接、文件、片段和文件夹都有一个访问级别。新建的项目默认为**受限**：只有你和你共享给的人可以打开。

## 访问级别

| 访问级别 | 谁可以打开 | 打开位置 |
| --- | --- | --- |
| **受限**（默认） | 你以及你共享给的人，需登录 | `https://linkdash.dev/s/<token>` |
| **知道链接的任何人**（`link`） | 任何拥有该 URL 的人 | `https://linkdash.dev/s/<token>` |
| **公开**（`public`） | 任何人 | 短链接，即 `lida.sh/<slug>` 或你的自定义域名 |

- **共享 URL。** token 由 24 个随机小写字母和数字组成，因此无法被猜中。对于受限项目，其他所有人（未登录，或登录了其他账号）看到的都是与不存在的 URL 相同的“未找到”页面。
- **知道链接的任何人**不会被搜索引擎收录，但在聊天中仍会展开显示其社交预览。
- **公开**就是引入访问级别之前链接的工作方式。在此之前创建的链接均为公开，它们的行为没有任何变化。
- **所有入口默认都是受限**：控制台、CLI、HTTP API、MCP，以及 `access` 列为空的 CSV 导入。对于需要公开发布的链接，请使用公开级别：社交媒体帖子、个人简介、新闻通讯、印刷的二维码。
- **slug 依然是标识。** 当链接不是公开状态时，其短链接返回 404，但该 slug 仍为它保留。重新设为公开后，同一个短链接（以及任何已印刷的二维码）即可再次使用。
- **`url` 随访问级别变化。** 创建、获取、列出、更新、复制和共享操作的响应中，除非链接为公开（此时返回短链接），否则都返回共享 URL。响应中还会包含 `access`。

## 共享给他人

你可以邀请任意邮箱地址，无论对方是否拥有 Linkdash 账号。每位被邀请的人都会收到一封包含该链接的邀请邮件。

- 已有账号的人会立即获得访问权限。
- 没有账号的人在注册并验证该邮箱后获得访问权限。
- 每个项目最多 200 人，每次邀请最多 50 个邮箱，每个账号每天最多发送 100 封邀请邮件。

你共享给的人默认是**查看者**，除非你将其设为**编辑者**（见下文）。他们可以在控制台的 **资料库 → 共享** 和 **权限 → 与我共享** 中找到该项目，并通过其共享 URL 打开。在控制台中，他们能以只读方式看到该项目的配置：

- 每个变体及其目标地址、条件、权重和状态
- 各项限制：是否设置了密码、开始时间、过期时间、打开次数上限、粘性分配和参数透传
- 对于文件夹，其中包含的项目

他们永远看不到统计数据、密码、你的私有名称、标签，也看不到还有谁拥有访问权限。受密码保护的目标地址会保持隐藏，直到他们输入与访客相同的密码。查看者无法编辑、共享或删除。他们看到的是项目的预览名称、文件夹名称或文件名，绝不会是你的私有名称。

## 编辑者

邀请他人时选择 **编辑者**，或在**共享**对话框中更改某人的角色。编辑者可以：

- 修改项目设置：名称、标签、预览、开始时间、过期时间、打开次数上限、粘性分配、参数透传以及暂停
- 添加、修改和删除变体，以及替换文件
- 查看其统计数据和 **动态**：谁修改了什么
- 在共享文件夹中添加链接和文件夹。这些内容归文件夹所有者所有，并计入所有者的套餐额度。

编辑者永远无法添加、修改或删除密码，也无法更改 slug、域名或通用访问级别，无法共享、删除、移动或复制。他们的修改会作为事件计入所有者的账号。

**密码。** 受密码保护的目标地址对编辑者同样隐藏，与查看者相同。编辑者输入与访客相同的密码后，可在 30 分钟内查看并修改该变体。每人每个项目每小时最多可输错 10 次密码，超过后在该小时剩余时间内将拒绝尝试。如果所有者更改了密码，所有解锁状态都会失效。

**多人同时编辑。** 如果在你打开编辑表单期间有其他人保存了该项目，你保存时会被提示重新加载，而不会覆盖对方的修改。

在控制台中，编辑者可以在 **资料库 → 共享** 和 **权限 → 与我共享** 中找到共享项目。在 CLI、API 和 MCP 中，他们通过 `_id` 或共享 URL 引用共享项目，而不能使用 slug。

## 文件夹

- **共享文件夹即共享其中的所有内容**，包括所有层级的子项，以及之后添加的项目。
- **开放文件夹即开放其中的内容。** 设为知道链接的任何人或公开的文件夹，会向任何拥有链接的人开放其中的所有内容，即使这些项目本身是受限的。这些项目通过各自的共享 URL 打开，除非它们本身也是公开的，否则不会通过短链接打开。
- **将项目移出**文件夹后，会恢复其自身的访问级别。
- **文件夹页面**中，公开的项目链接到其短链接，其余项目链接到其共享 URL。

在你开放文件夹的访问权限之前，以及将项目移入共享文件夹之前，控制台都会给出警告。

## 权限

控制台侧边栏中的 **权限**列出了所有除你之外其他人可以打开的内容，分为三个标签页：

- **我共享的：** 你邀请了他人的项目，以及邀请了谁。**停止共享**会移除该项目的所有被邀请者。通过上级共享文件夹获得访问权限的人仍保留访问权限。
- **对任何人开放：** 设为知道链接的任何人或公开的项目。开放文件夹所在行会注明它开放了其中的所有内容，并显示项目数量。**设为受限**会关闭某个项目，或关闭某个文件夹及其中的所有内容。
- **与我共享：** 其他人共享给你的项目。**退出**会将其从你的控制台中移除。

**管理**会打开与**资料库**中相同的**共享**对话框。

## 重置共享 URL

重置会生成一个新的 token。旧的 `linkdash.dev/s/…` URL 将失效。你共享给的人可以通过新 URL 继续访问。

## 副本

**创建副本**会保留访问级别，但会获得一个新的独立共享 URL。原项目的共享对象不会被一并复制。

## 通过 CLI、API 和 MCP 操作

```bash
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com --email ben@example.com
linkdash links shares q4
linkdash links unshare q4 --email ben@example.com
linkdash links update q4 --access link
linkdash links reset-link q4
linkdash links shared
linkdash links shares
linkdash links leave https://linkdash.dev/s/<token>
linkdash links share q4 --email cara@example.com --role editor
linkdash links unlock https://linkdash.dev/s/<token>
```

| CLI | HTTP | MCP |
| --- | --- | --- |
| `links create/update --access restricted\|link\|public` | `POST` / `PATCH /v1/links` 中的 `access` | `links_create` / `links_update` 中的 `access` |
| `links share <id> --email <e>`（可重复，`--role viewer\|editor`） | `POST /v1/links/:id/shares`，请求体为 `{ "emails": [...], "role"? }` | `links_share` |
| `links unshare <id> --email <e>` | `DELETE /v1/links/:id/shares/:email` | `links_unshare` |
| `links shares <id>` | `GET /v1/links/:id/shares` | `links_shares` |
| `links shares`（不带 id） | `GET /v1/shares` | `links_shares`（不带 `id`） |
| `links shared` | `GET /v1/shared` | `links_shared` |
| `links leave <_id \| share URL>` | `DELETE /v1/shared/:id` | `links_leave` |
| `links role <id> --email <e> --role viewer\|editor` | `PATCH /v1/links/:id/shares/:email` | `links_share_role` |
| `links unlock <_id \| share URL>` | `POST /v1/links/:id/unlock` | `links_unlock` |
| `links activity <id>` | `GET /v1/links/:id/activity` | `links_activity` |
| `links reset-link <id>`（或 `links update <id> --reset-share-link`） | `POST /v1/links/:id/reset-link`，或使用 `PATCH` 并传入 `resetShareLink: true` | `links_update` 并传入 `resetShareLink: true` |

当同一 slug 在你的多个域名下重复时，以上所有命令都支持 `--domain` / `domain`。共享、取消共享、更改访问级别和重置各计为一个事件；列出共享和退出共享不计入。CSV 导出和导入包含 `access` 列。详情请参阅：[CLI](/zh/cli#访问与共享)、[HTTP API](/zh/api#访问与共享)、[MCP](/zh/mcp#访问与分享)。
