Dify là gì? Cách tự host nền tảng AI workflow bằng Docker Compose

Tóm tắt nhanh:

langgenius/dify phù hợp để tự triển khai/thử nghiệm theo hướng evergreen, không chỉ đọc tin tức.

Bài này chỉ dùng lệnh và fact đã thấy trong nguồn chính thức. Mình chưa chạy full stack trong cron này.

Bạn nên thử ở máy lab/VPS riêng trước, bật bảo mật đầy đủ rồi mới nghĩ tới production.

langgenius/dify là gì?

Dify là nền tảng phát triển ứng dụng AI/agentic workflow. README chính thức nêu các điểm như visual workflow, hỗ trợ nhiều model provider, Prompt IDE, RAG Pipeline, agent capabilities và LLMOps. Quick start yêu cầu tối thiểu CPU >= 2 core, RAM >= 4 GiB và dùng Docker Compose để chạy dashboard tại http://localhost/install.

Nói ngắn gọn: nếu bạn đang muốn tự kiểm soát workflow AI hoặc backend thay vì phụ thuộc hoàn toàn vào dịch vụ đóng, đây là một candidate đáng thử. Điểm quan trọng là bạn phải đọc đúng README/docs chính thức, vì lệnh Docker, biến môi trường và yêu cầu tài nguyên có thể thay đổi theo version.

Khi nào nên dùng?

Bạn nên cân nhắc dùng langgenius/dify khi:

Muốn dựng môi trường lab để học, demo hoặc test nội bộ.
Cần kiểm soát dữ liệu, cấu hình và tích hợp nhiều dịch vụ hơn so với SaaS đơn giản.
Muốn có nền tảng mã nguồn mở có cộng đồng/GitHub/docs rõ ràng.
Có thời gian vận hành Docker, backup, log và update.

Không nên dùng ngay cho production nếu bạn chưa hiểu mô hình bảo mật, chưa có backup, chưa tách secret, hoặc chưa đọc release notes.

Cần chuẩn bị gì trước khi cài?

Máy local, homelab hoặc VPS có Docker/Docker Compose theo docs chính thức.
RAM/CPU theo yêu cầu tối thiểu của dự án, cộng thêm dư địa cho dữ liệu thật.
Domain/HTTPS nếu mở ra Internet.
File .env/secret được giữ riêng, không commit công khai.
Kế hoạch backup database/storage trước khi update.

Cách cài đặt hoặc chạy thử

Các lệnh dưới đây được ghi lại từ nguồn chính thức đã check. Trước khi chạy, bạn nên mở lại README/docs để kiểm tra version mới nhất.

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

Nếu docs có nhiều chế độ triển khai, hãy bắt đầu bằng Docker Compose/local quickstart trước. Sau khi hiểu cấu trúc service, bạn mới chuyển sang VPS, reverse proxy hoặc Kubernetes.

Cách sử dụng cơ bản sau khi chạy

Mở URL local/dashboard mà docs chỉ định.
Tạo tài khoản/admin hoặc project đầu tiên nếu wizard yêu cầu.
Kiểm tra trang settings, model/provider/API key hoặc database connection.
Tạo một workflow/app/test project nhỏ thay vì import dữ liệu thật ngay.
Ghi lại biến môi trường nào đã đổi để lần update sau không bị mất cấu hình.

Cách kiểm tra đã chạy đúng

Chạy docker compose ps hoặc lệnh tương đương để xem container còn healthy/running không.
Mở dashboard bằng trình duyệt và kiểm tra có wizard/login không.
Xem log container nếu service không lên.
Test một workflow hoặc request nhỏ trước khi đưa dữ liệu thật.

Lỗi thường gặp

Docker Compose sai phiên bản

Một số dự án yêu cầu Docker Compose bản mới. Nếu lệnh fail, kiểm tra docker compose version và đối chiếu docs.

Port bị trùng

Nếu dashboard không mở được, kiểm tra port 80/3000/8080 hoặc port mà docs dùng. Đổi port trong .env/compose khi cần.

Thiếu RAM hoặc disk

Các stack AI/self-hosted thường kéo nhiều image và service phụ. Nếu container restart liên tục, kiểm tra RAM, disk và log.

Secret/API key bị lộ

Không paste .env lên GitHub, Telegram hoặc ticket công khai. Nếu lộ, rotate ngay.

Lưu ý an toàn

Chỉ xử lý dữ liệu bạn có quyền dùng.
Không mở dashboard admin ra Internet khi chưa có auth, HTTPS và firewall.
Kiểm tra license/edition hiện tại trước khi dùng thương mại.
Với AI workflow, cần cảnh báo người dùng rằng output có thể sai và cần review.

FAQ

Bài này có chèn internal link không?

Không. Theo flow hiện tại, Duy sẽ tự chèn internal link thủ công.

Có thể chạy production ngay không?

Không nên. Hãy chạy lab trước, đọc docs production, bật backup/monitoring và test update.

Lệnh trong bài đã được chạy thật chưa?

Cron này chỉ deep research từ nguồn chính thức và tạo draft. Mình không giả vờ đã chạy full stack local.

Duy Nghiện

Hãy làm khán giả, đừng làm nhân vật chính :)