DPTCloud
Back to articles
Technology Insight

Tự Host Hệ Sinh Thái Supabase Edge Functions (Deno) Trên VPS Để Chạy Serverless Function Tự Chủ

June 6, 2026

Giới thiệu về Xu hướng Tự Chủ Hạ Tầng Serverless

Trong kỷ nguyên điện toán đám mây, Serverless Functions (FaaS) đã trở thành một thành phần cốt lõi giúp các nhà phát triển triển khai logic backend một cách nhanh chóng mà không cần quản lý máy chủ vật lý. Supabase Edge Functions—nền tảng được xây dựng dựa trên Deno Runtime—nổi tiếng nhờ tốc độ khởi động cực nhanh (low cold starts), hỗ trợ TypeScript nguyên bản và hiệu năng vượt trội so với các giải pháp dựa trên Node.js truyền thống.

Tuy nhiên, đối với các doanh nghiệp có tiêu chuẩn khắt khe về bảo mật dữ liệu, chủ quyền số (data sovereignty), hoặc muốn tối ưu chi phí vận hành cố định, việc phụ thuộc hoàn toàn vào hạ tầng Cloud của bên thứ ba không phải lúc nào cũng là phương án tối ưu. May mắn thay, triết lý mã nguồn mở của Supabase cho phép chúng ta tách rời thành phần này. Bài viết này sẽ hướng dẫn bạn chi tiết cách tự host hệ sinh thái Supabase Edge Functions trên một máy chủ ảo (VPS) riêng, mang lại quyền kiểm soát 100% đối với hệ thống Serverless của mình.

---

Tại sao nên tự host Supabase Edge Functions bằng Deno?

Việc chuyển dịch từ mô hình Managed Service sang tự vận hành trên VPS mang lại nhiều lợi ích chiến lược cho doanh nghiệp:

  • Chủ quyền dữ liệu tối đa: Toàn bộ mã nguồn, biến môi trường (secrets) và luồng dữ liệu của hàm xử lý đều nằm trọn trong ranh giới hạ tầng của bạn, đáp ứng các tiêu chuẩn khắt khe như GDPR hay HIPAA.
  • Tối ưu hóa chi phí cố định: Không còn lo ngại về chi phí phát sinh dựa trên số lượng request (pay-per-invocation). Bạn chỉ cần trả một khoản phí cố định cho tài nguyên VPS hàng tháng.
  • Hiệu năng đồng nhất: Khi chạy trên hạ tầng Docker cục bộ cận kề với cơ sở dữ liệu Postgres chính, độ trễ mạng (network latency) giữa Edge Function và database sẽ giảm xuống mức tối thiểu.
Lưu ý quan trọng: Khi tự host trên một VPS đơn lẻ, khái niệm "Edge" lúc này mang tính chất kiến trúc lập trình của Deno hơn là phân tán địa lý toàn cầu (Globally Distributed). Tuy nhiên, bạn hoàn toàn có thể cấu hình Load Balancer để mở rộng hệ thống này ra nhiều region nếu cần thiết.
---

Kiến Trúc Vận Hành Trên VPS

Trong hệ sinh thái tự host của Supabase qua Docker Compose, thành phần đảm nhận việc thực thi các hàm này là container supabase/edge-runtime. Luồng đi của một request sẽ được mô tả như sau:

  1. Request từ client gửi tới cổng API Gateway (mặc định là cổng Kong hoặc proxy HTTPS của bạn).
  2. Gateway xác thực mã định danh JWT hoặc API Key nếu được yêu cầu, sau đó chuyển hướng request đến dịch vụ functions (Edge Runtime).
  3. Supabase Edge Runtime đọc mã nguồn TypeScript từ thư mục liên kết (volume mount) trên VPS và tiến hành thực thi mã nguồn bằng engine V8 của Deno.
---

Hướng Dẫn Từng Bước Triển Khai Trên VPS

Bước 1: Chuẩn bị môi trường VPS

Trước khi bắt đầu, hãy đảm bảo VPS của bạn đang sử dụng hệ điều hành Linux (khuyến nghị Ubuntu 22.04 hoặc mới hơn) và đã cài đặt sẵn Docker cùng Docker Compose. Bạn có thể kiểm tra bằng lệnh:

docker --version && docker compose version

Bước 2: Cấu hình thư mục dự án và Docker Compose

Nếu bạn đang tự host toàn bộ hệ thống Supabase bằng Docker, dịch vụ functions thường đã được khai báo sẵn trong file docker-compose.yml. Cấu trúc thư mục tối thiểu trên VPS cần có dạng:


supabase-vps/
├── docker-compose.yml
├── .env
└── volumes/
    └── functions/
        └── hello-world/
            └── index.ts

Trong file docker-compose.yml, cấu hình của dịch vụ Edge Runtime cần đảm bảo ánh xạ chính xác thư mục chứa code của bạn:


functions:
  image: supabase/edge-runtime:v1.30.3 # Hoặc phiên bản mới nhất
  container_name: supabase-edge-runtime
  volumes:
    - ./volumes/functions:/usr/services
  environment:
    - JWT_SECRET=${JWT_SECRET}
    - SUPABASE_URL=http://kong:8000
    - SUPABASE_ANON_KEY=${ANON_KEY}
  command: start --main-service /usr/services
  ports:
    - "9000:9000"
  restart: unless-stopped

Bước 3: Viết mã nguồn Edge Function đầu tiên

Hãy tạo một hàm cơ bản bằng TypeScript sử dụng API tiêu chuẩn của Deno tại đường dẫn volumes/functions/hello-world/index.ts:


Deno.serve(async (req) => {
  try {
    const { name } = await req.json();
    const message = `Xin chào ${name || 'Khách'}, chào mừng bạn đến với Serverless tự chủ!`;
    
    return new Response(JSON.stringify({ success: true, message }), {
      headers: { "Content-Type": "application/json" },
      status: 200
    });
  } catch (error) {
    return new Response(JSON.stringify({ error: "Payload không hợp lệ" }), {
      headers: { "Content-Type": "application/json" },
      status: 400
    });
  }
});

Bước 4: Khởi động và kiểm tra dịch vụ

Sau khi đã chuẩn bị xong tệp cấu hình và mã nguồn, hãy khởi động container trên VPS bằng lệnh:

docker compose up -d functions

Để kiểm tra xem hàm của bạn có hoạt động chính xác hay không, hãy sử dụng curl hoặc các công cụ test API để gửi một request HTTP POST đến địa chỉ VPS của bạn:


curl -X POST http://:9000/hello-world \
  -H "Content-Type: application/json" \
  -d '{"name": "Doanh Nghiệp"}'

Kết quả trả về định dạng JSON mong muốn chứng minh hệ thống Serverless của bạn đã sẵn sàng tiếp nhận các tác vụ logic phức tạp hơn.

---

Quản Lý Biến Môi Trường Và Bảo Mật

Khi tự host, việc quản lý các chuỗi kết nối nhạy cảm (như API key của bên thứ ba, mật khẩu DB) đòi hỏi tính cẩn trọng cao. Bạn nên tận dụng tệp .env.functions chuyên biệt và khai báo nó vào phần env_file trong cấu hình Docker Compose.

Ngoài ra, đối với môi trường sản xuất (Production), việc phơi bày trực tiếp cổng 9000 ra Internet là cực kỳ nguy hiểm. Bạn cần thiết lập một Reverse Proxy như Nginx hoặc Caddy phía trước để cấu hình chứng chỉ SSL/TLS (HTTPS) miễn phí từ Let's Encrypt, giúp mã hóa toàn bộ dữ liệu truyền tải trên đường truyền.

---

Kết Luận và Định Hướng Tương Lai

Việc làm chủ hệ sinh thái Supabase Edge Functions trên VPS cá nhân mang lại sự linh hoạt tuyệt đối cho kiến trúc phần mềm của doanh nghiệp. Bạn vừa giữ được trải nghiệm phát triển hiện đại, tinh gọn của Deno Runtime, vừa không bị ràng buộc bởi các điều khoản thương mại hay rủi ro tăng giá từ nhà cung cấp Cloud. Đây là một bước đi chiến lược hướng tới một hạ tầng công nghệ tự chủ, tối ưu và bền vững.