PentAGI

1. PentAGI là gì?

PentAGI là một hệ thống mã nguồn mở dùng AI để hỗ trợ kiểm thử thâm nhập (penetration testing, viết tắt là pentest) — tức là dò tìm lỗ hổng bảo mật của một hệ thống để vá lại trước khi kẻ xấu khai thác. Nó điều khiển các công cụ an ninh quen thuộc (như nmap, sqlmap, metasploit) trong môi trường cách ly bằng Docker, và có giao diện web để quản lý.

Cảnh báo pháp lý quan trọng, đọc trước khi cài: PentAGI chỉ được phép dùng để kiểm thử những hệ thống, máy chủ, mạng mà bạn sở hữu hoặc có văn bản cho phép rõ ràng từ chủ sở hữu. Dò quét hay tấn công hệ thống của người khác khi chưa được phép là vi phạm pháp luật ở Việt Nam và nhiều nước. Điều khoản sử dụng (EULA) của dự án nêu rõ chỉ dùng cho mục đích hợp pháp và được ủy quyền. Hướng dẫn này chỉ dừng ở việc cài đặt và chạy thử lần đầu.

Nói thẳng: đây là công cụ chuyên môn dành cho người làm an ninh mạng, không phải ứng dụng phổ thông. Nó cần Docker, dòng lệnh, và ít nhất một khóa API của mô hình AI (thường mất phí).

Hợp với bạn nếu:

• Bạn làm an ninh mạng hoặc học về bảo mật, có môi trường thử nghiệm của riêng mình (máy ảo, phòng lab).
• Bạn quen dùng Docker và dòng lệnh.

Chưa hợp nếu:

• Bạn không có hệ thống được phép kiểm thử.
• Bạn tìm một ứng dụng bấm-là-chạy, không muốn cài Docker hay cấu hình khóa API.

2. Cần chuẩn bị gì?

• Máy tính chạy Linux, macOS hoặc Windows (trình cài có bản cho cả ba hệ điều hành). Yêu cầu chính của dự án là có Docker.
• Cấu hình tối thiểu: 2 nhân CPU trở lên, 4 GB RAM, 20 GB ổ trống. Cần kết nối mạng để tải ảnh và gọi mô hình AI.
• Docker và Docker Compose (hoặc Podman): phần mềm chạy các thành phần trong "hộp" cách ly. Tải tại https://www.docker.com/
• Ít nhất một khóa API của mô hình AI (bắt buộc, PentAGI không chạy nếu thiếu): ví dụ khóa của OpenAI, Anthropic, hoặc Google Gemini. Các dịch vụ này thường tính phí theo dung lượng dùng. (Có thể dùng mô hình cục bộ qua Ollama nếu máy đủ mạnh.)
• Môi trường cách ly: nên chạy PentAGI trong một máy ảo hoặc mạng riêng tách biệt để an toàn.

3. Cài đặt từng bước

Có hai cách: dùng trình cài tương tác (khuyến nghị) hoặc dựng thủ công bằng Docker Compose.

Cách A — Bước 1: Tải trình cài tương tác

Trình cài là một giao diện chạy trong cửa sổ dòng lệnh, tự kiểm tra máy, tạo file cấu hình, giúp bạn nhập khóa API và khởi động hệ thống. Tải bản hợp với hệ điều hành từ trang chính thức, ví dụ với Linux (64-bit Intel):

mkdir -p pentagi && cd pentagi
wget -O installer.zip https://pentagi.com/downloads/linux/amd64/installer-latest.zip
unzip installer.zip

Các bản khác, cùng dạng installer-latest.zip, là: Linux arm64 https://pentagi.com/downloads/linux/arm64/installer-latest.zip, Windows https://pentagi.com/downloads/windows/amd64/installer-latest.zip, macOS Intel https://pentagi.com/downloads/darwin/amd64/installer-latest.zip, macOS chip Apple https://pentagi.com/downloads/darwin/arm64/installer-latest.zip. Chỉ tải từ các link chính thức này (có trong README ở https://github.com/vxcontrol/pentagi).

Cách A — Bước 2: Chạy trình cài

sudo ./installer

Làm theo các bước trên màn hình: kiểm tra hệ thống, nhập khóa API mô hình AI, đặt mật khẩu, rồi để trình cài khởi động PentAGI.

Thấy gì là đúng: trình cài báo các bước kiểm tra đạt (Docker, mạng), rồi khởi động xong các container.

Cách B — Bước 1: Dựng thủ công (tải cấu hình mẫu)

Nếu bạn quen Docker, có thể dựng tay. Tạo thư mục và lấy file cấu hình mẫu cùng hai file nhà cung cấp mẫu đi kèm:

mkdir pentagi && cd pentagi
curl -o .env https://raw.githubusercontent.com/vxcontrol/pentagi/master/.env.example
curl -o example.custom.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/master/examples/configs/custom-openai.provider.yml
curl -o example.ollama.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/master/examples/configs/ollama-llama318b.provider.yml

Cách B — Bước 2: Điền khóa API

Mở file .env bằng trình soạn thảo và điền ít nhất một khóa API mô hình AI, ví dụ:

OPEN_AI_KEY=khoa_openai_cua_ban
ANTHROPIC_API_KEY=khoa_anthropic_cua_ban
GEMINI_API_KEY=khoa_gemini_cua_ban

Đồng thời đổi các mật khẩu và khóa mặc định (như COOKIE_SIGNING_SALT, mật khẩu cơ sở dữ liệu) sang chuỗi ngẫu nhiên của riêng bạn trước khi dùng thật.

PentAGI còn dùng một mô hình "embedding" (biến văn bản thành số để lưu trí nhớ và tìm kiếm). Mặc định nó dùng OpenAI: nếu bạn để trống EMBEDDING_URL và EMBEDDING_KEY, nó lấy OPEN_AI_KEY. Nếu bạn chỉ có khóa của hãng khác, hãy xem mục embedding trong README chính thức để cấu hình riêng.

Cách B — Bước 3: Tải file khởi động và chạy

curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/master/docker-compose.yml
docker compose up -d

Xem tiến trình bằng docker compose logs -f.

Thấy gì là đúng: các container tải về và chuyển sang trạng thái đang chạy, không báo lỗi khởi động.

4. Dùng lần đầu

Bước 1: Mở giao diện và đăng nhập

Mở trình duyệt vào https://localhost:8443. Vì dùng chứng chỉ tự ký, trình duyệt sẽ cảnh báo không an toàn — với máy của chính bạn, chọn tiếp tục để vào. Tài khoản mặc định là admin@pentagi.com với mật khẩu admin.

Lưu ý: Hãy đổi mật khẩu mặc định ngay sau lần đăng nhập đầu tiên, trước khi dùng cho việc thật.

Bước 2: Tạo một luồng kiểm thử (flow)

Vào mục Flows ở thanh bên, bấm New Flow. Chọn chế độ:

• Assistant (trợ lý): AI đề xuất từng bước, bạn duyệt trước khi chạy. Nên chọn chế độ này cho lần đầu để quan sát.
• Automation (tự động): AI tự thực hiện toàn bộ theo mục tiêu.

Chọn nhà cung cấp mô hình AI bạn đã cấu hình.

Bước 3: Khai báo mục tiêu và phạm vi được phép

Mô tả mục tiêu bằng lời thường, và chỉ nhập địa chỉ/hệ thống mà bạn được phép kiểm thử (ví dụ một máy ảo trong lab của bạn). Nêu rõ phạm vi và giới hạn. Với chế độ Assistant, quan sát từng lệnh AI đề xuất và bấm duyệt trước khi nó chạy.

Thấy gì là đúng: PentAGI mở trang luồng, hiển thị các bước AI dự định làm và nhật ký hoạt động của công cụ.

5. Lỗi thường gặp và cách sửa

• Trình duyệt cảnh báo chứng chỉ không an toàn khi mở https://localhost:8443. Nguyên nhân: PentAGI dùng chứng chỉ tự ký. Với máy của chính bạn, đây là bình thường — chọn tiếp tục để vào.
• docker: command not found hoặc container không khởi động. Nguyên nhân: chưa cài hoặc chưa mở Docker. Cách sửa: cài Docker từ https://www.docker.com/ và bảo đảm nó đang chạy trước khi gõ lệnh.
• Tải ảnh Docker thất bại (mạng hạn chế). Nguyên nhân: máy không ra được Docker Hub. Cách sửa: bảo đảm máy vào được docker.io; nếu qua proxy, cấu hình proxy cho Docker (không chỉ cho PentAGI). Xem tài liệu Docker chính thức.
• Tạo luồng xong nhưng nó đứng im, không tiến triển. Nguyên nhân thường gặp: cấu hình mô hình vector (embedding) sai hoặc không gọi được. Cách sửa: xem log docker logs pentagi tìm lỗi 401/403/404 hoặc timeout; kiểm tra lại khóa API và tên mô hình trong .env; dùng công cụ kiểm tra có sẵn docker exec -it pentagi /opt/pentagi/bin/etester test -verbose để thử riêng phần embedding.
• Lỗi "failed to select primary docker image via llm call". Nguyên nhân: vấn đề ở mô hình AI đã cấu hình (lệnh gọi mô hình đầu tiên của luồng là chọn ảnh Docker, nên lỗi này thường do máy chủ mô hình không trả lời hợp lệ), không phải ở Docker. Cách sửa: kiểm tra lại khóa API và mô hình AI đang dùng còn hiệu lực.
• macOS báo trình cài là mã độc. Nguyên nhân: máy Mac chặn phần mềm tải ngoài. Cách sửa: chỉ tải từ đường dẫn chính thức của dự án, chọn đúng bản cho chip máy, rồi vào System Settings → Privacy & Security để cho phép mở nếu bạn đã tin nguồn tải.

6. Gỡ cài đặt và cập nhật

• Dừng hệ thống: trong thư mục cài chạy docker compose down.
• Cập nhật: nếu dùng trình cài, mở lại nó và chọn mục Maintenance → Update PentAGI để cập nhật lên bản mới (mục này chỉ hiện khi bản đang cài chưa được xác nhận là mới nhất). Nếu dựng thủ công, tải lại docker-compose.yml mới, chạy docker compose pull rồi docker compose up -d.
• Gỡ sạch: sau khi docker compose down, xóa thư mục cài đặt. Lưu ý dữ liệu của từng luồng nằm trong thư mục dữ liệu và có thể cần xóa thủ công để lấy lại dung lượng.

7. Câu hỏi hay gặp

• Có mất tiền không? Bản thân PentAGI miễn phí, mã nguồn mở (giấy phép MIT). Nhưng nó gọi mô hình AI qua khóa API, và các dịch vụ AI thường tính phí theo dung lượng dùng. Nếu dùng mô hình cục bộ (Ollama) thì không mất phí AI nhưng cần máy mạnh.
• Có cần mạng không? Cần, để tải ảnh Docker và gọi mô hình AI (trừ khi bạn dùng mô hình cục bộ).
• Tôi có được quét website của người khác không? Không. Chỉ được kiểm thử hệ thống bạn sở hữu hoặc được cho phép bằng văn bản. Đây là yêu cầu bắt buộc trong điều khoản sử dụng của dự án và cũng là quy định của pháp luật.
• Có an toàn cho máy của tôi không? Nên chạy trong máy ảo hoặc mạng cách ly, vì công cụ này chứa các thành phần khai thác thật. Đừng chạy trên máy làm việc chính.
• Bản mới nhất là gì? Khi viết bài, bản phát hành gắn nhãn mới nhất là v2.1.0 (29/5/2026), nhưng mã nguồn vẫn được cập nhật liên tục. Xem trang chính thức: https://github.com/vxcontrol/pentagi và https://pentagi.com.