Flowise

Cài Flowise từ Kho ứng dụng, tạo tài khoản quản trị, lưu API key của model dưới dạng credential, dựng và nhúng chatbot, và sao lưu các flow.

Cập nhật 09/10/2026 · 8 phút đọc

Flowise là công cụ kéo thả để dựng ứng dụng AI: bạn nối các khối model, prompt, bộ nhớ, tài liệu và công cụ trên một canvas để tạo chatbot, trợ lý trả lời dựa trên tài liệu của bạn hay agent nhiều bước. Mỗi flow sau đó nhúng được vào website hoặc gọi qua API. Dùng Flowise khi bạn muốn trợ lý AI riêng mà không phải viết nhiều mã, với flow và dữ liệu nằm trên server của mình.

Yêu cầu

Mục	Giá trị
Image	`flowiseai/flowise:3.1.2`
Giới hạn RAM	1024 MB, 1 CPU
Dung lượng trống để cài	khoảng 6,0 GB (image khoảng 3,4 GB)
Tên miền	tên miền hoặc subdomain đã trỏ về server, ví dụ `flow.example.com`
API key	của ít nhất một nhà cung cấp model (OpenAI, Anthropic, Google, DeepSeek…), nhập bên trong Flowise. Bạn trả phí trực tiếp cho nhà cung cấp.

Server phải có Docker (Kho ứng dụng → Cài Docker). Khách hàng cần gói hosting cho phép ứng dụng Docker và còn trống 1024 MB trong RAM (MB) cho ứng dụng; xem Kho ứng dụng và lưu trữ S3.

Cài đặt

Trỏ bản ghi A của tên miền về server.
Mở Kho ứng dụng và bấm Cài đặt trên thẻ Flowise.

Điền hộp thoại:

Trường	Nhập gì
Tên miền	ví dụ `flow.example.com`
Chủ sở hữu	Chỉ quản trị viên thấy: tài khoản hosting sở hữu ứng dụng
SSL miễn phí (Let's Encrypt)	Giữ bật

Bấm Cài đặt và theo dõi log tác vụ.

Flowise không có trường nào cần điền khi cài. ZoPanel gom mọi thứ Flowise ghi ra vào một thư mục và tắt telemetry:

Biến	Giá trị
`DATABASE_PATH`, `SECRETKEY_PATH`	`/home/node/.flowise`: database SQLite và khoá mã hoá credential
`BLOB_STORAGE_PATH`	`/home/node/.flowise/storage`: file tải lên
`LOG_PATH`	`/home/node/.flowise/logs`
`DISABLE_FLOWISE_TELEMETRY`	`true`

Lần khởi động đầu mất một tới hai phút. Trong lúc Flowise chưa phản hồi, website hiện trang "busy" và tự tải lại.

Tạo tài khoản quản trị khi khoá thiết lập đang bật

Người đầu tiên mở Flowise mới cài sẽ tạo tài khoản quản trị, nên ZoPanel giữ ứng dụng ở chế độ riêng tư. Khách truy cập thấy trang "This app is being set up".

Mở Website, chọn tên miền và vào tab Docker.
Khi trạng thái là running, bấm Mở ứng dụng (chỉ mình tôi).
Ở màn hình Setup Account, nhập tên quản trị viên, email (dùng để đăng nhập) và mật khẩu. Flowise yêu cầu tối thiểu 8 ký tự, có chữ hoa, chữ thường, chữ số và ký tự đặc biệt.
Đăng nhập.
Quay lại tab Docker, bấm Đã thiết lập xong — mở công khai.

ZoPanel không cấu hình email cho Flowise, nên các tính năng gửi email như link đặt lại mật khẩu không hoạt động. Hãy cất giữ mật khẩu quản trị cẩn thận.

Thêm credential (API key)

Flowise lưu key của nhà cung cấp dưới dạng Credentials, mã hoá bằng khoá trong thư mục dữ liệu; các khối trên canvas tham chiếu credential theo tên.

Ở menu trái, mở Credentials và bấm Add Credential.
Chọn nhà cung cấp, ví dụ OpenAI API hoặc Anthropic API.
Đặt tên, dán key và bấm Add.

Hãy đặt hạn mức chi tiêu ở trang quản lý của nhà cung cấp: mọi tin nhắn gửi tới chatbot đã công khai đều tính vào key của bạn.

Dựng và công khai một chatflow

Mở Chatflows và bấm Add New.
Kéo các khối từ menu + vào canvas, ví dụ một chat model (chọn credential của bạn), một khối bộ nhớ và một chain hoặc agent, rồi nối chúng lại.
Bấm Save và thử bằng nút chat trên canvas.
Bấm </> (API endpoint) để lấy đoạn mã nhúng vào website, hoặc URL của prediction API:
```
https://flow.example.com/api/v1/prediction/<chatflow-id>
```
Bảo vệ truy cập API bằng key tạo trong API Keys, và nếu nhúng vào website thì chỉ cho phép tên miền của bạn trong phần bảo mật của chatflow.

Để hỏi đáp trên tài liệu, dùng document loader, text splitter, khối embeddings và vector store. Vector store lưu dữ liệu ngay trong Flowise (ví dụ in-memory) hoặc dịch vụ công khai có quản lý (Pinecone, Qdrant Cloud, Supabase…) dùng được; database trên chính server thì không (xem mục Giới hạn mạng).

Dữ liệu nằm ở đâu

/var/lib/zopanel-apps/<instance>/data/

<instance> là tên miền với dấu chấm thay bằng dấu gạch ngang (flow.example.com → flow-example-com). Thư mục được gắn vào /home/node/.flowise, chứa database (database.sqlite: người dùng, chatflow, credential, tin nhắn, API key), khoá mã hoá (encryption.key), file tải lên trong storage/ và log trong logs/. Chỉ root và container đọc được.

Quan trọng: database và khoá mã hoá luôn đi cùng nhau. Khôi phục database mà thiếu khoá sẽ gặp lỗi "Credentials could not be decrypted".

Sao lưu

Sao lưu website của ZoPanel không gồm /var/lib/zopanel-apps; ứng dụng được sao lưu bằng thẻ Sao lưu trong tab Docker của website, gồm cả database lẫn khoá mã hoá của nó.

Để sao lưu Flowise, bấm Sao lưu ngay trong thẻ Sao lưu ở tab Docker của website. Quản trị viên còn đặt được Lịch (Tắt, Mỗi ngày hoặc Mỗi tuần; mặc định tắt) và số bản Giữ lại (1–60, mặc định 7), rồi bấm Lưu. Mỗi bản sao lưu nén /var/lib/zopanel-apps/<instance>/ thành /var/backups/zopanel-apps/<instance>/YYYYMMDD-HHMMSS.tar.gz, trong thư mục chỉ root đọc được và không tính vào dung lượng đĩa của tài khoản. Container được tạm dừng (pause, không phải stop) trong vài giây sao chép, nên database SQLite nhất quán. Các bản cũ vượt quá số Giữ lại bị xoá, và khi một lần sao lưu theo lịch thất bại, quản trị viên nhận cảnh báo Sao lưu thất bại.

Để khôi phục, quản trị viên bấm Khôi phục cạnh một bản sao lưu. Flowise được dừng và dữ liệu được thay bằng nội dung file nén; dữ liệu hiện tại được giữ riêng tới khi ứng dụng khôi phục khởi động được, và được đặt lại nếu nó không khởi động. Mọi thay đổi sau thời điểm sao lưu sẽ mất. Mỗi bản sao lưu còn có nút xoá (chỉ quản trị viên), và xoá ứng dụng kèm file của nó cũng xoá luôn các bản sao lưu. Khách hàng có thể bấm Sao lưu ngay và xem danh sách; việc đặt lịch và khôi phục do nhà cung cấp thực hiện. Khách hàng cũng có thể xuất từng chatflow từ menu thiết lập trên canvas (Export Chatflow) để giữ bản sao của flow; credential không đi kèm và phải thêm lại.

Các file nén vẫn ở trên cùng máy chủ. Hãy chép những bản quan trọng ra ngoài (ví dụ bằng scp hoặc rclone từ /var/backups/zopanel-apps/<instance>/) và lưu ở dạng mã hoá, vì chúng chứa khoá mã hoá, tức là mở được mọi API key đã lưu. Để khôi phục trên máy chủ khác, cài Flowise với cùng tên miền ở đó, chép file nén vào /var/backups/zopanel-apps/<instance>/ trên máy chủ mới rồi bấm Khôi phục trong thẻ Sao lưu của nó.

Cập nhật

Quản trị viên bấm Cập nhật bản mới ở tab Docker. ZoPanel kéo image mà phiên bản ZoPanel hiện tại đã ghim (flowiseai/flowise:3.1.2), tạo lại container và giữ nguyên dữ liệu. Phiên bản Flowise mới hơn đến cùng các bản cập nhật ZoPanel. Flowise chuyển đổi database khi khởi động, nên hãy sao lưu trước (Sao lưu ngay). Khách hàng nhờ nhà cung cấp cập nhật.

Giới hạn mạng

Container bị chặn khỏi loopback (127.0.0.1) và mạng nội bộ của server, khỏi địa chỉ link-local và khỏi các container khác. Trên chính server, container chỉ tới được cổng 80, 443, 25, 465, 587 và DNS. Với Flowise:

Khối nào gọi localhost hay địa chỉ nội bộ đều thất bại: server model Ollama, LocalAI, hay PostgreSQL, MySQL, Redis, Qdrant trên cùng server hoặc trong mạng nội bộ của bạn.
Thay vào đó, dùng API công khai và dịch vụ có quản lý: nhà cung cấp model, vector database được host sẵn, HTTP API công khai.
Các website của bạn trên cùng server vẫn gọi được qua tên miền công khai bằng HTTPS (cổng 443), ví dụ khối HTTP request gọi API của chính bạn.
Không gọi trực tiếp được ứng dụng khác trong Kho ứng dụng; hãy gọi qua tên miền công khai của nó.

Xử lý sự cố

Vấn đề	Cách xử lý
Ngay sau khi cài thấy "This website is very busy right now"	Flowise vẫn đang khởi động. Chờ một hai phút.
Khách truy cập thấy "This app is being set up"	Bấm Đã thiết lập xong — mở công khai ở tab Docker.
Mật khẩu bị từ chối ở Setup Account	Dùng từ 8 ký tự, có chữ hoa, chữ thường, chữ số và ký hiệu.
`Credentials could not be decrypted`	Database được khôi phục mà thiếu `encryption.key`. Khôi phục cả hai từ cùng một bản sao lưu, hoặc thêm lại credential.
`ECONNREFUSED 127.0.0.1` hoặc timeout tới IP nội bộ	Bị chặn có chủ đích; hãy dùng endpoint công khai.
Lỗi từ model (401, 429, hết hạn mức)	Kiểm tra key trong credential và số dư ở nhà cung cấp.
Tải tài liệu lớn lên bị lỗi	Request qua nginx bị giới hạn theo dung lượng upload của website (mặc định 256 MB). Tăng Upload tối đa (MB) trong tab Công cụ → Dung lượng upload của website.
Container khởi động lại khi xử lý tài liệu	Đã chạm giới hạn 1024 MB. Chia nhỏ tài liệu khi tải lên hoặc dùng embeddings và vector store được host sẵn.
`not enough disk space: this app needs about 6.0 GB free…`	Giải phóng dung lượng rồi cài lại.

Xem Log ứng dụng ở tab Docker để đọc lỗi từ ứng dụng.

Xem thêm

← OpenClaw Email →