---
id: micro-app.install.howto
title: 安装微应用
type: howto
feature: micro-app
scope: admin
locale: zh
aliases:
  - 怎么安装微应用
  - 装插件
  - 安装应用
  - 应用市场怎么用
  - 装 OKR
  - 装思维导图
related_tools: []
related_pages: [application]
prerequisites:
  - 需要系统管理员权限
  - 主程序能访问应用市场镜像源（默认走 kuaifan 官方仓库）
negative:
  - 普通成员不能安装微应用，入口对其隐藏
  - 安装过程依赖 Docker 拉镜像，未联网或镜像源不通时安装会一直卡在「下载中」
  - 不能离线导入插件包（无 manual upload 入口）
last_verified: v1.7.90
---

# 安装微应用

## 入口
- 桌面端：左侧栏「应用」→ 管理员分区的「应用商店」卡片（也叫应用市场）→ 选择应用 →「安装」
- 移动端：竖屏底部 Tabbar「应用」→「应用商店」卡片
- 「应用商店」卡片仅系统管理员（`userIsAdmin = true`）可见，普通成员没有安装入口

## 操作步骤
1. 进入应用商店，按分类或搜索找到想装的应用（插件）
2. 点击「安装」，等待镜像拉取与容器启动（包大小决定时长，10MB 以上插件可能需要数分钟）
3. 安装成功后插件状态变为 `installed`，应用卡片出现在**所有用户**的应用面板，无需重启主程序
4. 部分插件首次进入需配置（如 office 的 Doc 服务器、ai 的模型 Key）

## 验证安装成功
- 应用商店该插件按钮变为「卸载」/「更新」
- 应用中心「常用」分区出现新卡片
- 普通成员需刷新页面或重新登录才能看到（缓存）

## 失败排查
- 镜像源不通：检查服务器到镜像源网络
- 端口冲突：检查 `docker/appstore/apps/<id>/docker-compose.yml`
- 详细排查模板见 [[okr.cannot-install.faq]]

## 不支持
- 普通成员不能安装微应用，「应用商店」对其隐藏
- 单次只能装一个插件，无批量安装
- 不能选指定版本（始终装应用商店推荐的版本）