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

# 实例设置

> 管理实例级开关、邮件配置和系统待配置项。

<Tip>私有化部署商业版及以上适用</Tip>

路径：管理面板 → 实例设置

**实例设置** 页用于管理整个实例的基础能力，包括 **通用配置**、**邮箱**，以及右侧 **待配置项** 中显示的系统检查项。

| 配置类型     | 说明                                                                   |
| -------- | -------------------------------------------------------------------- |
| **通用配置** | 包括 **允许新用户注册**、**禁止注册的邮箱域名**、**允许发送空间邀请**、**允许所有人创建新的空间**、**启用邮箱验证** |
| **邮箱**   | 包括 **通知邮箱** 和 **自动化邮箱**，用于密码找回、邮箱验证、通知邮件和邀请邮件                        |
| **系统限制** | 查看当前实例生效的表数据、字段、视图和文本限制                                              |

如果需要启用系统邮件，请在 **邮箱** 中完成配置。

使用 **禁止注册的邮箱域名** 可以阻止这些域名的邮箱注册。Teable 会在发送注册验证码前拒绝这些域名，与这些域名相关的邀请邮件也不会发送。

## 系统限制

**系统限制** 用于查看当前实例生效的数据与配置上限。如果需要调整某个限制，请以页面中显示的环境变量为准。

<Note>
  修改环境变量后，需要重启服务才会生效。
</Note>

## 待配置项

右侧 **待配置项** 可以理解为一份系统检查清单。它不是普通说明卡片，而是在告诉你：当前实例还缺少哪些关键配置。

在这页里，常见的检查项包括：

| 项目                      | 影响                  |
| ----------------------- | ------------------- |
| **PUBLIC\_ORIGIN 环境变量** | 影响附件、导入等依赖外部访问地址的功能 |
| **启用 HTTPS**            | 影响复制粘贴等依赖 HTTPS 的能力 |
| **邮箱**                  | 影响密码找回、邮箱验证、系统通知等能力 |

如果这些项目还没有完成，即使实例本身可以正常打开，部分功能仍然可能不可用。

## 检查顺序

如果你正在做私有化部署交付或首次上线，建议按下面的顺序检查：

<Steps>
  <Step title="检查访问地址">
    确认 **PUBLIC\_ORIGIN** 已正确配置。
  </Step>

  <Step title="检查 HTTPS">
    确认实例已经启用 **HTTPS**。
  </Step>

  <Step title="检查邮件">
    确认 **SMTP** 已配置完成，并且可以正常发信。
  </Step>

  <Step title="继续完成 AI 配置">
    基础项确认完成后，再继续完成 [AI 配置](/zh/basic/admin-panel/ai-setting)。
  </Step>
</Steps>

这样更容易让右侧 **待配置项** 按顺序变绿，也更方便排查问题。

## 常见问题

<AccordionGroup>
  <Accordion title="实例能打开，但右侧还有未完成项">
    这通常说明实例“能访问”，但还没有满足某项关键能力的运行条件。建议根据右侧提示逐项补齐，而不是只看页面能否打开。
  </Accordion>

  <Accordion title="邮件偶尔可用，但“邮箱”仍未完成">
    先检查当前保存的 SMTP 配置是否完整，是否用于正确的发信场景，以及是否能稳定发出验证邮件或通知邮件。
  </Accordion>

  <Accordion title="为什么 PUBLIC_ORIGIN 很重要">
    很多需要外部访问地址的功能都会依赖它。如果配置值和当前实际访问地址不一致，部分导入、附件或跳转相关功能可能出现异常。
  </Accordion>
</AccordionGroup>
