安装、卸载和更新
本文档介绍如何安装、更新和卸载应用，以及如何安装自定义应用。
开始之前
在开始之前，建议你先熟悉一些与 Olares 应用相关的概念：
| 术语 | 描述 |
|---|---|
| 系统应用 | Olares 内置的预安装应用，例如 Profile、文件管理器和 Vault。 |
| 社区应用 | 由第三方开发者创建和维护的应用。 |
| 共享应用 | 一种特殊类型的社区应用，由管理员统一部署，为集群内所有 用户提供共享的资源或服务。带界面的应用可在启动台直接打开使用； 无界面的后端服务则暴露标准 API，供客户端连接使用。 |
| 依赖项 | 应用需要先安装的前置应用。 |
查找应用
Olares 应用市场提供多种方式发现和浏览应用。
按类别浏览
启动应用市场后，默认进入发现页面。该页面作为你的核心探索枢纽，通过直观的版块分类引导你探索各类内容：
- 发现精彩应用：由编辑团队精心甄选的特色应用，展示当前热门及应季推荐。点击这些轮播图即可进入相应细节内容，如综合指南、行业应用案例、详细的应用横向评测等，旨在帮助你精准选择工具。
- 社区推荐：最受 Olares 社区喜爱的推荐应用。
- Olares 最受欢迎应用：使用率和下载量最高的应用。
- Olares 最新应用：最近添加到市场的应用。
你还可以根据功能浏览应用：
- 设计创作：用于创建和发布数字内容的应用程序，包括 AI 生成的艺术、3D 模型、博客和设计项目。
- 工作效率：用于团队协作、项目管理、数据组织和构建自定义 AI 代理的应用。
- 休闲娱乐：用于娱乐和休闲的自托管应用程序，如游戏、视频流媒体和社交。
- 生活方式：用于管理智能家居、个人照片库和 AI 身份的自托管应用。
- 实用工具：用于系统管理、文件共享、数据备份和运行本地 AI 模型的工具。
- 开发工具：软件开发生命周期的工具链，包括代码托管、CI/CD、可观察性和数据库管理。
- AI：最新的开源大语言模型（LLMs），以及涵盖文本、音频和 3D 资产生成的 AI 创作工具。
使用关键词搜索
要在市场中搜索应用：
在左侧的管理子菜单中，点击搜索。
输入关键词。相关结果将随你在输入时显示。
切换应用源
你可以选择不同的应用商店源，以加快浏览、搜索和下载应用的速度，或者安装某些源特有的应用。要切换应用源：
- 打开应用市场，从左侧导航栏进入我的 Olares > 设置。
- 在市场来源下，点击添加源以添加新的应用源。当前 Olares 官方源包括：
- 按要求填写源标题、URL、以及描述后，点击确认完成添加。
- 在源列表中，选择您希望使用的源以将其激活。等待大约 10 分钟，商店页面就会更新到新的源。
注意
不同安装源在我的 Olares页面会生成相应的页签，以便于管理应用。
安装应用
要从应用市场安装应用：
从程序坞或启动台，打开应用市场。
找到目标应用，双击查看其详情。
如果该应用支持多种硬件加速器，在资源区域配置部署信息：
a. 从下拉列表中选择所需的计算资源。例如 NVIDIA GPU、NVIDIA GB10 或 CPU。
b. 查看所选计算资源对应的 CPU、内存、所需磁盘空间和显存要求，确保当前硬件配置符合要求。
点击获取。
当操作按钮变为安装时，点击安装。
如果弹出提示，点击确认以确认你的硬件加速器选择。安装开始。
（可选）若要取消安装，点击按钮右侧的 close_small。
安装完成后，按钮将变为打开。
安装共享应用
共享应用由管理员统一部署，集群成员无需自行安装。为确保共享服务在集群内正常运行和可访问，请根据共享应用的类型采取相应的安装流程。
共享应用的管理
管理员负责共享应用的升级、暂停、恢复、卸载。这些操作会影响集群内所有成员，操作前请确认。
无界面的后端服务应用
此类共享应用仅提供 API 服务，不包含图形界面。任何支持对应 API 的客户端均可调用。以基于 Ollama 引擎基座 创建的模型实例为例：
管理员部署：管理员在应用市场中基于 Ollama 引擎基座创建模型实例。部署完成后，模型实例作为共享服务在集群内启动，并在启动台生成一个同名的模型应用入口。
成员配置使用：
a. 获取访问地址：在启动台打开模型应用，进入模型控制台，复制其中显示的 Base URL。
b. 配置客户端：安装任意支持对应 API 的客户端（如 LobeChat、Open WebUI），在客户端配置中填入上述地址即可使用。
自带用户界面的完整应用
此类共享应用同时包含后端服务与 Web 用户界面，可独立为用户提供服务，如 Dify 共享版、ComfyUI 共享版等。
- 管理员安装：管理员在应用市场安装共享应用。安装后，集群内会启用共享服务，并在启动台添加一个同名的应用入口。
ComfyUI 启动器
ComfyUI 共享版包含一个桌面启动器组件，用于管理 ComfyUI 服务和相关资源。管理员需要从 ComfyUI 启动器里配置并启用服务。
- 成员直接使用：成员在启动台找到该应用入口，点击打开即可直接使用，无需安装额外客户端。
安装自定义应用
- 准备 Olares 应用 Chart 文件（格式为
.zip、.tgz、.tar或.gz）。 - 打开应用市场，从左侧菜单进入我的 Olares。
- 点击右上角上传自定义 Chart并选择 Chart 文件以安装。
你可以在上传页签查看并管理所有本地自定义应用。
环境变量设置
在应用安装过程中，如果某个环境变量是应用运行必需的，且该变量无默认值或引用的系统变量尚未设置，应用市场会弹出设置提醒窗口： 
- 自定义变量：您可以直接在安装弹窗中输入值。
- 引用的系统变量：您需要先前往 设置 > 开发者 > 系统环境变量 页面设置相应变量值。
完成设置后可点击继续安装。
更新应用
从应用市场下载的应用可按以下步骤获取更新：
- 打开应用市场。
- 在左侧边栏管理子菜单下点击更新。如果有更新可用，将显示标记数字。
- 可用更新页面会列出可更新应用。点击全部更新以一次性更新所有应用，或单独更新每个应用。
卸载应用
从应用市场或启动台卸载应用。
查看应用操作日志
应用操作日志详细记录了应用在市场里的安装、下载、更新和卸载等操作的过程与状态。要访问这些日志：
- 打开应用市场。
- 从左侧边栏进入我的 Olares。
- 页面右上角点击日志以进入具体日志页面。
你可以点击 download 按钮以下载这些日志以进一步分析。
常见问题
为什么我无法安装应用？
如果无法安装应用，可能是由于以下原因：
- 系统资源不足：尝试释放系统资源，或增加资源配额。
- 缺少依赖项：在应用详情页在检查是否已安装所需依赖项。
- 系统版本不兼容：尝试将 Olares 升级到最新版本。
- 共享应用依赖（对于 Olares 成员）：该应用需要集群中已运行某个共享服务。请联系管理员先安装相应的共享应用，然后你才能安装此应用。
为什么应用处于停止状态？
应用停止运行通常是由于以下原因之一：
- 系统自动停止：为了保障 Olares 的稳定性，系统会持续监控资源使用情况。如果某个应用瞬间占用了过高的资源（如 CPU 或内存），导致系统负载过高，系统可能会自动暂停该应用，以防止整个设备卡顿或崩溃。
- 手动停止：你或管理员此前可能手动停止了该应用，且尚未进行恢复操作。
为什么我现在无法恢复应用？
启动应用需要预留一部分固定的计算资源。如果当前运行的其他应用已经占用了大部分资源，剩余的“空闲资源”就不够分配给你想要启动的这个应用了。
因此，当你尝试恢复应用时，可能会遇到以下提示，这种情况下，你需要先关闭其他应用以释放资源：
| 错误提示 | 说明 |
|---|---|
| 系统 CPU/内存资源不足 | 整个系统的物理资源已接近耗尽。 |
| 系统存储空间不足 | 硬盘空间已满，无法写入新数据。 |
| 可用 CPU/内存不足 | 虽然系统仍有少量资源，但无法满足此应用启动所需的最低配置。 |
如何恢复应用？
要恢复该应用，你需要释放一些被占用的资源：
- 进入设置 > 应用，查看当前状态为运行中的应用。
- 找到你暂时不需要使用的应用。
- 点击该应用，然后点击暂停以关闭运行状态，从而停止该应用。
- 资源释放后，回到你原来的应用，再次点击恢复。
如何释放未使用应用的资源？
如果某些应用暂时不使用，且你希望释放它们占用的系统资源，可以通过应用市场或设置停止这些应用。
释放共享应用的资源
要完全释放共享应用的资源（如 Ollama 等），必须停止服务端服务。此操作只能由管理员执行。
当管理员停止共享应用时，将出现 同时停止共享服务器（影响所有用户） 复选框：
- 要完全释放资源，必须勾选此复选框。
- 勾选后，该服务将在整个集群中被禁用，其他用户也将无法再使用该应用。
- 此复选框仅在多用户集群中出现。在单用户场景下，系统默认会自动同时停止用户端应用和服务端服务。
针对 Olares V1.12.4 及更早版本的说明
在 Olares 1.12.4 及更早版本中，若要完全释放资源，必须使用应用市场：
- 在应用市场中暂停应用，并确保已勾选 同时停止共享服务器（影响所有用户） 选项。
- 如果已经通过设置停止了用户端应用，必须先在应用市场中将其恢复，然后再停止该共享应用，并确保已勾选 同时停止共享服务器（影响所有用户） 选项。
升级到 V1.12.6 后，我之前安装的旧版共享应用会怎样？
Olares 1.12.6 引入了全新的 V3 共享应用架构。旧版 V2 共享应用仍可继续启动、停止、暂停和恢复，但无法直接升级到 V3。如需使用 V3 版本，必须先卸载 V2 版本，再安装 V3 版本。已有数据需要手动迁移。
有关架构变更和迁移流程的完整说明，请参考 共享应用。