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

The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.

应用程序安装向导需要三个步骤:配置管理员账户和网站设置,审核即将发生的事情,然后观察安装运行并收集您的登录详情。

开始之前

您需要一样东西:您的账户上有一个活跃网站。向导安装到您已经拥有的网站上,它不会创建新网站。如果您没有网站,向导会告诉您并链接到创建网站的页面。请参阅创建您的第一个网站。

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

在安装到已有内容的网站之前,请进行备份。向导对于已经安装应用程序的网站有一个安全保护,详见下文,但是一个您刻意采取的手动还原点总是比一个自动采取的更有价值。请参阅进行备份。

进入向导

在 KPanel 侧边栏中单击应用程序。
单击您想要的应用程序。
在右侧面板中单击安装 [app]。

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

KPanel 中的应用程序安装向导

步骤 1:配置

向导显示应用程序,然后是四组字段。如果应用程序建议的计划级别高于您当前的级别,顶部会出现建议升级计划通知:这只是建议,安装仍会继续。

位置

安装在网站上。 从您的活跃网站中选择。这是应用程序所在的位置。

管理员账户

管理员用户名。 默认为 admin。这是您用于登录的用户名,您可以稍后添加更多用户。
管理员密码。 页面加载的那一刻,系统会为您生成一个强大的 16 个字符的密码。显示可以显示密码,生成可以生成新密码。您也可以自己输入,但必须至少 8 个字符。
管理员邮箱。 可选。用于登录和密码重置。如果留空,将使用您的账户邮箱。

在离开向导之前保存管理员密码。它会显示在审核屏幕上,再次显示在成功屏幕上,然后就消失了。Kapsule 不会存储您稍后可以检索的副本,所以丢失密码意味着需要通过应用程序本身重置密码。

网站设置

网站名称,应用程序要求时。
语言。 应用程序设置的语言,可从十六个选项中选择,包括英语(美国)、英语(英国)、毛利语和主要的欧洲和亚洲语言。这设置的是应用程序本身的内容语言,而不是 KPanel 的语言。

数据库

仅对需要数据库的应用程序显示。向导建议根据您的域派生的数据库名称。仅限字母和数字,不允许下划线或连字符:字段会在您输入时强制执行此规则。如果您愿意,可以更改它。

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

某些应用程序在此下方添加了自己的额外字段,这些字段由应用程序本身定义,必要时附有帮助文本。必填字段用星号标记,在填写所有必填字段之前,继续按钮保持禁用状态。

在底部,向导显示此应用程序的资源摘要:预期安装时间、最小 RAM 以及是否添加数据库。

单击继续。

步骤 2:审核并确认

审核屏幕在一个列表中重述了您所做的决定:应用程序、网站、网站名称、管理员用户名、管理员密码(带有显示或隐藏开关)、管理员邮箱、语言和数据库名称。副标题清楚地说明:在您确认之前,不会安装任何内容。

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

审核屏幕用于最重要的一次检查:网站行。安装到错误的网站是最常见的安装错误,这也是下面的覆盖保护存在的原因。

步骤 3:安装

向导切换到进度视图。您会按顺序看到:

已排队:等待工作线程。 您的任务在队列中,将很快启动。
正在安装 [app],显示经过的秒数与典型安装时间的对比以及进度条。

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

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

取消

取消安装会停止该任务。结果屏幕会确认:安装已停止。您的网站上没有进行任何更改。

当网站已有应用程序时

如果目标网站的目录中已包含网站,安装会停止并显示警告,说明找到的内容:

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

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

这是向导中的临界点。覆盖会替换现有网站的文件。自动备份意味着它是可恢复的,而不是可以点击撤销的。如果您不确定该网站是否可以丢弃,请取消并改为在其他网站上安装。

我们团队手动安装的应用程序

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

我们为您设置 [app]。此应用程序需要手动设置,因此我们团队会在您订购后为您在网站上安装。一旦生效,我们会立即给您发送电子邮件;您无需做任何事。

没有失败,也没有需要您处理的待处理事项。应用程序是免费的,所以无论哪种情况都没有费用。

步骤 4:您已上线

成功时,向导显示**[app] 已上线**,指向您域的链接和凭证摘要:

管理员用户名
管理员密码,带有显示或隐藏
管理员邮箱
网站标题

它还显示安装日志,逐行显示,每个步骤标记为成功、失败或跳过。即使在干净的安装上,该日志也值得一看:它会准确告诉您配置了什么。

两个按钮完成该流程:打开 [app] 直接进入应用程序,返回应用程序返回目录页面。

如果失败会怎样

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

常见原因及处理方法:

资源限制。 如果应用程序的最小 RAM 高于您的计划提供的量,安装可能会在中途失败。检查应用程序页面上的最小 RAM数字。请参阅升级您的计划。
拒绝的字段。 向导在任务排队之前会拒绝包含 shell 不安全字符的输入,并指出字段。简化该值:一个简单的用户名,一个生成的密码,一个仅由字母和数字组成的数据库名称。
网站不活跃。 只有状态为活跃的网站出现在网站下拉菜单中。仍在配置中的网站将不会列出。

安装成功,但网站显示错误。 检查安装日志中是否有失败的步骤,然后查看应用程序自己的文档获取安装后设置。特别是社区应用程序通常需要在浏览器中运行最终设置向导。请参阅网站无法加载。

您丢失了管理员密码。 使用应用程序自己的密码重置和您设置的管理员邮箱。对于 WordPress 具体内容,请参阅重置 WordPress 密码。

安装卡在已排队。 任务队列很繁忙。它会启动。如果它仍然排队超过预期安装时间,请取消它并重试,如果问题重复,请打开支持工单。