Sebastian Petrus

Posted on Jul 10 • Originally published at apidog.com

Công cụ CLI Mã Nguồn Mở Miễn Phí Quản Lý API

Quản lý API hiện đại không nên phụ thuộc vào thao tác thủ công trên GUI. Thay vào đó, hãy định nghĩa routes, plugin và rate limit trong tệp cấu hình; commit chúng vào Git; rồi dùng CLI để triển khai lên gateway. Quy trình này giúp cấu hình đã review luôn khớp với cấu hình đang chạy, đồng thời phù hợp với CI/CD.

Dùng thử Apidog ngay hôm nay

Với gateway tự vận hành, giấy phép là một tiêu chí kỹ thuật quan trọng. Nó quyết định bạn có thể tự host, fork và phân phối phần mềm mà không phát sinh chi phí theo người dùng hay không. Các công cụ bên dưới chủ yếu dùng Apache 2.0 hoặc MPL 2.0: mã nguồn sẵn có, có thể chạy trên hạ tầng của bạn và không yêu cầu phí cố định theo seat.

Bài viết này tập trung vào các gateway mã nguồn mở có quy trình làm việc tốt từ terminal:

Kong Gateway OSS với decK
Tyk
KrakenD Community Edition
Apache APISIX
Gravitee

Bạn sẽ thấy giấy phép, vai trò thực tế của CLI và các lệnh có thể đưa ngay vào terminal hoặc pipeline. Nếu cần phạm vi rộng hơn, xem bài các công cụ quản lý API mã nguồn mở. Bạn cũng nên đọc lướt văn bản giấy phép Apache 2.0 trước khi đưa một gateway vào stack của mình.

Lưu ý: Apidog xuất hiện ở phần cuối nhưng không phải công cụ mã nguồn mở. Đây là sản phẩm thương mại có cấp độ miễn phí.

Điều gì khiến một CLI quản lý API thực sự là mã nguồn mở?

Đừng chỉ nhìn vào việc công cụ có bản miễn phí hay không. Hãy kiểm tra ba yếu tố sau.

1. Giấy phép của gateway cốt lõi

Tìm giấy phép như Apache 2.0, MIT hoặc MPL 2.0 trên chính gateway, không chỉ ở SDK client.

Apache 2.0: cho phép tự host, sửa đổi và phân phối.
MPL 2.0: là copyleft ở cấp tệp. Các thay đổi với tệp MPL phải vẫn mở, nhưng bạn có thể kết hợp với mã hoặc plugin độc quyền nếu chúng ở tệp riêng.
Source-available hoặc BSL không tương đương mã nguồn mở. Hãy đọc trực tiếp tệp LICENSE trong repository.

2. Có thể tự host đầy đủ

Gateway cần chạy trên hạ tầng của bạn mà không phụ thuộc vào máy chủ cấp phép. Bạn phải kiểm soát data plane và không bị giới hạn Community Edition đến mức chỉ dùng được như bản demo.

3. Repository được duy trì và CLI có thể tự động hóa

Số sao GitHub chỉ là tín hiệu phụ. Hãy ưu tiên:

Lịch sử commit gần đây
Release và changelog rõ ràng
Cấu hình có thể version trong Git
Lệnh có thể chạy trong CI
Khả năng kiểm tra thay đổi trước khi triển khai

Để nắm phần nền tảng, xem quản lý API thực sự bao gồm những gì.

Kong Gateway OSS với decK

Kong Gateway OSS được cấp phép Apache 2.0. Gateway được điều khiển qua Admin API, nhưng công cụ phù hợp cho quy trình GitOps là decK.

decK cho phép export trạng thái gateway thành YAML, chỉnh sửa trong repository, rồi đồng bộ ngược lại. Trước khi áp dụng, nó so sánh trạng thái hiện tại với cấu hình khai báo để bạn biết chính xác tài nguyên nào sẽ thay đổi.

# Xuất cấu hình Kong hiện tại ra tệp YAML
deck gateway dump -o kong.yaml

# Đồng bộ cấu hình từ Git vào gateway
deck gateway sync kong.yaml

Cách đưa vào CI

# Ví dụ: chạy trong pipeline sau khi kiểm tra YAML
deck gateway sync kong.yaml

Phù hợp khi: bạn đã dùng Kong và muốn quản lý routes, services, consumers hoặc plugin bằng Git, pull request và CI.

Giới hạn thực tế: decK chỉ dành cho Kong và tập trung vào cấu hình gateway. Nó không thay thế công cụ thiết kế API, tạo tài liệu hoặc kiểm thử endpoint. Ngoài ra, Kong là một stack đầy đủ hơn so với gateway dạng binary đơn.

Tyk

Tyk Gateway là mã nguồn mở theo MPL 2.0. Gateway cốt lõi viết bằng Go và hỗ trợ REST, GraphQL, TCP cùng gRPC.

CLI đáng chú ý của Tyk là bundle, được tích hợp trong gateway binary từ phiên bản 2.8. Nó đóng gói middleware tùy chỉnh thành bundle để gateway có thể tải và sử dụng.

# Tạo bundle plugin từ manifest và mã middleware
tyk bundle build -o bundle.zip

Quy trình triển khai plugin

Viết middleware và manifest.
Chạy tyk bundle build.
Lưu bundle tạo ra như một artifact của pipeline.
Cấu hình gateway để tải bundle đó.

Phù hợp khi: bạn cần mở rộng gateway bằng middleware xác thực, chuyển đổi request/response hoặc logic tùy chỉnh, đồng thời muốn đóng gói plugin theo cách lặp lại được.

Giới hạn thực tế: CLI chủ yếu phục vụ việc đóng gói plugin, không cung cấp quy trình cấu hình khai báo đầy đủ cho toàn bộ gateway. Nhiều tác vụ quản lý vẫn thực hiện qua Gateway API hoặc Tyk Dashboard, trong đó Dashboard là phần trả phí.

KrakenD Community Edition

KrakenD Community Edition là gateway hiệu suất cao, không trạng thái và được cấp phép Apache 2.0.

Đặc điểm quan trọng nhất là KrakenD không yêu cầu cơ sở dữ liệu cho trạng thái gateway. Cấu hình nằm trong tệp cấu hình, vì vậy Git có thể trở thành nguồn chân lý duy nhất.

Binary krakend đồng thời là CLI:

# Kiểm tra và lint cấu hình trước khi triển khai
krakend check -c krakend.json --lint

# Chạy gateway với cấu hình đã kiểm tra
krakend run -c krakend.json

Dùng trong pipeline

# Pipeline chỉ triển khai khi cấu hình hợp lệ
krakend check -c krakend.json --lint && \
krakend run -c krakend.json

KrakenD hỗ trợ Flexible Configuration. Khi bật FC_ENABLE=1, bạn có thể tách cấu hình lớn thành template và biến môi trường, giúp tái sử dụng cấu hình giữa các môi trường.

Phù hợp khi: bạn muốn gateway khai báo hoàn toàn, không trạng thái và lấy cấu hình trong Git làm nguồn chân lý.

Giới hạn thực tế: Community Edition không có persistent storage hoặc giao diện quản trị tích hợp. Đây là lợi thế nếu bạn theo IaC, nhưng có thể là trở ngại nếu đội ngũ cần thao tác qua UI.

Apache APISIX

Apache APISIX là dự án cấp cao của Apache Software Foundation, được cấp phép Apache 2.0. Đây là dự án mã nguồn mở đầy đủ của ASF, không phải một Community Edition rút gọn của sản phẩm thương mại.

APISIX cung cấp:

CLI cho các tác vụ vòng đời gateway
REST Admin API để quản lý routes và plugin
Admin API mặc định liên kết với 127.0.0.1
Khả năng reload cấu hình mà không làm mất kết nối

# Xem các lệnh APISIX có sẵn
apisix help

# Khởi động gateway
apisix start

# Áp dụng thay đổi cấu hình mà không dừng gateway
apisix reload

Khi cần cập nhật runtime

# Sau khi thay đổi cấu hình hoặc cập nhật qua Admin API
apisix reload

Phù hợp khi: bạn cần định tuyến động, thông lượng cao và muốn thay đổi routes hoặc plugin trong thời gian chạy.

Giới hạn thực tế: cấu hình route thường được quản lý qua Admin API thay vì một lần đồng bộ CLI khai báo duy nhất. Với quy trình GitOps, bạn thường cần script gọi Admin API hoặc bổ sung công cụ như ADC của APISIX.

Gravitee

Gravitee APIM có phần lõi mã nguồn mở theo Apache 2.0. Community Edition gồm:

APIM Gateway cho runtime
APIM API cho giao diện quản lý REST
APIM Console

Một số tính năng doanh nghiệp, chẳng hạn API bất đồng bộ event-native, thuộc phiên bản trả phí. Tuy nhiên, lõi quản lý REST vẫn là OSS và có thể tự host.

Quản trị Gravitee hằng ngày chủ yếu đi qua Management REST API và Console. Quy trình cài đặt tự host chính thức thường dùng Docker CLI.

# Chạy Gravitee APIM Gateway bằng Docker
docker run --name gravitee-gateway -p 8082:8082 graviteeio/apim-gateway:latest

Có graviteeio-cli do cộng đồng duy trì, dùng để bao bọc Management API và tự động hóa thao tác trên module. Tuy nhiên, đây không phải binary chính thức, vì vậy cần đánh giá trạng thái bảo trì trước khi đưa vào quy trình production.

Phù hợp khi: bạn muốn một lớp quản lý API OSS đầy đủ gồm gateway, console và Management API để script hóa.

Giới hạn thực tế: giao diện tự động hóa chính thức là REST Management API, không phải một CLI duy nhất được đầu tư đầy đủ. CLI cộng đồng có thể lấp khoảng trống nhưng đi kèm rủi ro bảo trì.

Vị trí của Apidog

Apidog không phải phần mềm mã nguồn mở, nên không thuộc danh sách gateway OSS phía trên. Đây là sản phẩm thương mại có cấp độ miễn phí.

Các công cụ như Kong, Tyk, KrakenD, APISIX và Gravitee tập trung vào lưu lượng, routes, plugin và chính sách gateway. Chúng không thay thế toàn bộ quy trình thiết kế schema, kiểm thử endpoint, tạo mock hoặc xuất tài liệu API.

Nếu ghép công cụ riêng lẻ, bạn có thể cần Spectral, openapi-generator, mock server và Newman với các cấu hình khác nhau. Apidog gom thiết kế, kiểm thử, mock và tài liệu vào một workspace; apidog-cli cung cấp đường dẫn terminal cho các tác vụ này.

# Cài đặt Apidog CLI
npm install -g apidog-cli

# Xác thực bằng token
apidog login --with-token <TOKEN>

# Chạy kịch bản kiểm thử trong CI
# Lệnh trả về mã lỗi nếu kiểm thử thất bại
apidog run

CLI xuất JSON có cấu trúc với agentHints.nextSteps, phù hợp để tích hợp vào CI hoặc workflow AI agent. Nếu bạn làm việc qua Claude Code hoặc công cụ tương tự, xem hướng dẫn quản lý API mà không cần rời khỏi AI agent.

Apidog CLI cũng hỗ trợ import/export OpenAPI, chạy kịch bản và điều khiển mock từ dòng lệnh. Xem hướng dẫn hoàn chỉnh về Apidog CLI để biết các nhóm lệnh.

Hãy xem Apidog như một lớp bổ sung cho gateway OSS tự host, không phải sự thay thế cho gateway.

Cách lựa chọn

Công cụ	Tốt nhất cho	Giấy phép	Mã nguồn mở?	CLI/lệnh
Kong Gateway OSS + decK	Cấu hình IaC cho Kong trong Git	Apache 2.0	Có	`deck gateway sync`
Tyk	Đóng gói plugin tùy chỉnh, đa giao thức	MPL 2.0	Có	`tyk bundle build`
KrakenD CE	Gateway không trạng thái, cấu hình dưới dạng mã	Apache 2.0	Có	`krakend run`
Apache APISIX	Định tuyến động thông lượng cao	Apache 2.0	Có, dự án ASF	`apisix start` / `apisix reload`
Gravitee	Lớp quản lý OSS đầy đủ kèm console	Apache 2.0	Có, phần lõi	Docker CLI / REST API
Apidog CLI	Thiết kế, kiểm thử, mock và tài liệu trong một	Freemium	Không	`apidog run`

Chọn theo quy trình triển khai thay vì số sao GitHub:

Đã dùng Kong và cần GitOps: chọn decK.
Muốn gateway không trạng thái, cấu hình hoàn toàn bằng tệp: chọn KrakenD.
Cần thay đổi route động khi runtime: chọn APISIX.
Cần gateway kèm lớp quản lý và console: chọn Gravitee.
Cần đóng gói middleware tùy chỉnh: cân nhắc Tyk.

Để xem thêm cả công cụ thương mại, đọc các công cụ quản lý API tốt nhất cho năm 2026. Nếu đang xây dựng stack API-first, xem thêm hướng tiếp cận quản lý API không đầu (headless).

Tóm tắt

Quản lý API mã nguồn mở từ CLI đã đủ trưởng thành cho quy trình Git, review và CI/CD.

Kong OSS + decK phù hợp với cấu hình Kong dạng IaC.
Tyk hữu ích khi cần đóng gói plugin tùy chỉnh.
KrakenD CE phù hợp với gateway không trạng thái, khai báo hoàn toàn bằng cấu hình.
Apache APISIX mạnh ở thay đổi định tuyến động.
Gravitee cung cấp lớp quản lý OSS đầy đủ hơn gateway đơn thuần.

Với thiết kế, kiểm thử, mock và tài liệu API — các phần mà gateway không trực tiếp xử lý — bạn có thể tải xuống Apidog và chạy apidog run trong pipeline bên cạnh gateway OSS đã chọn.

DEV Community