ĐÃ 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/2026QUÀ ĐĂNG KÝ
Đăng ký nhận 5 xu dùng thử tool AI
Tài khoản GitHot mới được tặng 5 xu — đủ để chạy AI Repo Explainer, MCP Config Generator hoặc Repo Health Check. Miễn phí, chỉ cần email hoặc Google.
- 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.
- Windows: nhấn phím Windows, gõ "PowerShell", rồi nhấn Enter.
- macOS: nhấn Command + Space, gõ "Terminal", rồi nhấn Enter.
- Linux: nhấn Ctrl + Alt + T.
- 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.
- 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
npxhoặ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
enginescủ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ệnhnpmvà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ặcrelease/). - 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:
- 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
- Bọc file đó với mức bảo vệ mạnh nhất (
bankrupt):
npx bla-agents protect ./dist/app.js --mode bankrupt
- 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.
verifychỉ 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ệu | Nguyên nhân | Cách sửa |
|---|---|---|
npx: command not found hoặc node không chạy | Chưa cài Node.js, hoặc mở cửa sổ dòng lệnh trước khi cài | Cà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.4 | Nâ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ào | Chưa build dự án, hoặc đang đứng sai thư mục | Chạ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 sai | Trường hợp đặc thù của dự án bạn | Quay 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ý AI | Trợ lý chưa được cài, hoặc file cấu hình ở chỗ khác | Cà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.
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.