在您的网站上安装应用
应用安装向导分三个步骤进行:配置管理员账户和网站设置,审查即将发生的事情,然后观看安装运行并收集您的登录详情。
开始前的准备
您需要一样东西:您账户上的一个活跃网站。向导安装到您已有的网站上,它不会创建新网站。如果您没有,向导会告诉您并链接您创建一个网站。请参阅创建您的第一个网站。
您还需要apps:write权限,由账户所有者和管理员持有。
在安装到已有内容的网站前进行备份。向导对已持有应用的网站有安全保护,如下所述,但手动创建的还原点总是比自动创建的更有价值。请参阅进行备份。
进入向导
- 在 KPanel 侧边栏中点击应用。
- 点击您想要的应用。
- 在右侧面板中点击安装 [app]。
直接地址是 /apps/<app-slug>/install。

步骤 1:配置
向导显示应用,然后显示四组字段。如果应用建议的计划级别高于您现有的级别,顶部会出现建议升级计划通知:这是建议,安装仍会继续。
位置
安装在网站上。 从您的活跃网站中选择。这是应用将存放的位置。
管理员账户
- 管理员用户名。 默认为
admin。这是您将用于登录的用户名,您稍后可以添加更多用户。 - 管理员密码。 页面加载时会为您生成一个强大的 16 字符密码。显示将其显示,生成创建一个新密码。您也可以输入自己的密码;它必须至少 8 个字符。
- 管理员电子邮件。 可选。用于登录和密码重置。留空则使用您的账户电子邮件。
在离开向导前保存管理员密码。它会显示在审查屏幕上和成功屏幕上,然后就消失了。KapsuleHost 不会存储您以后可以检索的副本,所以丢失密码意味着通过应用本身重置密码。
网站设置
- 网站名称,当应用要求时。
- 语言。 应用设置使用的语言,从十六个选项中选择,包括英语(美国)、英语(英国)、毛利语和主要欧洲和亚洲语言。这设置的是应用本身的内容语言,不是 KPanel 的。
数据库
仅对需要数据库的应用显示。向导建议一个从您的域名派生的数据库名称。仅限字母和数字,无下划线或连字符:字段在您键入时强制执行此操作。如果您喜欢,可以更改它。
需要数据库的应用会在安装过程中自动配置数据库。
一些应用会在此下方添加自己的额外字段,由应用本身定义,有帮助文本。必填字段标有星号,继续按钮保持禁用,直到所有必填字段都填写完毕。
在底部,向导显示此应用的资源摘要:预期安装时间、最小 RAM 和是否添加数据库。
点击继续。
步骤 2:审查并确认
审查屏幕在一个列表中重申了决定:应用、网站、网站名称、管理员用户名、管理员密码(带有显示或隐藏切换)、管理员电子邮件、语言和数据库名称。副标题简明扼要地说出了这一点:在您确认前,没有任何东西被安装。
- 编辑返回以更改某些内容。
- 确认并安装启动任务。
使用审查屏幕进行最重要的检查:网站行。安装到错误的网站是最常见的安装错误,也是下面的覆盖保护的目的所在。
步骤 3:安装
向导切换到进度视图。您将按顺序看到:
- 已排队:等待工作线程。 您的任务在队列中,将很快开始。
- 正在安装 [app],显示经过的秒数与典型安装时间相比的对比和进度条。
保持页面打开。如果您导航离开,安装将在后台继续,但您会失去实时视图和最后的凭据摘要。
如果安装遇到问题,它会自动重试,显示正在重试安装和尝试次数。如果它运行时间远超过预期时间,会出现一条说明,提供继续等待或取消的选项。
取消
取消安装停止任务。结果屏幕确认它:安装已停止。您网站上没有任何更改。
当网站已有应用时
如果目标网站的目录已包含网站,安装将停止并显示警告,命名发现的内容:
此目录已包含 [app]。安装 [new app] 将覆盖它,无法撤销。将首先进行当前网站的完整备份,以便您可以恢复它。
两个选择:取消,或备份并覆盖。如果您同意,任务会在写入任何内容前对现有网站进行完整备份,因此有还原点。
这是向导中没有回头路的地方。覆盖会替换现有网站的文件。自动备份意味着它是可恢复的,不是可以一键撤销的。如果您不确定网站是否可以丢弃,请取消并改为在不同网站上安装。
我们团队手动安装的应用
某些应用没有经过验证的自动安装程序。对于这些,向导会完全跳过进度条,而显示温暖的确认:
我们正在为您设置 [app]。这个应用需要手动设置,所以我们的团队会在您订购后为您在网站上安装。我们会在它上线的那一刻给您发送电子邮件;您不需要做任何事情。
没有任何失败,也没有任何内容需要您处理。应用是免费的,所以无论哪种方式都没有收费。
步骤 4:您已上线
成功时,向导显示[app] 已上线、指向您域名的链接和凭据摘要:
- 管理员用户名
- 管理员密码,带有显示或隐藏
- 管理员电子邮件
- 网站标题
它还显示安装日志,逐行显示,每个步骤标记为成功、失败或跳过。即使在完全安装时,该日志也值得浏览一下:它确切地告诉您配置了什么。
两个按钮完成流程:打开 [app] 直接进入应用,返回应用返回到目录页面。
如果失败了怎么办
安装失败。 结果屏幕显示发生了什么,并声明重要部分:任何部分更改都已回滚。您的网站是干净的。 提供两个操作,重试和联系支持。
常见原因及处理方法:
- 资源限制。 如果应用的最小 RAM 高于您的计划提供的 RAM,安装可能会中途失败。检查应用页面上的最小 RAM数字。请参阅升级您的计划。
- 字段被拒绝。 向导拒绝包含 shell 不安全字符的输入,甚至在任务排队前,并命名该字段。简化值:普通用户名、生成的密码、字母和数字数据库名称。
- 网站不活跃。 只有活跃状态的网站才会出现在网站下拉列表中。仍在配置中的网站不会被列出。
安装成功但网站显示错误。 在安装日志中检查失败的步骤,然后检查应用自己的文档进行安装后设置。特别是社区应用通常需要在浏览器中运行最终的设置向导。请参阅网站无法加载。
您丢失了管理员密码。 使用您设置的管理员电子邮件通过应用自己的密码重置。对于 WordPress 特别是,请参阅重置 WordPress 密码。
安装卡在排队状态。 任务队列很忙。它将启动。如果它仍卡在排队状态,远超过预期安装时间,取消它并重试,如果重复,则打开支持工单。