---
title: 如何在线上传系统工具
description: FastGPT 系统工具在线上传指南
---

> 从 FastGPT 4.14.0 版本开始，系统管理员可以通过 Web 界面直接上传和更新系统工具进行热更新

## 权限要求

⚠️ **重要提示**：只有 **root 用户** 才能使用在线上传系统工具功能。

- 确保您已使用 `root` 账户登录 FastGPT

## 支持的文件格式

- **文件类型**：`.pkg` 文件
- **文件大小**：最大 100 MB
- **文件数量**：每次最多上传 15 个文件

## 上传步骤

### 1. 进入配置页面


![](/imgs/plugins/entry.png)

### 2. 准备工具文件

在上传之前，请确保您的 `.pkg` 文件是从 fastgpt-plugin 项目中通过 `bun run build:pkg` 命令打包后的 `dist/pkgs` 文件夹下得到的

![](/imgs/plugins/files.png)

### 3. 执行上传

1. 点击 **"导入/更新"** 按钮
2. 在弹出的对话框中，点击文件选择区域
3. 选择您准备好的 `.pkg` 工具文件
4. 确认文件信息无误后，点击 **"确认导入"**

### 4. 上传过程

- 上传成功后会显示成功提示
- 页面自动刷新，新工具会出现在工具列表中

## 功能特点

### 工具管理

- **查看工具**：所有用户都可以查看已安装的系统工具
- **上传工具**：仅 root 用户可以上传新工具或更新现有工具
- **删除工具**：仅 root 用户可以删除已上传的工具

## 常见问题

### Q: 无法看到"导入/更新"按钮

**原因：** 当前用户不是 root 用户

**解决方案：** 使用 root 账户重新登录