# Tự host Dify ở chỗ khách, biết trước lúc nào phải viết code

> Máy 4 GiB RAM là đủ chạy, nhưng sandbox và giấy phép mới quyết định Dify đi được bao xa.

Bản gốc: https://fdetimes.net/vi/cong-cu/dify-tu-host-nen-tang-ung-dung-llm-trong-ha-tang-khach/

Dify tự gọi mình là nền tảng mã nguồn mở. Nhưng file LICENSE trong repo có thêm một điều kiện: chưa được Dify cho phép bằng văn bản thì bạn không được dùng mã nguồn này để vận hành một môi trường multi-tenant.

Câu đó đáng đọc kỹ trước khi bạn mang Dify tới chỗ khách. Bản tự host cho phép dựng ứng dụng LLM chạy trên dữ liệu của khách, ngay trong hạ tầng của họ, và chính kiểu triển khai đó buộc bạn phải hỏi ai sẽ dùng chung bản cài này.

Đã chọn Dify thì bạn cần biết trước hai ranh giới, một do sandbox đặt ra, một do giấy phép đặt ra. Vượt ranh giới sandbox thì bạn phải tự viết code; vượt ranh giới giấy phép thì bạn cần văn bản cho phép của Dify, hoặc phải đổi kiến trúc.

## Dify làm được gì cho bạn ở chỗ khách?

Repo chính thức langgenius/dify mô tả một nền tảng gồm workflow, RAG, agent, quản lý model và observability. Theo tài liệu, bạn dựng được agent, agentic workflow và chatbot lấy dữ liệu của chính khách hàng. Agent gọi được tool, MCP server hoặc API tự viết.

Với FDE, chi tiết đáng giá nhất là ứng dụng nào cũng có sẵn API. Tài liệu Dify viết rõ là có thể nhúng ứng dụng Dify vào sản phẩm của khách qua REST API. Vì thế bạn kéo thả workflow trong giao diện để thử nhanh với khách, còn hệ thống của họ thì chỉ cần gọi một endpoint.

## Dựng bản đầu tiên trong một buổi chiều

README gọi Docker Compose là cách dễ nhất để khởi động server Dify, và liệt kê ba lựa chọn triển khai: Cloud, Community Edition tự host, và Enterprise. Quy trình tự host rất ngắn: clone một release tag, copy file .env, rồi chạy docker compose up. Về phần mềm, bạn cần Docker Compose từ bản 2.35.0 trở lên.

Về phần cứng, cấu hình tối thiểu cũng nhỏ, 2 nhân CPU và 4 GiB RAM. Ở những công ty mà xin một máy ảo cũng phải qua phiếu duyệt, con số này giúp bạn có một bản demo chạy trong mạng nội bộ trước buổi họp thứ hai với khách.

Khách cần nhiều hơn thế thì có bản Enterprise, nhắm tới việc triển khai trong VPC, on-prem hoặc mạng air-gapped, kèm Helm chart và module Terraform.

Dify nói bản này giữ dữ liệu trong vùng kiểm soát của khách, hỗ trợ SSO qua SAML/OIDC và chạy offline với model cục bộ. Mấy điểm này đều là cam kết của nhà cung cấp, nên bạn hãy tự kiểm tra trên môi trường thật trước khi hứa với khách.

## Code node là nơi kéo thả dừng lại

Khi các node trực quan không còn đủ, workflow có Code node để bạn viết Python hoặc JavaScript cho các phép biến đổi dữ liệu, phép tính và logic phức tạp. Đó là chỗ bạn bắt đầu viết code ngay trong Dify, và Code node có những giới hạn cứng mà bạn nên thuộc.

Code chạy trong một sandbox cách ly, không truy cập được file system, không chạy được lệnh hệ thống. Bạn chỉ import được các thư viện đã cài sẵn, import thứ khác thì lỗi lúc chạy. Output cũng bị giới hạn: mỗi chuỗi tối đa 400.000 ký tự, mỗi mảng tối đa 500 phần tử, lồng tối đa 3 cấp. Vượt giới hạn thì node lỗi.

Lấy một ví dụ giả định. Một khách bảo hiểm muốn tách một hồ sơ bồi thường thành từng dòng chi phí rồi cho LLM kiểm tra. Hồ sơ nhỏ có 120 dòng thì Code node chạy ổn. Gặp hồ sơ 1.200 dòng, mảng trả về vượt mức 500 phần tử và node lỗi đúng ở hồ sơ lớn nhất, cũng thường là hồ sơ khách quan tâm nhất.

Bạn có hai cách. Cách thứ nhất là chia lô trong workflow, chẳng hạn 500, 500 và 200, nhưng như vậy workflow phức tạp thêm. Cách thứ hai sạch hơn: viết một service nhỏ trong hạ tầng của khách để tự xử lý việc tách dòng, rồi cho agent gọi service đó như một custom API. Phần Dify còn giữ là điều phối và prompt.

**Điểm mấu chốt:** Nền tảng kéo thả chặn bạn ở đâu, hãy bắt đầu viết code ở đó.

Từ đó rút ra một quy tắc dễ nhớ. Logic chỉ cần biến đầu vào, output nhỏ và thư viện có sẵn thì để trong Code node. Cần đọc file, chạy lệnh, dùng gói mới hoặc trả về dữ liệu lớn thì tách ra service riêng ngay từ đầu, đừng chờ đến lúc nó lỗi trên production.

## Đọc giấy phép trước khi đọc docs

Giấy phép của Dify không phải Apache 2.0 thuần mà có thêm điều kiện. Ngoài câu về multi-tenant, nó còn cấm gỡ hoặc sửa logo và thông tin bản quyền trong console hay ứng dụng Dify. Điều khoản này không áp dụng nếu bạn không dùng frontend của Dify.

Quay lại khách bảo hiểm ở trên. Nếu bạn cài một bản Dify trong hạ tầng của chính họ và chỉ nhân viên của họ dùng, đó là một khách, một bản cài. Bài toán đổi hẳn khi công ty bạn là một agency và muốn phục vụ hãng bảo hiểm này cùng năm khách khác từ một bản Dify dùng chung.

Bản dùng chung đó rất gần với vùng multi-tenant mà giấy phép nhắc tới, nên bạn cần văn bản cho phép của Dify trước khi vận hành nó. Cách ít rủi ro hơn là mỗi khách một bản cài riêng. Với cấu hình tối thiểu 2 nhân CPU và 4 GiB RAM, thêm vài máy nhiều khả năng rẻ hơn một tranh chấp giấy phép.

Còn nếu hãng bảo hiểm muốn ứng dụng mang thương hiệu của họ, gọi app qua REST API và tự làm frontend là cách tránh điều khoản logo. Dù chọn hướng nào, hãy ghi rõ mô hình triển khai vào tài liệu kiến trúc để bộ phận pháp lý của khách đọc trước khi ký.

## Học gì trước, và ghi gì vào CV

Hãy bắt đầu từ ranh giới, đừng bắt đầu từ giao diện kéo thả. Tự dựng bằng Compose, gọi app qua REST API, rồi cố tình làm Code node lỗi vì quá 500 phần tử hoặc vì import gói không có sẵn. Sau đó viết một custom API nhỏ và cho agent gọi nó.

Khi đọc tin tuyển dụng FDE có nhắc tới các nền tảng low-code cho LLM, bạn hãy để ý xem họ có nhắc tới on-prem hay air-gapped không. Trong CV, đừng chỉ ghi "dùng Dify".

Một dòng cụ thể hơn có thể là: "Tự host Dify bằng Docker Compose trong mạng nội bộ của khách; tách bước xử lý hồ sơ lớn ra service riêng vì Code node giới hạn mảng 500 phần tử; chọn mỗi khách một bản cài để không rơi vào điều khoản multi-tenant." Dòng đó chỉ đáng ghi khi bạn đã thật sự làm từng vế của nó.

Vào phỏng vấn, hãy kể lại đúng dòng ấy theo thứ tự: bạn chạm giới hạn nào, bạn phát hiện nó ra sao, và vì sao bạn viết service thay vì chia lô. Người phỏng vấn sẽ nhớ lý do bạn rời Dify lâu hơn tốc độ bạn kéo thả.

**Thử ngay tuần này:**

- Clone một release tag của Dify, copy file .env, chạy docker compose up trên một máy 2 nhân CPU, 4 GiB RAM, rồi gọi một app qua REST API.
- Viết một Code node trả về mảng 600 phần tử và xem node báo lỗi ra sao, để biết trước lỗi này trông thế nào khi gặp ở chỗ khách.
- Đọc file LICENSE của repo langgenius/dify, rồi ghi lại xem kiến trúc bạn định đề xuất có phải multi-tenant không.

## Nguồn

- [langgenius/dify (GitHub)](https://github.com/langgenius/dify)

- [Dify Docs – Introduction](https://docs.dify.ai/en/use-dify/getting-started/introduction)

- [Deploy Dify with Docker Compose](https://docs.dify.ai/en/self-host/quick-start/docker-compose)

- [Dify Open Source License (LICENSE)](https://github.com/langgenius/dify/blob/main/LICENSE)

- [Dify Docs – Code node](https://docs.dify.ai/en/use-dify/nodes/code)

- [Dify Enterprise](https://dify.ai/enterprise)
