---
title: 'Cài đặt và nâng cấp plugin'
description: 'Bắt đầu nhanh với NocoBase: cài đặt và nâng cấp plugin'
keywords: 'install,upgrade,plugins,NocoBase'
---

# Cài đặt và nâng cấp plugin

## Plugin tích hợp sẵn

Các plugin tích hợp sẵn của NocoBase sẽ được cập nhật tự động cùng với phiên bản lõi, không cần thao tác thủ công.

## Plugin thương mại

Để biết chi tiết về cách kích hoạt và nâng cấp, vui lòng tham khảo: [Kích hoạt và nâng cấp plugin thương mại](../api/cli/license/index.md)

## Plugin bên thứ ba

### Cài đặt plugin bằng dòng lệnh

```bash
yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz
yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz
```

Nếu ứng dụng đã cài đặt plugin này và cần nâng cấp, hãy chạy:

```bash
yarn nocobase upgrade --skip-code-update
```

### Tải lên và giải nén thủ công

Vui lòng tải gói plugin về máy cục bộ trước, sau đó tải lên và giải nén thủ công vào thư mục `./storage/plugins`. Nếu plugin này đã được bật, hãy chạy lệnh sau sau khi tải lên và giải nén xong để hoàn tất việc nâng cấp plugin.

> ⚠️ **Lưu ý**: Để tránh sự cố bộ nhớ đệm, hãy đảm bảo ứng dụng NocoBase đã dừng chạy trước khi thực hiện.

```bash
yarn nocobase upgrade --skip-code-update
```

### Cách giải nén plugin đúng cách

Ví dụ sau minh họa cách giải nén đúng gói plugin vào thư mục được chỉ định:

```bash
mkdir -p /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas && \
  tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \
  -C /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas \
  --strip-components=1
```

Lệnh này sẽ giải nén plugin vào thư mục được chỉ định và không tạo thêm một cấp thư mục `package` dư thừa.

```bash
/my-nocobase/storage/plugins/@nocobase/plugin-auth-cas
```

### Ví dụ về cấu trúc thư mục đúng

```bash
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.js
./plugin-auth-cas/dist/server/auth.js
./plugin-auth-cas/client.js
./plugin-auth-cas/dist/constants.js
./plugin-auth-cas/dist/externalVersion.js
./plugin-auth-cas/dist/client/index.js
./plugin-auth-cas/dist/index.js
./plugin-auth-cas/dist/server/index.js
./plugin-auth-cas/dist/server/actions/login.js
./plugin-auth-cas/dist/server/plugin.js
./plugin-auth-cas/server.js
./plugin-auth-cas/dist/server/actions/service.js
./plugin-auth-cas/dist/locale/en-US.json
./plugin-auth-cas/dist/locale/ko_KR.json
./plugin-auth-cas/package.json
./plugin-auth-cas/dist/locale/zh-CN.json
./plugin-auth-cas/README.md
./plugin-auth-cas/README.zh-CN.md
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.d.ts
./plugin-auth-cas/dist/server/auth.d.ts
./plugin-auth-cas/client.d.ts
./plugin-auth-cas/dist/constants.d.ts
./plugin-auth-cas/dist/client/index.d.ts
./plugin-auth-cas/dist/client/locale/index.d.ts
./plugin-auth-cas/dist/index.d.ts
./plugin-auth-cas/dist/server/index.d.ts
./plugin-auth-cas/dist/server/actions/login.d.ts
./plugin-auth-cas/dist/client/Options.d.ts
./plugin-auth-cas/dist/server/plugin.d.ts
./plugin-auth-cas/server.d.ts
./plugin-auth-cas/dist/server/actions/service.d.ts
./plugin-auth-cas/dist/client/SigninPage.d.ts
./plugin-auth-cas/LICENSE.txt
```
