InsForge: Nền tảng Backend cho AI Coding Agent
InsForge/InsForge
InsForge là nền tảng backend mã nguồn mở cho AI coding agent điều khiển trực tiếp database Postgres, xác thực, lưu trữ và LLM gateway qua công cụ gọi được, thay vì để agent tự đoán hạ tầng. Nên dùng nếu quy trình agent của bạn đã dùng MCP và muốn agent tự cấp phát tài nguyên backend thật, không phải code giả lập. Nên bỏ qua nếu cần nền tảng đã ổn định lâu năm — Compute vẫn ở giai đoạn private preview, còn CLI+Skills chỉ chạy trên bản cloud.
InsForge là gì?
InsForge là nền tảng backend mã nguồn mở xây dựng cho AI coding agent, không phải cho lập trình viên con người. Nó gộp database Postgres, xác thực, lưu trữ tương thích S3, edge function serverless và một model gateway tương thích OpenAI, đứng sau một MCP server, để agent đọc được schema, log và nội dung bucket rồi tự cấu hình các thành phần đó. Bạn có thể tự host qua Docker Compose hoặc dùng bản cloud tại insforge.dev.
Các dịch vụ Backend cốt lõi cho Agent
- ✓Cơ sở dữ liệu quan hệ Postgres mà agent có thể truy vấn và chạy migration trực tiếp.
- ✓Authentication xử lý quản lý người dùng, phiên đăng nhập và các nhà cung cấp OAuth2.
- ✓Lưu trữ object tương thích S3 — mặc định dùng hệ thống file cục bộ, hoặc có thể chuyển sang MinIO, RustFS, hay một nhà cung cấp tương thích S3 khác.
- ✓Model Gateway: một API tương thích OpenAI định tuyến tới nhiều nhà cung cấp LLM khác nhau, nên agent không cần khai báo key riêng cho từng ứng dụng.
- ✓Edge Functions cho code serverless chạy ngay tại edge thay vì một tầng compute riêng biệt.
- ✓Compute (đang ở giai đoạn private preview) dành cho các dịch vụ container chạy dài hơi, khác với Edge Functions chạy ngắn hạn.
- ✓Một pipeline build và deploy site, để agent có thể triển khai luôn phần frontend vừa viết ra, không chỉ backend.
- ✓Một MCP server (tự host hoặc cloud) expose toàn bộ các dịch vụ trên dưới dạng công cụ gọi được, cộng thêm giao diện CLI+Skills chỉ có trên bản cloud dành cho agent thao tác qua terminal.
Tự host InsForge với Docker
Tự host cần cài Docker và Node.js trước. Clone repo, copy file env mẫu (`cp .env.example .env`), rồi khởi động cụm dịch vụ bằng `docker compose -f docker-compose.prod.yml up` — một file compose duy nhất này sẽ khởi chạy một instance InsForge cục bộ. Ngoài ra còn có nút deploy one-click và các template hosted cho Railway, Zeabur, Sealos nếu bạn không muốn chạy Docker tại máy. Lưu trữ mặc định dùng hệ thống file cục bộ; việc gắn thêm một store tương thích S3 (overlay MinIO hoặc RustFS đi kèm sẵn, hoặc bucket AWS S3, Wasabi, R2, Tencent COS, Aliyun OSS của riêng bạn) là một bước riêng, đồng thời bật luôn cổng gateway tương thích S3 tại `/storage/v1/s3`. Để chạy nhiều project trên cùng một máy, copy `.env.example` thành file env riêng cho từng project, đổi các port — ví dụ trong README dùng `POSTGRES_PORT=5442`, `POSTGREST_PORT=5440`, `APP_PORT=7230`, `AUTH_PORT=7231`, `DENO_PORT=7233` cho project thứ hai — rồi khởi động từng project với cờ `-p <tên-project>` riêng; mỗi project có database, lưu trữ và cấu hình tách biệt hoàn toàn.
Kết nối và kiểm tra InsForge MCP
Sau khi container đã chạy, mở `http://localhost:7130` và làm theo các bước trên màn hình để kết nối InsForge MCP Server với agent của bạn. Để kiểm tra kết nối có hoạt động thật hay không, hãy yêu cầu agent gọi công cụ `fetch-docs` của MCP để lấy tài liệu hướng dẫn của InsForge — nếu agent lấy được, nghĩa là nó đã có quyền truy cập backend ở cấp độ công cụ thật sự, chứ không chỉ một URL để đoán mò. CLI+Skills là lối kết nối còn lại, nhưng theo README thì lối này chỉ dành cho bản cloud, không áp dụng cho cụm tự host.
Điểm mạnh
- ✓MCP server nghĩa là bất kỳ agent nào tương thích MCP cũng có quyền truy cập backend ở cấp độ công cụ mà không cần viết tích hợp riêng cho từng agent — chỉ một giao diện chung, không phải N giao diện.
- ✓Các dịch vụ cốt lõi dùng những thứ lập trình viên đã quen thuộc — Postgres cho dữ liệu, API tương thích S3 cho lưu trữ — nên debug một backend do agent tự cấp phát không đòi hỏi học một mô hình dữ liệu riêng của InsForge.
- ✓Khả năng cô lập nhiều project (port riêng, tên project Docker Compose riêng) đã có sẵn trong phần quickstart, không phải thứ bạn phải tự xây dựng thêm.
- ✓Giấy phép Apache-2.0 cùng đường tự host được ghi rõ nghĩa là bạn không bị buộc phải phụ thuộc vào bản cloud insforge.dev.
Phạm vi hiện tại và những điều cần lưu ý
- △Compute — dịch vụ container chạy dài hơi — được README ghi rõ là đang ở giai đoạn private preview, nên chưa nên phụ thuộc vào nó cho khối lượng công việc production.
- △Giao diện CLI+Skills chỉ hoạt động với bản cloud; các bản tự host chỉ có MCP server làm kênh cho agent truy cập.
- △Lưu trữ mặc định là hệ thống file cục bộ chứ không phải object storage — bạn phải tự bật MinIO, RustFS, hoặc một bucket tương thích S3 bên ngoài, và tự khai báo thông tin đăng nhập cho store trước khi đưa vào production.
- △Tự vận hành InsForge nghĩa là phải tự đồng bộ Docker Compose, Node.js và file env riêng cho từng project — đường nâng cấp được README ghi lại chỉ là `git pull` rồi chạy lại compose, không có gì tự động hơn.
Lựa chọn thay thế cho InsForge
Câu hỏi thường gặp
InsForge được phát hành theo Apache License 2.0, như ghi trong repository GitHub của dự án.
InsForge có thể tự host bằng Docker Compose — clone repo, copy `.env.example` thành `.env`, rồi chạy `docker compose -f docker-compose.prod.yml up`; ngoài ra cũng có bản cloud tại insforge.dev.
InsForge dùng Postgres làm cơ sở dữ liệu quan hệ, một trong các dịch vụ backend cốt lõi mà agent có thể truy vấn và chạy migration trực tiếp.
AI agent tương tác với InsForge qua một MCP server expose các thao tác backend dưới dạng công cụ gọi được, hoặc trên bản cloud là qua CLI kết hợp với Skills gọi trực tiếp từ terminal.
InsForge hỗ trợ chạy nhiều project trên cùng một máy: mỗi project có file env riêng, dải port riêng và tên project Docker Compose riêng, giữ database, lưu trữ và cấu hình tách biệt nhau.
InsForge mặc định lưu file trên hệ thống file cục bộ, nhưng có thể chuyển sang lưu trữ tương thích S3 — overlay MinIO hoặc RustFS đi kèm sẵn, hoặc một nhà cung cấp bên ngoài như AWS S3, Wasabi, R2, Tencent COS, Aliyun OSS.
Vấn đề mà InsForge giải quyết
Coding agent có thể viết xong một luồng đăng nhập hay một migration database trong vài giây, nhưng thường không thấy và không chạm được vào backend mà những thay đổi đó phải chạy trên — agent không biết schema hiện tại, không đọc được log của function đã deploy, và không tự tạo được storage bucket nếu không có người thao tác qua dashboard trước. MCP server và giao diện CLI+Skills của InsForge lấp phần còn thiếu đó: cho agent quyền đọc schema, cấu hình auth, log runtime, cộng với khả năng tự chạy migration, tự deploy edge function và tự cấu hình storage.
Trường hợp sử dụng phù hợp nhất
- •Một AI coding agent xây dựng ứng dụng full-stack từ đầu đến cuối — agent có thể tự tạo schema Postgres, tự nối auth, và tự deploy các edge function nó vừa viết mà không cần người thao tác qua dashboard ở giữa.
- •Team chạy nhiều project do agent xây dựng trên cùng một máy, dùng file env riêng theo project và tên project Docker Compose của InsForge để giữ database, storage tách biệt.
- •Agent cần dùng LLM mà không phải khai báo API key riêng cho từng nhà cung cấp trong từng app — Model Gateway expose một endpoint tương thích OpenAI cho nhiều nhà cung cấp LLM khác nhau.
- •Các cụm tự host cần giữ backend nằm trên hạ tầng bạn tự kiểm soát thay vì tài khoản cloud của bên thứ ba, nhờ giấy phép Apache-2.0 và đường tự host bằng Docker Compose.
Nên thử — và nên bỏ qua khi nào
Nên thử InsForge nếu quy trình agent của bạn đã xoay quanh MCP và bạn muốn agent tự cấp phát bảng Postgres, auth, storage thật thay vì chỉ giả lập — đường tự host bằng Docker Compose phù hợp với team muốn giữ toàn bộ trên hạ tầng riêng. Nên bỏ qua nếu bạn cần dùng CLI+Skills qua terminal trong lúc tự host (theo README, lối này chỉ có trên bản cloud), hoặc nếu cần compute chạy dài hơi ở mức production ngay bây giờ — phần đó vẫn đang private preview.