# 应用程序目录

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

应用目录是一个可浏览的网络应用程序库，您可以将其部署到已在 KapsuleHost 托管的网站上,从 WordPress、WooCommerce 到各类 wiki、分析工具、文件同步和自动化工具应有尽有。

## 目录的内容

应用是运行在您托管环境上的软件,而不是需要额外订阅的产品。您已经为网站付费,应用只是您选择在其上运行的内容。

目录的存在是为了让您不必自行研究、下载、解压和配置这些软件。大多数条目都带有经过验证的安装程序,它会在您指定的网站上完成应用的设置、创建其数据库、生成管理员账户,并将登录信息交给您。

> **Note:** "应用" 是 KPanel 侧边栏中的一个顶级项目,位于 **主要** 分组内,排在 **网站** 和 **邮箱** 之间。直接地址是 `/apps`。

## 应用的费用

无需额外付费。应用安装在您已经付费使用的网站上,因此应用本身不收取任何费用,也没有可退款的项目。您实际支付的是其背后的主机资源费用。

不过这里有一个值得提前规划的实际影响：更重的应用会占用套餐中更多的资源。五个人使用的 wiki 和一个繁忙的商店,即便在同一套餐下,负载也截然不同。

![KPanel 中的应用目录](https://support.kapsulehost.com/help/screenshots/apps-overview.8f461cb4.webp)

## 浏览与搜索

目录页面顶部会显示一个圆角标签,标明当前目录中应用的总数,此外还有一个搜索框和一排分类标签。

- **搜索** 会匹配应用名称、其 slug 和标语。输入内容后,会将整个目录筛选为一个平铺的匹配结果网格。
- **分类标签** 按类型筛选。它们支持多选：点击多个标签可以扩大筛选范围,点击 **全部** 可以重置。

在未进行搜索且未选择任何标签时,页面会在一张宽幅精选卡片中展示一个推荐应用,其余应用则按分类分组,并加上分类标题,方便在庞大的目录中浏览。

分类包括：内容管理系统(CMS)、电商、分析、文件、Wiki、论坛、邮箱、自动化、无头内容管理系统(Headless CMS)、项目管理、客户关系管理(CRM)、DevOps、教育、静态网站,以及工具。

> **Tip:** 如果您大致知道自己想要什么,但不知道它叫什么名字,请使用分类标签而不是搜索。"Wiki" 和 "无头内容管理系统" 这类分类,能帮您发现大多数人根本想不到按名称去搜索的选项。

## 阅读一个卡片

图库中的每个卡片都带有应用图标、名称、一行标语,以及一个或两个圆角标签:

- **运行环境标签**：`PHP`、`NODEJS`、`STATIC` 或 `PYTHON`。这表明该应用基于何种环境构建,并告诉您它需要什么样的托管环境。
- **社区标签**,出现在安装程序由社区贡献的应用上。安装脚本已包含在内,但可能需要一些手动步骤才能完成设置。

## 阅读应用详情页

点击任意应用即可打开其详情页。详情页分为左右两部分。

左栏讲述应用的详细信息：

- 应用图标、名称和标语,以及标明其运行环境、分类、是否 **需要数据库**、是否为 **社区** 版本、以及是否为 **精选** 的标签。
- **关于 [应用名]**：说明该软件实际的功能。
- **概览**：资源相关信息,以及指向该项目自身文档和主页的外部链接。

**概览** 卡片可能包含以下内容：

| 项目 | 说明 |
|---|---|
| 安装时间 | 大致的安装所需时间 |
| 最小 RAM | 应用运行所需的内存 |
| 最小磁盘 | 应用所需的磁盘空间 |
| 数据库 | 是否会自动为您创建数据库 |

右栏是一个固定的安装面板,其中包含 **安装 [应用名]** 按钮,以及该应用适用的任何注意事项。

## 可直接安装的应用与由人工配置的应用

目录中的每一款应用都可以下单。没有"即将推出"这种死胡同。区别在于其安装方式：

- **带有经过验证的安装程序的应用** 会自动完成部署。您进行配置、确认,然后观看进度条。
- **没有经过验证的安装程序的应用** 由我们团队手动安装。应用页面会明确说明：*由我们团队手动设置：您下单后,我们会手动安装此应用,并在其上线后发送邮件通知您。* 您仍然点击同一个按钮,也同样无需支付任何费用。

这种区分是刻意为之的：在客户的实际运行网站上运行未经验证的安装脚本,很容易造成损坏。在我们无法为脚本的可靠性作出保证的情况下,就由人工来完成这项工作。

## 社区应用

标有 **社区** 字样的应用,其安装脚本是由社区贡献而非由内部团队维护的。应用页面会明确说明：安装脚本已包含在内,但可能需要一些手动步骤才能完成设置。

> **Warning:** 请将社区应用视为"已安装,但尚未配置"。该软件会被部署到您的网站上并可以访问,但请预期需要您自行完成最终的设置向导,并查阅该项目自身的文档,了解安装程序未能完成的部分。开始前请先进行备份。请参阅[执行备份](https://support.kapsulehost.com/zh-cn/taking-a-backup)。

## 推荐套餐等级

部分应用会在其页面上注明推荐的最低套餐等级,当您当前的套餐低于该等级时,安装向导会显示 **建议升级套餐** 的提示。

该提示仅作为建议,并非强制限制。无论如何安装都会继续进行。但它所警示的问题是真实存在的：如果应用所需的内存超过您套餐能够舒适提供的程度,安装过程可能会失败,或者安装完成后运行不稳定。在忽略该提示之前,请将应用页面上的 **最小 RAM** 数值与您套餐所提供的资源进行对比。

## 谁可以安装

安装操作需要 **apps:write** 权限,该权限由账户所有者和管理员持有。其他角色可以浏览整个目录并阅读每一个应用页面,但安装按钮会被锁定,并附有说明标注哪些角色可以执行该操作。

## 如果出现问题怎么办

**目录无法加载。** 页面会显示一张错误提示卡片,并带有 **重试** 按钮。这是加载失败,而不是目录为空。

**"没有符合您搜索条件的应用。"** 请清空搜索框,或点击 **全部** 标签以重置分类筛选。多选标签很容易在不经意间被保留选中状态。

**找不到您期待的某个应用。** 该目录是经过筛选整理的。如果您需要的内容缺失,请[提交支持工单](https://support.kapsulehost.com/zh-cn/opening-a-support-ticket)并说明：将某个应用添加到目录中是一项正常的请求,并不罕见。

**应用页面显示错误。** 请返回 **所有应用**,再从卡片重新尝试一次。如果某个特定应用持续出现此问题,请在工单中报告该应用的 slug。

## 后续步骤

选定应用后,[在您的网站上安装应用](https://support.kapsulehost.com/zh-cn/apps-installing)将完整介绍整个安装向导流程,包括目标网站非空时会发生的情况。

## 相关内容

- [在您的网站上安装应用](https://support.kapsulehost.com/zh-cn/apps-installing)
- [安装 WordPress](https://support.kapsulehost.com/zh-cn/installing-wordpress)
- [创建您的第一个网站](https://support.kapsulehost.com/zh-cn/creating-your-first-website)