# 在您的网站上安装应用程序

Source: https://support.kapsulehost.com/zh-cn/apps-installing

在您的网站上安装应用

应用安装向导分三个步骤进行：配置管理员账户和网站设置，审查即将发生的事情，然后观看安装运行并收集您的登录详情。

## 开始前的准备

您需要一样东西：您账户上的一个**活跃网站**。向导安装到您已有的网站上，它不会创建新网站。如果您没有，向导会告诉您并链接您创建一个网站。请参阅[创建您的第一个网站](https://support.kapsulehost.com/zh-cn/creating-your-first-website)。

您还需要**apps:write**权限，由账户所有者和管理员持有。

> **Warning:** 在安装到已有内容的网站前进行备份。向导对已持有应用的网站有安全保护，如下所述，但手动创建的还原点总是比自动创建的更有价值。请参阅[进行备份](https://support.kapsulehost.com/zh-cn/taking-a-backup)。

## 进入向导

1. 在 KPanel 侧边栏中点击**应用**。
2. 点击您想要的应用。
3. 在右侧面板中点击**安装 [app]**。

直接地址是 `/apps/<app-slug>/install`。

![KPanel 中的应用安装向导，右侧面板中有"安装"按钮](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## 步骤 1：配置

向导显示应用，然后显示四组字段。如果应用建议的计划级别高于您现有的级别，顶部会出现**建议升级计划**通知：这是建议，安装仍会继续。

### 位置

**安装在网站上。** 从您的活跃网站中选择。这是应用将存放的位置。

### 管理员账户

- **管理员用户名。** 默认为 `admin`。这是您将用于登录的用户名，您稍后可以添加更多用户。
- **管理员密码。** 页面加载时会为您生成一个强大的 16 字符密码。**显示**将其显示，**生成**创建一个新密码。您也可以输入自己的密码；它必须至少 8 个字符。
- **管理员电子邮件。** 可选。用于登录和密码重置。留空则使用您的账户电子邮件。

> **Important:** 在离开向导前保存管理员密码。它会显示在审查屏幕上和成功屏幕上，然后就消失了。KapsuleHost 不会存储您以后可以检索的副本，所以丢失密码意味着通过应用本身重置密码。

### 网站设置

- **网站名称**，当应用要求时。
- **语言。** 应用设置使用的语言，从十六个选项中选择，包括英语（美国）、英语（英国）、毛利语和主要欧洲和亚洲语言。这设置的是应用本身的内容语言，不是 KPanel 的。

### 数据库

仅对需要数据库的应用显示。向导建议一个从您的域名派生的数据库名称。仅限字母和数字，无下划线或连字符：字段在您键入时强制执行此操作。如果您喜欢，可以更改它。

需要数据库的应用会在安装过程中自动配置数据库。

一些应用会在此下方添加自己的额外字段，由应用本身定义，有帮助文本。必填字段标有星号，**继续**按钮保持禁用，直到所有必填字段都填写完毕。

在底部，向导显示此应用的资源摘要：预期安装时间、最小 RAM 和是否添加数据库。

点击**继续**。

## 步骤 2：审查并确认

审查屏幕在一个列表中重申了决定：应用、网站、网站名称、管理员用户名、管理员密码（带有显示或隐藏切换）、管理员电子邮件、语言和数据库名称。副标题简明扼要地说出了这一点：**在您确认前，没有任何东西被安装。**

- **编辑**返回以更改某些内容。
- **确认并安装**启动任务。

> **Tip:** 使用审查屏幕进行最重要的检查：**网站**行。安装到错误的网站是最常见的安装错误，也是下面的覆盖保护的目的所在。

## 步骤 3：安装

向导切换到进度视图。您将按顺序看到：

- **已排队：等待工作线程。** 您的任务在队列中，将很快开始。
- **正在安装 [app]**，显示经过的秒数与典型安装时间相比的对比和进度条。

保持页面打开。如果您导航离开，安装将在后台继续，但您会失去实时视图和最后的凭据摘要。

如果安装遇到问题，它会自动重试，显示**正在重试安装**和尝试次数。如果它运行时间远超过预期时间，会出现一条说明，提供继续等待或取消的选项。

### 取消

**取消安装**停止任务。结果屏幕确认它：*安装已停止。您网站上没有任何更改。*

## 当网站已有应用时

如果目标网站的目录已包含网站，安装将停止并显示警告，命名发现的内容：

> 此目录已包含 [app]。安装 [new app] 将覆盖它，无法撤销。将首先进行当前网站的完整备份，以便您可以恢复它。

两个选择：取消，或**备份并覆盖**。如果您同意，任务会在写入任何内容前对现有网站进行完整备份，因此有还原点。

> **Important:** 这是向导中没有回头路的地方。覆盖会替换现有网站的文件。自动备份意味着它是可恢复的，不是可以一键撤销的。如果您不确定网站是否可以丢弃，请取消并改为在不同网站上安装。

## 我们团队手动安装的应用

某些应用没有经过验证的自动安装程序。对于这些，向导会完全跳过进度条，而显示温暖的确认：

> 我们正在为您设置 [app]。这个应用需要手动设置，所以我们的团队会在您订购后为您在网站上安装。我们会在它上线的那一刻给您发送电子邮件；您不需要做任何事情。

没有任何失败，也没有任何内容需要您处理。应用是免费的，所以无论哪种方式都没有收费。

## 步骤 4：您已上线

成功时，向导显示**[app] 已上线**、指向您域名的链接和凭据摘要：

- 管理员用户名
- 管理员密码，带有显示或隐藏
- 管理员电子邮件
- 网站标题

它还显示**安装日志**，逐行显示，每个步骤标记为成功、失败或跳过。即使在完全安装时，该日志也值得浏览一下：它确切地告诉您配置了什么。

两个按钮完成流程：**打开 [app]** 直接进入应用，**返回应用**返回到目录页面。

## 如果失败了怎么办

**安装失败。** 结果屏幕显示发生了什么，并声明重要部分：*任何部分更改都已回滚。您的网站是干净的。* 提供两个操作，**重试**和**联系支持**。

常见原因及处理方法：

- **资源限制。** 如果应用的最小 RAM 高于您的计划提供的 RAM，安装可能会中途失败。检查应用页面上的**最小 RAM**数字。请参阅[升级您的计划](https://support.kapsulehost.com/zh-cn/upgrading-your-plan)。
- **字段被拒绝。** 向导拒绝包含 shell 不安全字符的输入，甚至在任务排队前，并命名该字段。简化值：普通用户名、生成的密码、字母和数字数据库名称。
- **网站不活跃。** 只有**活跃**状态的网站才会出现在网站下拉列表中。仍在配置中的网站不会被列出。

**安装成功但网站显示错误。** 在安装日志中检查失败的步骤，然后检查应用自己的文档进行安装后设置。特别是社区应用通常需要在浏览器中运行最终的设置向导。请参阅[网站无法加载](https://support.kapsulehost.com/zh-cn/website-not-loading)。

**您丢失了管理员密码。** 使用您设置的管理员电子邮件通过应用自己的密码重置。对于 WordPress 特别是，请参阅[重置 WordPress 密码](https://support.kapsulehost.com/zh-cn/wordpress-reset-password)。

**安装卡在排队状态。** 任务队列很忙。它将启动。如果它仍卡在排队状态，远超过预期安装时间，取消它并重试，如果重复，则[打开支持工单](https://support.kapsulehost.com/zh-cn/opening-a-support-ticket)。

## 相关资源

- [应用目录](https://support.kapsulehost.com/zh-cn/apps-overview)
- [安装 WordPress](https://support.kapsulehost.com/zh-cn/installing-wordpress)
- [进行备份](https://support.kapsulehost.com/zh-cn/taking-a-backup)
- [我的网站无法加载：诊断检查清单](https://support.kapsulehost.com/zh-cn/website-not-loading)