mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
---
|
||
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]]
|
||
|
||
## 不支持
|
||
- 普通成员不能安装微应用，「应用商店」对其隐藏
|
||
- 单次只能装一个插件，无批量安装
|
||
- 不能选指定版本（始终装应用商店推荐的版本）
|