# 批量导入邮箱

Source: https://support.kapsulehost.com/zh-cn/email-import

当您一次性为整个团队设置电子邮件时，"导入"屏幕允许您粘贴地址列表并在一次操作中创建所有邮箱，而不是反复运行新邮箱向导。

本文介绍的是创建邮箱本身。将现有邮件从旧提供商迁移过来是单独的步骤，已在[迁移到 KapsuleHost](https://support.kapsulehost.com/zh-cn/migrating-to-kapsule) 中介绍，这两个步骤通常一起进行：先导入地址，然后运行邮件迁移到邮箱中。

## 开始前的准备

> **Note:** 必须先验证域名，才能向其中添加邮箱。如果未验证，每一行都会被拒绝，并显示"在添加邮箱之前验证 example.com 的所有权"。验证是您在域名上发布的 TXT 记录，显示在该域名任何邮箱的**可投递性**选项卡上。通过 KapsuleHost 注册的域名已在我们的 DNS 上，所以记录可以为您发布。

您还需要在计划上有足够的邮箱容量。每个电子邮件计划都授予一定数量的邮箱，导入会创建计入该数量的真实邮箱。如果您导入的地址数量超过计划涵盖的数量，请先升级：参阅[升级您的计划](https://support.kapsulehost.com/zh-cn/upgrading-your-plan)。

导入需要账户上的**所有者**或**管理员**角色。

## 打开导入屏幕

1. 登录 [KPanel](https://kpanel.kapsulehost.com)，然后点击左侧边栏中的**电子邮件**。
2. 点击标题中的**导入**。

该页面标题为"导入邮箱"，分两步进行：**1 - 粘贴列表**，然后**2 - 审核并导入**。

![KPanel 中的导入邮箱屏幕，显示粘贴列表和审核并导入步骤](https://support.kapsulehost.com/help/screenshots/email-import.daadc648.webp)

## 列表格式

每行一个邮箱。最简单的列表就是地址：

```
sarah@yourdomain.com
tom@yourdomain.com
accounts@yourdomain.com
```

每一行也可以是 CSV 行，最多包含四个字段，顺序如下：

```
email, password, name, quota
```

- **email** 是唯一必需的字段。
- **password** 是可选的。留空则为您生成一个强密码。
- **name** 是发出邮件中显示的显示名称。
- **quota** 以兆字节为单位，必须只包含数字。

完整指定的行如下所示：

```
sarah@yourdomain.com, , Sarah Nguyen, 10240
tom@yourdomain.com, , Tom Blake, 10240
```

任何省略配额的行都会获得标准 10 GB 邮箱。任何短于八个字符的密码都会被替换为生成的密码。

> **Warning:** 导入每次最多创建 200 个邮箱。当您超过此数量时，粘贴框会向您发出警告，导入按钮会禁用，服务器会拒绝任何更大的邮箱，显示"每次导入最多 200 个邮箱"。将更大的列表分成 200 个一批。

## 审核和导入

转到第二步并在提交前检查解析的列表。每一行都显示它解析到的地址，因此在创建任何内容之前，逗号错位或换行错误都很明显。

点击导入按钮，每一行都被独立处理。行返回时标记为**已创建**或**失败**并附上原因，因此一个不良地址不会停止批处理的其余部分。

> **Important:** 生成的密码只显示一次，之后不再显示。每个创建的行都有一个**显示一次性密码**控件。在您离开该页面之前，将它们复制到您的密码管理器中。如果您丢失了密码，您不会被永久锁定，但您需要从邮箱的**密码**选项卡重置它。

页脚注释明确说明："邮箱在后台配置。生成的密码只显示一次，请立即复制。"

## 接下来会发生什么

配置在后台运行，通常需要几秒钟。打开**电子邮件**，新邮箱会在列表中显示状态标签：**配置中**表示正在创建，然后显示**活跃**。

邮箱激活后，将地址和密码交给用户，并将他们指向[设置您的邮箱](https://support.kapsulehost.com/zh-cn/setting-up-your-mailbox)。连接设置在邮箱的**设置**选项卡上，对平台上的每个邮箱都相同，因此您可以向整个团队发送一套说明。

## 常见拒绝原因

每一个失败的行都会告诉您原因。您实际上会遇到的原因有：

- **无效的电子邮件格式。** 通常是字符错位、缺少 @，或从电子表格粘贴时的换行符。
- **在添加邮箱之前验证 example.com 的所有权。** 域名尚未通过所有权检查。
- **已在使用中。** 该地址上已存在邮箱、别名、转发器或共享收件箱。
- 使用了 KapsuleHost 暂存子域。邮箱在您自己的域上，而不是临时托管地址上。

> **Tip:** 从旧提供商导出现有邮箱列表到 CSV，在电子表格中打开，删除除地址和显示名称之外的每一列，然后直接将结果粘贴到框中。解析器处理逗号分隔，因此无需重新格式化。

## 迁移现有邮件

创建邮箱会为您提供一个空收件箱。要转移邮件历史记录，请运行电子邮件迁移，它通过 IMAP 连接到旧提供商并将文件夹和邮件复制到新邮箱中。

从**电子邮件**开始，然后**从其他主机迁移**。您需要源主机名，对于每个邮箱，需要源地址及其密码。许多提供商需要应用密码而不是账户密码，向导会告诉您哪些提供商以及如何生成密码。

源密码在静止时加密，迁移完成后自动删除，邮件内容从不记录。详细信息请见[迁移到 KapsuleHost](https://support.kapsulehost.com/zh-cn/migrating-to-kapsule)。

先运行导入，再运行迁移。迁移需要目标邮箱存在。

## 故障排除

**每一行都因域名验证错误而失败。** 发布该域名任何邮箱的**可投递性**选项卡上显示的 TXT 记录，然后点击**验证**。如果您在该域名上还没有邮箱，请通过常规向导创建第一个，它会引导您完成验证。

**某些行创建成功，某些行失败。** 这是设计使然：行是独立的。修复失败的行，仅使用这些行重新运行导入。重新导入已存在的地址会失败，显示"已在使用中"。

**邮箱卡在配置中。** 打开邮箱并稍等片刻；页面会轮询并自动更新。如果几分钟后仍未激活，请检查邮箱上的**活动**选项卡以了解配置历史记录，然后[开启支持工单](https://support.kapsulehost.com/zh-cn/opening-a-support-ticket)并提供地址。

**我粘贴了 400 行，但只得到 200 行。** 限制是每次导入 200 个。分割列表。

**我不想要生成的密码。** 在每一行的第二个字段中提供您自己的密码。任何短于八个字符的内容都会被替换，因此请使用实质性的密码。

相关阅读：[设置您的邮箱](https://support.kapsulehost.com/zh-cn/setting-up-your-mailbox)、[迁移到 KapsuleHost](https://support.kapsulehost.com/zh-cn/migrating-to-kapsule)、[我的邮箱已满](https://support.kapsulehost.com/zh-cn/email-mailbox-full) 和[电子邮件别名](https://support.kapsulehost.com/zh-cn/email-aliases)。