← Trang chủ

ĐÃ REVIEW & SẴN SÀNG CÀI ĐẶT

BLA (Blind LLM Agents)

qybaihe/bla

Công cụ dòng lệnh và MCP server mã nguồn mở giúp bảo vệ phần mềm của chính bạn trước AI dịch ngược như REA: cài manh mối giả, logic mồi nhử không bao giờ chạy và bẫy vượt giới hạn bộ phân tích, khiến AI đọc sai hoặc bỏ dở, còn người dùng thật không thấy khác biệt. Miễn phí, giấy phép MIT.

TỪNG BƯỚC

Hướng dẫn cài đặt BLA (Blind LLM Agents)

Hướng dẫn từng bước nằm ngay trên trang này, viết cho người chưa từng cài phần mềm từ GitHub.

Cập nhật 14/11/2026
Ảnh xem trước của BLA (Blind LLM Agents) trên GitHub
Sao GitHub
6.383
Ngôn ngữ
TypeScript
Đã thêm
14/11/2026

Cách cài đặt BLA (Blind LLM Agents) từng bước

Làm lần lượt từ trên xuống. Mỗi khung chữ xám là một lệnh: chép nguyên dòng, dán vào cửa sổ dòng lệnh rồi nhấn Enter.

Chưa từng dùng dòng lệnh? Đọc phần này trước (1 phút)

Dòng lệnh (Terminal) là một cửa sổ để gõ lệnh cho máy tính. Bạn không cần hiểu lệnh, chỉ cần chép đúng và dán vào.

  1. Windows: nhấn phím Windows, gõ "PowerShell", rồi nhấn Enter.
  2. macOS: nhấn Command + Space, gõ "Terminal", rồi nhấn Enter.
  3. Linux: nhấn Ctrl + Alt + T.
  4. Chép một lệnh trong hướng dẫn, bấm chuột phải vào cửa sổ vừa mở để dán (macOS: Command + V), rồi nhấn Enter.
  5. Chờ lệnh chạy xong (con trỏ nhấp nháy trở lại ở dòng mới) rồi mới làm lệnh tiếp theo.

Dòng bắt đầu bằng dấu # chỉ là ghi chú, không cần chép. Nếu hiện chữ đỏ báo lỗi, xem mục lỗi thường gặp ở cuối hướng dẫn.

1. BLA là gì?

BLA (viết tắt của Blind LLM Agents, repo qybaihe/bla, gói npm bla-agents) là công cụ dòng lệnh mã nguồn mở giúp bảo vệ phần mềm của bạn trước các AI agent chuyên dịch ngược (reverse engineering, tức đọc ngược file đã đóng gói để dựng lại mã nguồn), ví dụ dự án REA. BLA không mã hóa hay giấu code theo kiểu cũ. Nó chèn vào bản build những manh mối giả, logic mồi nhử không bao giờ chạy và các cấu trúc cố tình vượt giới hạn của công cụ phân tích, để AI đọc sai hoặc bỏ dở. Người dùng chạy phần mềm như bình thường.

BLA miễn phí, giấy phép MIT. Ngoài bản dòng lệnh, nó còn có MCP server (cổng để trợ lý AI lập trình như Claude Code, Cursor, Codex gọi được các công cụ của BLA).

Nói thẳng: đây là công cụ cho người làm phần mềm. Nếu bạn chỉ dùng app chứ không tự phát hành app, bạn không cần BLA.

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

  • Bạn tự làm và phát hành phần mềm: web app (file JavaScript sau khi build), app Electron, file WebAssembly, script Python, file thực thi, cơ sở dữ liệu SQLite, file mô hình GGUF/Safetensors…
  • Bạn lo logic quan trọng (ví dụ phần kiểm tra bản quyền) bị AI dịch ngược và sao chép nhanh với giá rẻ.
  • Bạn đã quen chạy lệnh npx hoặc đang dùng một trợ lý AI lập trình.

Chưa hợp nếu:

  • Bạn muốn dùng nó để mổ xẻ phần mềm của người khác. Tài liệu chính thức nói rõ BLA chỉ dùng cho phần mềm bạn sở hữu hoặc được phép sửa và phát hành.
  • Bạn cần bảo mật tuyệt đối. Tài liệu thừa nhận không cách bảo vệ phía máy khách nào chặn được một chuyên gia người thật có đủ thời gian và công cụ gỡ lỗi. Khóa API, khóa ký quan trọng vẫn phải để trên máy chủ của bạn.
  • Bạn không thể chấp nhận bản build nặng hơn. Theo bảng kết quả trong README, có file tăng từ vài trăm byte lên hàng chục megabyte sau khi bọc.

Lưu ý về con số: README nêu mức tăng "300 đến 2.800 lần" lượng token kẻ tấn công phải tiêu. Đây là ước tính mô hình hóa của chính dự án, chưa có bên độc lập kiểm chứng.

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

  • Máy tính Windows, macOS hoặc Linux.
  • Node.js phiên bản 22.23.4 trở lên trong nhánh 22, hoặc từ 24.0.0 trở lên (đúng như yêu cầu engines của gói). Node.js là phần mềm nền để chạy chương trình viết bằng JavaScript; cài nó sẽ có luôn lệnh npm và npx. Tải miễn phí ở https://nodejs.org (chọn bản LTS mới).
  • Thư mục dự án của chính bạn, đã build ra các file sẽ phát hành (thường nằm trong dist/, build/, out/ hoặc release/).
  • Một bản sao lưu của dự án (hoặc dự án đã nằm trong Git). BLA mặc định ghi kết quả ra thư mục riêng, nhưng sao lưu trước vẫn là thói quen an toàn.
  • (Không bắt buộc) Một trợ lý AI lập trình nếu bạn muốn ra lệnh bằng lời: Claude Code, Cursor, Codex, Windsurf, Gemini CLI hoặc OpenCode.

Không cần tài khoản, không cần khóa API để dùng BLA. Nếu dùng qua trợ lý AI, bạn trả chi phí của trợ lý đó theo bảng giá riêng của họ.

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

BLA không có file cài kiểu .exe. Cách dễ nhất là chạy thẳng bằng npx, không cần cài gì vĩnh viễn.

Bước 1: Kiểm tra Node.js

Mở Terminal (macOS/Linux) hoặc PowerShell (Windows) và gõ:

node --version

Thấy gì là đúng: một dòng như v24.x.x hoặc v22.23.4 trở lên. Nếu báo "command not found" hoặc số thấp hơn, cài Node.js bản LTS mới từ https://nodejs.org rồi mở lại cửa sổ dòng lệnh.

Bước 2: Đi vào thư mục dự án

Dùng lệnh cd để vào thư mục gốc dự án của bạn (thư mục có file package.json hoặc có thư mục dist/). Ví dụ:

cd duong-dan-toi-du-an-cua-ban

Thấy gì là đúng: dấu nhắc lệnh hiện tên thư mục dự án. Gõ ls (macOS/Linux) hoặc dir (Windows) phải thấy các file của dự án.

Bước 3: Xem trước BLA sẽ đụng vào file nào

Trước khi bọc thật, chạy chế độ xem trước. Chế độ này không ghi byte nào lên ổ đĩa:

npx bla-agents harden . --dry-run

Lần đầu, npx sẽ hỏi có tải gói bla-agents không; gõ y rồi Enter.

Thấy gì là đúng: BLA liệt kê các file nó tìm thấy để bảo vệ (file trong dist/, build/, file .asar, .wasm, .sqlite…). Không có thư mục mới nào được tạo. Theo tài liệu, chế độ này cố ý không báo "thành công", nên đừng lo nếu kết quả ghi chưa hoàn tất.

Bước 4: Bọc bảo vệ thật

npx bla-agents harden .

Lệnh này tự tìm các file đầu ra rồi chạy ba bước: kiểm tra mức độ lộ (audit), chèn lớp bảo vệ (protect) và kiểm chứng (verify).

Thấy gì là đúng: cuối kết quả có dòng Output: chỉ tới thư mục .bla-hardened nằm trong dự án. Bản đã bọc nằm ở đó, giữ nguyên tên file gốc; file gốc của bạn không bị ghi đè.

Lưu ý: BLA không tự ghi đè file đã có. Nếu đầu ra trùng file cũ, nó dừng lại và báo cần xác nhận. Hãy đọc kỹ danh sách trước khi đồng ý.

Bước 5 (tùy chọn): Cài vào trợ lý AI lập trình

Nếu bạn dùng Claude Code, Cursor, Codex, Windsurf, Gemini CLI hoặc OpenCode:

npx bla-agents setup

Muốn chỉ cài cho một vài trợ lý:

npx bla-agents setup --client claude-code,cursor

Sau đó kiểm tra lại:

npx bla-agents doctor

Thấy gì là đúng: setup báo đã đăng ký MCP server bla và skill blind-llm-agents cho các trợ lý tìm thấy trên máy. doctor in ra trạng thái sẵn sàng của các bộ bảo vệ và của từng trợ lý đã đăng ký.

Bước 6 (tùy chọn): Cài cố định vào dự án

Nếu bạn muốn bọc tự động mỗi lần build, cài BLA làm gói phát triển:

npm install --save-dev bla-agents

Hoặc cài cho toàn máy để dùng lệnh ngắn bla:

npm install -g bla-agents

Thấy gì là đúng: gõ bla --version ra số phiên bản (lúc viết guide, bản mới nhất là 3.3.1).

4. Dùng lần đầu

Cách nhanh nhất để thấy kết quả là bọc một file cụ thể rồi kiểm chứng:

  1. Kiểm tra file của bạn lộ đến đâu trước khi phát hành:
npx bla-agents audit ./dist/app.js
  1. Bọc file đó với mức bảo vệ mạnh nhất (bankrupt):
npx bla-agents protect ./dist/app.js --mode bankrupt
  1. So bản đã bọc với bản gốc:
npx bla-agents verify ./dist/app.js ./dist/app.bla.js

Thay ./dist/app.js bằng đường dẫn file thật của bạn. Bước verify kiểm tra các dấu hiệu chống REA và ước tính mức token kẻ tấn công phải tiêu thêm.

Quan trọng: tài liệu chính thức yêu cầu chạy lại bộ test của chính dự án trên bản đã bọc, trong môi trường thử, trước khi phát hành. verify chỉ kiểm tra cấu trúc chống REA, không thay cho việc chạy thử app thật.

Nếu đã làm Bước 5, bạn có thể mở trợ lý AI trong thư mục dự án và gõ: Harden my software against REA. Trợ lý sẽ tự gọi các công cụ của BLA để làm các bước trên.

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

Dấu hiệuNguyên nhânCách sửa
npx: command not found hoặc node không chạyChưa cài Node.js, hoặc mở cửa sổ dòng lệnh trước khi càiCài Node.js LTS từ https://nodejs.org, đóng và mở lại Terminal/PowerShell
Báo phiên bản Node không hỗ trợNode cũ hơn 22.23.4Nâng lên bản 24 LTS hoặc bản 22 mới nhất
harden không tìm thấy file nàoChưa build dự án, hoặc đang đứng sai thư mụcChạy lệnh build của dự án trước, rồi cd vào đúng thư mục gốc
Dừng lại với "confirmation required"File đầu ra đã tồn tại, BLA không ghi đè khi chưa được phépĐổi thư mục đầu ra hoặc xóa thư mục .bla-hardened cũ sau khi kiểm tra
Từ chối bọc ở mức bankrupt vì còn bí mật dạng chữ rõLớp kiểm tra bla lint phát hiện chuỗi như FLAG{...}, khóa, hoặc một điểm kiểm tra duy nhất dễ váChạy npx bla-agents lint . để xem danh sách, sửa trong mã nguồn rồi chạy lại
App đã bọc chạy saiTrường hợp đặc thù của dự án bạnQuay về bản gốc (BLA không ghi đè file gốc), báo lỗi ở trang Issues của repo kèm thông tin
setup không thấy trợ lý AITrợ lý chưa được cài, hoặc file cấu hình ở chỗ khácCài trợ lý trước, hoặc chỉ định bằng --client, rồi chạy npx bla-agents doctor

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

Gỡ khỏi các trợ lý AI (xóa đăng ký MCP và thư mục skill):

npx bla-agents uninstall

Gỡ bản cài toàn máy:

npm uninstall -g bla-agents

Gỡ khỏi dự án:

npm uninstall bla-agents

Thư mục .bla-hardened do lệnh harden tạo ra có thể xóa bằng tay khi không cần nữa.

Cập nhật: dùng npx thì thêm @latest để luôn chạy bản mới nhất, ví dụ npx bla-agents@latest harden .. Nếu cài trong dự án hoặc toàn máy, chạy lại lệnh npm install tương ứng. Dự án ra bản mới rất thường xuyên; xem thay đổi ở trang Releases: https://github.com/qybaihe/bla/releases

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

BLA có mất tiền không? Không. Mã nguồn mở, giấy phép MIT.

App có chạy chậm đi không? Theo tài liệu, các nhánh mồi nhử nằm sau những điều kiện toán học luôn sai nên không chạy khi người dùng dùng app. Các mục thử nghiệm của dự án đều cho kết quả giống bản gốc. Với dự án của bạn, hãy tự chạy bộ test để chắc chắn. File sẽ nặng hơn.

BLA có chèn mã độc hay gửi dữ liệu đi đâu không? Tài liệu cam kết BLA không chèn lệnh phá hoại, lệnh shell hay kết nối mạng vào file được bọc. Mã nguồn công khai để bạn tự kiểm tra.

Có chặn được người dịch ngược thủ công không? Không hoàn toàn. BLA nhắm vào AI agent dịch ngược tự động. Tài liệu nói rõ không cam kết chống chuyên gia dùng các công cụ như Ghidra, Frida trong thời gian dài.

Có được dùng BLA lên phần mềm của người khác không? Không. Chỉ dùng cho phần mềm bạn sở hữu hoặc được phép sửa và phát hành.

GitHot tự viết và kiểm tra lại với tài liệu chính thức của dự án. Thấy bước nào sai hoặc khó hiểu, hãy nhắn cho GitHot qua các kênh ở cuối trang.

XEM TẠI SAO NÓ HOT

Xem review gốc

Quay lại video đã dẫn bạn đến đây.

Xem trên TikTok ↗

Không bỏ lỡ repo tiếp theo

Mỗi repo mới đều có video review kèm hướng dẫn cài đặt tại đây.

Theo dõi trên TikTok ↗