Shadowbroker: bản đồ OSINT gom hàng chục nguồn dữ liệu công khai — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về BigBodyCobain/Shadowbroker — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Shadowbroker: gom 60+ nguồn tin công khai lên một bản đồ — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Shadowbroker là nền tảng OSINT mã nguồn mở, gom hơn 60 nguồn dữ liệu công khai (máy bay ADS-B, tàu AIS, vệ tinh, động đất, camera, tin xung đột…) lên một bản đồ duy nhất. Bạn tự chạy nó trên máy mình bằng Docker, rồi mở trình duyệt xem. Cài khá dễ nếu đã có Docker Desktop: chỉ cần vài lệnh.
Shadowbroker là một nền tảng OSINT (thu thập thông tin từ nguồn công khai) mã nguồn mở, gom dữ liệu thời gian thực từ hơn 60 nguồn lên một bản đồ duy nhất. Máy bay, tàu biển, vệ tinh, động đất, cháy rừng, camera công cộng, tin xung đột… đều hiện trên cùng một màn hình. Bạn tự chạy nó trên máy của mình, không cần tạo tài khoản.
Nhiều dữ liệu kiểu này vốn đã công khai, nhưng nằm rải rác ở hàng chục trang và API khác nhau. Shadowbroker gom chúng lại để bạn khỏi phải mở từng nơi. Nó phù hợp với nhà phân tích, nhà nghiên cứu, người chơi radio, dev tò mò, hoặc ai muốn nhìn thế giới đang diễn ra thế nào trên một bản đồ.
Điểm đáng giá nhất là hai thứ: bản đồ có hơn 40 lớp dữ liệu bật tắt được, và một kênh để nối trợ lý AI vào làm đồng phân tích. Repo hiện có khoảng 11.568 sao và 1.846 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.
BigBodyCobain/Shadowbroker
Shadowbroker gom máy bay, tàu biển, vệ tinh, động đất, camera công cộng và nhiều nguồn tin công khai lên một bản đồ chạy trên máy của bạn.
I.Shadowbroker làm được gì
Dưới đây là những phần đáng chú ý nhất, theo mô tả của tác giả.
A.Nhiều lớp dữ liệu trên một bản đồ
Bạn có hơn 40 lớp để bật tắt. Có máy bay ADS-B (kể cả máy bay quân sự và chuyên cơ), hơn 25.000 tàu AIS, vệ tinh phân màu theo nhiệm vụ, động đất, núi lửa, cháy rừng (NASA FIRMS), cảnh báo thời tiết và chất lượng không khí. Bạn chỉ bật thứ mình quan tâm, bản đồ đỡ rối.
B.Camera, radio và máy quét công cộng
Tác giả nói có hơn 11.000 camera CCTV ở 6 quốc gia phát trực tiếp trên bản đồ. Bạn cũng bấm vào trạm KiwiSDR để nghe sóng ngắn ngay trong trình duyệt, hoặc nghe luồng máy quét cảnh sát công khai.
C.Bộ công cụ recon chạy phía server
Thanh bên trái có bộ tra cứu: định vị IP, DNS, RDAP/WHOIS, chứng chỉ, BGP/ASN, tìm trong danh sách trừng phạt OFAC, tra CVE, kiểm tra Tor/OTX, quét subnet. Các truy vấn này đi qua backend của bạn, không đi thẳng từ trình duyệt. Backend có lớp chặn SSRF và yêu cầu quyền người vận hành cục bộ.
D.Bấm chuột phải để xem hồ sơ
Bấm chuột phải vào bất kỳ điểm nào trên Trái Đất để xem hồ sơ quốc gia (nguyên thủ, dân số, ngôn ngữ), tóm tắt Wikipedia và ảnh vệ tinh Sentinel-2 mới nhất. Chọn một máy bay, tàu, công ty hoặc IP thì có thêm đồ thị liên kết thực thể.
E.Kênh lệnh cho AI agent
Repo có kênh lệnh ký HMAC cho agent. README nói OpenClaw và các agent nói được giao thức này đều dùng được, ví dụ Claude, GPT, LangChain. Agent đọc được các lớp dữ liệu, tìm xuyên lớp (search_telemetry, search_news), dùng bộ recon (osint_lookup), ghim điểm lên bản đồ và điều khiển bản đồ.
F.Các chế độ hiển thị và tính năng phụ
Có 5 kiểu nhìn: DEFAULT, SATELLITE, FLIR, NVG, CRT. Ngoài ra còn lớp phát hiện thay đổi mặt đất bằng radar SAR, tin Telegram công khai được gắn lên bản đồ, lớp rủi ro chuỗi cung ứng, lớp mã độc C2 và cáp quang biển. Phần InfoNet (mạng liên lạc phi tập trung thử nghiệm) cũng có trong repo, mình nói kỹ hơn ở phần cuối.
II.Cần chuẩn bị gì
Theo README, cách nhanh nhất là chạy bằng Docker. Bạn cần:
- Docker Desktop hoặc Docker Engine. README còn nói Podman dùng được, nhưng cần cài thêm Compose provider.
- Trình duyệt để mở
http://localhost:3000. - RAM đủ rộng: file compose mặc định cấp 4GB cho backend. Máy ít RAM hơn thì xem phần lỗi thường gặp bên dưới.
- Git để tải mã nguồn (README dùng
git clone).
Không bắt buộc, nhưng dùng thêm thì có:
- Khóa API cho một số nguồn. File
.env.examplecó các biếnOPENSKY_CLIENT_ID,OPENSKY_CLIENT_SECRET,AIS_API_KEY,ADMIN_KEY. README không giải thích kỹ từng biến, nên bạn mở file này để xem. SHODAN_API_KEYnếu muốn dùng lớp Shodan.- Tài khoản NASA Earthdata (miễn phí theo README) nếu muốn dùng lớp SAR.
README không nói gì về yêu cầu GPU. Repo cũng có pyproject.toml yêu cầu Python 3.10 trở lên, nhưng nếu chạy bằng Docker thì bạn không cần tự cài Python.
Các khóa API (Shodan, OpenSky, AIS…) là của bạn. Chỉ điền vào file .env trên máy mình, đừng dán lên mạng hay commit lên GitHub. Một số dịch vụ bên thứ ba có điều khoản và giới hạn dùng riêng, bạn cần tự đọc.
III.Cài đặt từng bước
- Cài DockerCài Docker Desktop (hoặc Docker Engine) và mở nó lên
- Tải mã nguồnDùng git clone rồi vào thư mục Shadowbroker
- Kéo imageChạy docker compose pull để tải image dựng sẵn
- Khởi độngChạy docker compose up -d
- Mở dashboardVào http://localhost:3000 trên trình duyệt
A.Cài Docker Desktop
Vào trang Docker Desktop tải bản cho hệ điều hành của bạn, cài xong thì mở ứng dụng lên và đợi nó báo đang chạy. Bước này người mới hay quên: nếu Docker chưa chạy, mọi lệnh docker compose bên dưới sẽ báo lỗi kết nối.
B.Tải mã nguồn về
Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux) ở thư mục bạn muốn lưu dự án, rồi chạy:
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd ShadowbrokerLệnh đầu tải mã nguồn. Lệnh thứ hai đi vào thư mục vừa tải. Những lệnh sau phải chạy trong thư mục này, vì docker-compose.yml nằm ở đó.
C.Kéo image dựng sẵn và khởi động
docker compose pull
docker compose up -dpull tải các image dựng sẵn từ GHCR, bạn không phải tự build. up -d chạy các container ngầm. Lần đầu có thể mất vài phút tùy mạng.
Nếu bạn quen dùng GitLab hơn, README có cách tương đương dùng registry của GitLab:
git clone https://gitlab.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml pull
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml up -dTheo README, hai đường cho ra container giống nhau, bạn chọn đường nào cũng được.
D.Mở dashboard
Mở trình duyệt, vào http://localhost:3000. Trình duyệt chỉ cần cổng 3000. Backend cũng mở cổng 8000 trên máy để chẩn đoán cục bộ.
E.Dùng Podman hoặc Kubernetes (không bắt buộc)
Với Podman, README ghi: trên Windows/WSL nếu gặp lỗi looking up compose provider failed thì cài podman-compose, rồi chạy trong thư mục Shadowbroker:
podman-compose pull
podman-compose up -dTrên Linux, macOS hoặc WSL bạn cũng dùng được script đi kèm:
./compose.sh --engine podman pull
./compose.sh --engine podman up -dVới cụm Kubernetes, repo có Helm chart. README ghi lệnh cài như sau:
helm repo add bjw-s-labs https://bjw-s-labs.github.io/helm-charts/
helm repo update
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbrokerPhần này dành cho người đã quen Kubernetes. Người mới nên dùng Docker như trên.
F.Cập nhật khi có bản mới
docker compose pull
docker compose up -dNếu bạn tải repo từ lâu rồi, README khuyên kéo mã mới trước:
git pull origin main
docker compose down
docker compose pull
docker compose up -dIV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất là mở http://localhost:3000. Nếu thấy giao diện bản đồ tối màu với các lớp dữ liệu và nút STYLE thì bạn đã cài xong.
Nếu trang không lên, xem container có đang chạy không và đọc log của backend (lệnh này có trong README):
docker compose logs -f backendBackend vừa khởi động có thể cần một lúc để tải dữ liệu, nên vài lớp có thể trống lúc đầu. README mô tả tình trạng một số lớp hiện trống sau vài phút là dấu hiệu backend bị khởi động lại do thiếu RAM (xem phần lỗi bên dưới).
V.Dùng vào việc thật
Shadowbroker là công cụ xem và tra cứu, nên các tình huống dưới đây đều xoay quanh việc nhìn dữ liệu công khai và đối chiếu chúng.
A.Theo dõi chuyến bay và hàng hải để làm tin hoặc nghiên cứu
Bạn là người viết bản tin hoặc làm nghiên cứu thị trường, muốn xem đường bay của máy bay chính phủ, tàu chở dầu hay siêu du thuyền. Bạn mở dashboard, bật lớp máy bay hoặc lớp tàu AIS, rồi bấm vào đối tượng cần xem. README nói máy bay của lãnh đạo và máy bay quân sự phát ADS-B được làm nổi bật. Kết quả là bạn có vị trí gần thời gian thực để đối chiếu với tin tức, thay vì mở nhiều trang riêng lẻ.
B.Kiểm tra một địa chỉ IP hoặc tên miền đáng ngờ
Bạn là nhân viên IT hoặc chủ shop nhận email lạ, muốn biết tên miền đó từ đâu ra. Bạn mở bộ Recon Toolkit ở thanh bên trái, nhập tên miền hoặc IP rồi chọn loại tra cứu: DNS, RDAP/WHOIS, chứng chỉ, BGP/ASN hoặc kiểm tra Tor/OTX. Kết quả hiện trong giao diện. README nhấn mạnh các truy vấn này chạy qua backend của bạn chứ không gọi thẳng từ trình duyệt.
Nhiều dữ liệu vốn đã công khai, chỉ là nằm rải rác. Gom lại một bản đồ thì thấy ngay những điều trước đây phải mở mười tab mới ra.
Ông T
C.Nhờ AI agent làm đồng phân tích
Bạn là dev hoặc nhà phân tích, đã có sẵn một agent (OpenClaw hoặc agent khác nói được giao thức HMAC của Shadowbroker). Bạn nối agent vào kênh lệnh rồi ra yêu cầu bằng ngôn ngữ tự nhiên, ví dụ:
Tìm các máy bay quân sự đang bay gần vùng có cảnh báo GPS bị nhiễu, rồi tra thêm tin tức liên quan.Theo README, agent có công cụ tìm xuyên các lớp (search_telemetry, search_news), tra cứu recon (osint_lookup), ghim điểm và điều khiển bản đồ. Kết quả là một bản tóm tắt kèm các điểm ghim trên bản đồ. Phần nối agent cụ thể (khóa, cách ký) README đoạn đầu chưa nói rõ, bạn xem thêm trong thư mục docs/ và openclaw-skills/ của repo.
D.Giám sát thiên tai và rủi ro chuỗi cung ứng
Bạn làm vận hành hoặc mua hàng, quan tâm nhà máy bán dẫn hay pin có bị ảnh hưởng bởi động đất, cháy rừng hay xung đột không. README nói có bảng SCM chấm điểm rủi ro cho các nhà máy cấp 1 và cấp 2 dựa trên động đất, cháy rừng và sự kiện xung đột ở gần. Bạn bật lớp này, xem điểm số và bấm vào từng điểm để biết lý do. Đây là công cụ tham khảo sớm, không thay thế cho báo cáo chuyên ngành.
VI.Lỗi hay gặp và cách xử lý
A.Cổng 8000 đã bị chiếm
Backend mở cổng 8000 trên máy. Nếu máy bạn đã có ứng dụng khác dùng cổng này, README hướng dẫn tạo hoặc sửa file .env cạnh docker-compose.yml, đặt:
BACKEND_PORT=8001Sau đó chạy lại docker compose up -d.
B.Một số lớp bị trống sau vài phút (hết RAM)
Nếu tin tức, căn cứ hay các lớp nặng bị trống, có thể backend bị hệ điều hành tắt do thiếu bộ nhớ. README gợi ý kiểm tra bằng lệnh:
docker events --since 30m --filter container=shadowbroker-backend --filter event=oomMặc định backend được cấp 4GB. Máy ít RAM hơn thì giảm bớt lớp bật hoặc đặt BACKEND_MEMORY_LIMIT=3G trong .env. Khi đó các lớp nặng sẽ tải chậm hơn.
C.docker compose up cứ build từ mã nguồn thay vì kéo image
Nếu log hiện RUN apt-get, RUN npm ci hay RUN pip install, README nói bản clone của bạn cũ, trước một đợt di chuyển repo có sửa lịch sử commit. git pull không sửa được. Cách xử lý theo README là sao lưu .env rồi clone lại:
cd ..
rm -rf Shadowbroker
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose pull
docker compose up -dLệnh rm -rf xóa thư mục cũ, nên hãy sao lưu mọi thứ bạn muốn giữ trước. Trên Windows PowerShell, bạn có thể xóa thư mục bằng File Explorer thay vì dùng lệnh này.
D.Podman báo looking up compose provider failed
Đây là lỗi thường gặp khi dùng Podman trên Windows/WSL: podman compose chỉ là lớp bọc, cần có Compose provider. Bạn cài podman-compose rồi chạy podman-compose pull và podman-compose up -d trong thư mục Shadowbroker.
E.Docker chưa chạy
Nếu lệnh báo không kết nối được tới Docker, hãy mở Docker Desktop và chờ nó khởi động xong rồi chạy lại. README không nói riêng về lỗi này, nhưng đây là lỗi rất hay gặp với người mới.
VII.Có nên dùng không
Điểm mạnh. Bạn có một bản đồ gom cực nhiều nguồn công khai, cài bằng Docker khá đơn giản, tự chạy trên máy mình. README nói không có tài khoản, không có telemetry hay phân tích của sản phẩm. Các truy vấn recon và Shodan đi qua backend của bạn với lớp chặn SSRF. Mã nguồn mở nên ai cũng kiểm tra được.
Giới hạn. Repo khá nặng, backend mặc định cần 4GB RAM. Một số nguồn cần khóa API hoặc tài khoản riêng. Dù bạn tự chạy, các tính năng OSINT vẫn phải gửi yêu cầu ra ngoài tới nhà cung cấp dữ liệu mà bạn bật. Dữ liệu là công khai nên độ chính xác và độ trễ phụ thuộc vào từng nguồn.
InfoNet chỉ là bản thử nghiệm. README ghi rõ đây là testnet thử nghiệm, không đảm bảo quyền riêng tư, và dặn đừng truyền thông tin nhạy cảm qua bất kỳ kênh nào của nó. Mình khuyên bạn dùng Shadowbroker như một công cụ xem bản đồ và tra cứu, đừng dùng InfoNet để trao đổi chuyện quan trọng.
Giấy phép AGPL-3.0. Nếu bạn định sửa rồi cung cấp cho người khác dùng qua mạng, hãy đọc kỹ giấy phép này trước.
Khi nào chọn cách khác. Nếu bạn chỉ cần theo dõi một thứ duy nhất, ví dụ chuyến bay hay tàu, thì các trang chuyên dụng nhẹ hơn nhiều. Nếu bạn cần giải pháp thương mại có hỗ trợ chính thức, repo này chưa phải loại đó. Còn nếu bạn tò mò, muốn nhìn tổng quan nhiều lớp dữ liệu công khai, hoặc muốn thử nối AI vào bản đồ, thì Shadowbroker rất đáng thử.
Ngoài ra, hãy dùng công cụ này đúng pháp luật và đạo đức: dữ liệu công khai không có nghĩa là bạn được phép làm gì cũng được với nó.
Câu hỏi thường gặp
Shadowbroker có miễn phí không?
Phần mềm là mã nguồn mở, giấy phép AGPL-3.0, tải về dùng được. Một số tính năng cần khóa API hoặc tài khoản riêng, ví dụ Shodan hay NASA Earthdata (README ghi tài khoản Earthdata miễn phí). Chi phí của các dịch vụ bên thứ ba thì repo chưa nêu đầy đủ.
Có cần GPU không?
README không nhắc yêu cầu GPU. Thứ được nói rõ là backend mặc định được cấp 4GB RAM trong file compose. Máy ít RAM hơn có thể đặt BACKEND_MEMORY_LIMIT=3G và chấp nhận các lớp nặng tải chậm hơn.
Chạy được trên Windows không?
Có thể. README nói cần Docker Desktop hoặc Docker Engine, và có hướng dẫn riêng cho Podman trên Windows/WSL. Repo cũng có các file .bat như start.bat và stop.bat, nhưng README đoạn mình có chưa mô tả cách dùng chúng, nên cách an toàn nhất là dùng Docker theo hướng dẫn trên.
Dữ liệu của tôi có an toàn không?
README nói Shadowbroker không có tài khoản, không có telemetry hay phân tích sản phẩm, và khóa của bạn nằm trong bản cài cục bộ. Các truy vấn recon và Shodan được proxy qua backend của bạn với lớp chặn SSRF. Tuy vậy các tính năng OSINT vẫn gửi yêu cầu ra các nhà cung cấp dữ liệu công khai mà bạn bật. Riêng InfoNet là thử nghiệm và không đảm bảo riêng tư.
Shadowbroker khác gì các trang theo dõi máy bay hay tàu biển?
Các trang đó thường chuyên về một loại dữ liệu. Shadowbroker gom hơn 60 nguồn và hơn 40 lớp lên một bản đồ, kèm bộ recon và kênh nối AI agent. Repo chưa có so sánh chi tiết về độ chính xác hay độ phủ với từng trang cụ thể.
Có nối được với AI như Claude hay GPT không?
README nói có kênh lệnh ký HMAC, hỗ trợ OpenClaw và bất kỳ agent nào nói được giao thức này, ví dụ Claude, GPT, LangChain hoặc agent tự viết. Cách nối chi tiết nằm ở thư mục docs/ và openclaw-skills/ trong repo, README đoạn mình có chưa hướng dẫn từng bước.
Làm sao cập nhật lên bản mới?
Chạy docker compose pull rồi docker compose up -d trong thư mục dự án. Nếu bản clone của bạn cũ, README khuyên chạy git pull origin main và docker compose down trước. Nếu vẫn bị build từ mã nguồn, cần clone lại repo.


