Shadowbroker: bản đồ OSINT thời gian thực — 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 dữ liệu từ hơn 60 nguồn vào một bản đồ địa lý thời gian thực. Bạn có thể theo dõi máy bay, tàu, vệ tinh, camera, động đất, cháy rừng, dữ liệu mạng và dùng AI để tìm mối liên hệ. Cài bằng Docker khá thẳng; các tính năng nâng cao có thể cần API key riêng.
Shadowbroker là một nền tảng OSINT mã nguồn mở, dùng bản đồ để gom nhiều loại dữ liệu công khai theo thời gian thực vào một giao diện. Thay vì mở hàng chục công cụ riêng cho máy bay, tàu biển, vệ tinh, động đất, camera hay dữ liệu mạng, bạn có thể xem chúng trên cùng một màn hình.
Repo phù hợp với nhà nghiên cứu, nhân viên phân tích, người vận hành radio, lập trình viên, nhóm an ninh và bất kỳ ai cần quan sát nhiều tín hiệu công khai cùng lúc. Hiện repo có khoảng 11.568 sao và 1.846 fork, dùng Python ở phần backend và được cấp phép AGPL-3.0.
Điểm đáng giá nhất là khả năng kết nối các lớp dữ liệu với nhau. Bạn có thể chọn một máy bay, tàu, công ty hoặc địa chỉ IP rồi mở rộng entity graph để xem các liên kết liên quan. Repo cũng có kênh lệnh cho AI agent, bộ công cụ recon chạy phía server và nhiều lớp bản đồ có thể bật tắt.
BigBodyCobain/Shadowbroker
Shadowbroker gom hơn 60 nguồn OSINT thời gian thực vào một bản đồ, hỗ trợ theo dõi máy bay, tàu, vệ tinh, thiên tai và dữ liệu mạng.
I.Shadowbroker làm được gì
Gom dữ liệu OSINT vào một bản đồ duy nhất: Shadowbroker hỗ trợ hơn 60 nguồn dữ liệu trực tiếp. Các lớp có thể bao gồm máy bay ADS-B, tàu AIS, vệ tinh, động đất, núi lửa, cháy rừng, thời tiết, chất lượng không khí, căn cứ quân sự, nhà máy điện và trung tâm dữ liệu.
Theo dõi hàng không và hàng hải: Bạn có thể xem máy bay đang phát ADS-B, tàu biển, tàu cá và siêu du thuyền. Dữ liệu này hữu ích khi cần quan sát hoạt động giao thông, nghiên cứu tuyến di chuyển hoặc theo dõi một khu vực cụ thể.
Xem dữ liệu vệ tinh và trạm mặt đất: Bản đồ hiển thị vệ tinh theo loại nhiệm vụ như trinh sát, SIGINT, SAR, cảnh báo sớm hoặc trạm vũ trụ. SatNOGS và TinyGS cũng được tích hợp dưới dạng các lớp dữ liệu.
Theo dõi CCTV và radio công khai: Repo mô tả hơn 11.000 camera tại nhiều khu vực, cùng các node KiwiSDR và luồng police scanner. Bạn có thể chọn node trên bản đồ để mở luồng radio hoặc camera tương ứng, tùy nguồn có sẵn.
Quan sát thiên tai và thay đổi mặt đất: Các lớp động đất, phun trào 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í giúp bạn theo dõi rủi ro theo khu vực. Tính năng SAR có thể dùng dữ liệu từ NASA OPERA và Copernicus EGMS để phát hiện biến dạng mặt đất, lũ, thay đổi thảm thực vật và thiệt hại.
Tìm hiểu tín hiệu gây nhiễu GPS: Shadowbroker phân tích suy giảm NAC-P từ dữ liệu máy bay để suy ra các khu vực có khả năng bị gây nhiễu GPS. Đây là lớp dữ liệu tham khảo, không nên xem như kết luận độc lập nếu chưa kiểm chứng thêm.
Có bộ Recon Toolkit: Phần công cụ phía server hỗ trợ tra cứu IP, DNS, RDAP/WHOIS, chứng thư, BGP/ASN, lệnh trừng phạt OFAC, CVE, Tor, OTX và quét subnet. Trình duyệt gọi backend tự triển khai, còn backend mới thực hiện các truy vấn ra ngoài.
Tùy chọn kết nối Shodan: Nếu bạn cung cấp API key Shodan, kết quả thiết bị kết nối Internet có thể được hiển thị thành lớp bản đồ riêng. Tính năng này vẫn phụ thuộc điều khoản của Shodan và chạy phía server.
Mở rộng entity graph: Khi chọn máy bay, tàu, công ty hoặc IP, bạn có thể mở rộng đồ thị thực thể. Dữ liệu liên kết được mô tả là kết hợp từ Wikidata, OFAC và kho dữ liệu trực tiếp của ứng dụng.
Kết nối AI agent: Kênh lệnh agent dùng chữ ký HMAC và hỗ trợ OpenClaw cùng các agent nói được giao thức tương ứng, trong đó có Claude, GPT, LangChain hoặc agent tự viết. Agent có thể tìm kiếm telemetry, tìm tin tức, gọi recon, đặt ghim, điều khiển bản đồ, xem entity graph và gửi cảnh báo.
Theo dõi rủi ro chuỗi cung ứng: Lớp SCM chấm điểm các nhà máy bán dẫn và pin Tier 1/2 theo khoảng cách tới động đất, cháy rừng và sự kiện xung đột. Đây là thông tin hữu ích cho nhóm đánh giá nguồn cung hoặc lập bản đồ rủi ro.
Có InfoNet và Mesh Chat thử nghiệm: Repo tích hợp mạng mesh phi tập trung, gate chat, Dead Drop và giao tiếp với node Meshtastic hoặc APRS. Đây là testnet thử nghiệm, không nên dùng để gửi thông tin nhạy cảm.
Nhiều kiểu hiển thị bản đồ: Nút STYLE có các chế độ DEFAULT, SATELLITE, FLIR, NVG và CRT. Bạn có thể chọn kiểu phù hợp khi đọc bản đồ ban ngày, theo dõi ảnh nhiệt giả lập hoặc muốn giao diện giống terminal.
II.Cần chuẩn bị gì
Cách cài nhanh trong README dùng Docker. Bạn cần Docker Desktop hoặc Docker Engine đang hoạt động. Nếu dùng Podman, README yêu cầu có thêm một Compose provider; trên Windows hoặc WSL có thể cần cài podman-compose.
Nếu chạy hoặc phát triển phần Python trực tiếp, pyproject.toml yêu cầu Python từ 3.10 trở lên. Tuy nhiên, cách chạy bằng image Docker dựng sẵn không yêu cầu bạn cài Python riêng trên máy host.
Ứng dụng không yêu cầu tài khoản cho dashboard cơ bản. Một số tính năng cần thông tin riêng:
OPENSKY_CLIENT_IDvàOPENSKY_CLIENT_SECRETcho phần dữ liệu OpenSky nếu bạn bật tính năng tương ứng.AIS_API_KEYcho nguồn AIS nếu cần.ADMIN_KEYcho các route quản trị hoặc quyền local-operator.SHODAN_API_KEYnếu muốn dùng connector Shodan.- Tài khoản NASA Earthdata nếu muốn dùng tính năng SAR.
Các key do người vận hành cung cấp được giữ trong triển khai cục bộ theo mô tả của README. Dù vậy, các tính năng OSINT trực tiếp vẫn có thể gửi yêu cầu ra những nhà cung cấp dữ liệu công khai mà bạn bật hoặc truy vấn.
InfoNet hiện là testnet thử nghiệm và README yêu cầu không truyền dữ liệu nhạy cảm qua bất kỳ kênh nào. Meshtastic/APRS là tín hiệu công khai; các kênh khác cũng chưa được cam kết riêng tư tuyệt đối.
III.Cài đặt từng bước
- Chuẩn bị DockerCài và mở Docker Desktop hoặc Docker Engine
- Lấy mã nguồnClone repo và đi vào thư mục Shadowbroker
- Tải imageDùng Docker Compose lấy image dựng sẵn
- Khởi động hệ thốngChạy các container ở chế độ nền
- Mở dashboardTruy cập giao diện tại localhost:3000
A.Chuẩn bị Docker
Cài Docker Desktop trên Windows hoặc Docker Engine trên Linux, macOS. Sau khi cài, mở Docker để Docker daemon sẵn sàng trước khi chạy lệnh. README cho biết Shadowbroker dùng image Docker dựng sẵn nên cách nhanh không cần tự build backend và frontend.
Nếu bạn dùng Podman trên Windows hoặc WSL và gặp lỗi thiếu Compose provider, cài podman-compose rồi chạy lệnh tương ứng trong thư mục repo. Với bash trên Linux, macOS hoặc WSL, repo cũng có script compose.sh hỗ trợ chọn engine.
B.Clone repo
Mở PowerShell hoặc Terminal tại thư mục bạn muốn lưu dự án, sau đó chạy:
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbrokergit clone tải mã nguồn về máy. cd Shadowbroker chuyển terminal vào thư mục dự án. Người mới thường chạy lệnh thứ hai ở một thư mục khác hoặc gõ sai chữ hoa, khiến các lệnh Compose không tìm thấy docker-compose.yml.
C.Tải image Docker
Trong thư mục Shadowbroker, chạy:
docker compose pullLệnh này tải các image mới nhất từ GitHub Container Registry theo cấu hình mặc định. README nói cách này không cần build tại máy, nên thời gian cài đặt phụ thuộc tốc độ mạng và dung lượng image.
Nếu bạn muốn dùng GitLab Container Registry, chạy đúng chuỗi lệnh sau:
git clone https://gitlab.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml pullHai lựa chọn tạo ra các container giống nhau theo mô tả của README. Bạn nên chọn một nguồn và dùng nhất quán.
D.Khởi động các container
Với cấu hình GitHub mặc định, chạy:
docker compose up -dup tạo và khởi động các service. Cờ -d để chúng chạy nền, giúp bạn lấy lại quyền điều khiển terminal. Nếu đang dùng cấu hình GitLab thì chạy:
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml up -dNếu cổng backend 8000 đã bị ứng dụng khác chiếm, tạo hoặc chỉnh file .env cạnh docker-compose.yml rồi đặt:
BACKEND_PORT=8001Sau đó chạy lại:
docker compose up -dTrình duyệt chỉ cần cổng 3000, còn backend được công bố ở 8000 để chẩn đoán cục bộ. Vì vậy, đổi backend port không đồng nghĩa đổi địa chỉ dashboard.
E.Mở dashboard
Mở trình duyệt và truy cập:
http://localhost:3000Nếu muốn tham gia InfoNet testnet, README cho biết có thể bấm NODE trong dashboard. Với node chạy không có giao diện, repo có script ./meshnode.sh. Nếu muốn node riêng tư, đặt biến sau trong .env:
MESH_INFONET_FLEET_JOIN=falseREADME cảnh báo InfoNet vẫn là testnet. Không nên xem tùy chọn này như một hệ thống liên lạc riêng tư đã hoàn thiện.
F.Cập nhật khi đã cài
Shadowbroker dùng image Docker dựng sẵn. Khi muốn cập nhật, chạy:
docker compose pull
docker compose up -dNếu repo cũ bị lỗi git pull hoặc Docker cố build từ source, README hướng dẫn lấy lại clone mới. Lệnh đầy đủ được ghi như sau:
cd..
rm -rf Shadowbroker
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose pull
docker compose up -dLệnh trên xóa thư mục clone cũ. Nếu bạn có .env hoặc cấu hình riêng, hãy sao lưu trước. Đây là thao tác chỉ nên dùng khi xác định clone cũ đang gặp vấn đề migration.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra cơ bản là mở http://localhost:3000. Nếu dashboard bản đồ hiện ra, phần frontend đã truy cập được backend theo cấu hình Compose.
Bạn cũng có thể xem log backend bằng:
docker compose logs -f backendNếu dashboard trống một số lớp sau vài phút, README khuyên kiểm tra container backend có bị hết bộ nhớ và khởi động lại hay không:
docker events --since 30m --filter container=shadowbroker-backend --filter event=oomKết quả bình thường là không có sự kiện OOM liên quan. File Compose mặc định cấp 4 GB cho backend. Nếu máy ít RAM hơn, README cho phép đặt BACKEND_MEMORY_LIMIT=3G, nhưng các lớp dữ liệu sẽ khởi động chậm hơn.
Bạn cũng có thể kiểm tra container đang chạy bằng lệnh phổ thông:
docker compose psCác service chính nên ở trạng thái đang chạy. Nếu chưa chạy, xem log backend và kiểm tra cổng 3000, 8000 có bị ứng dụng khác chiếm hay không.
V.Dùng vào việc thật
A.Chủ shop kiểm tra rủi ro vận chuyển
Một chủ shop nhập hàng có thể mở lớp tàu AIS, cảng, động đất, cháy rừng và thời tiết để xem tuyến vận chuyển có đi qua khu vực đang có sự kiện bất thường hay không. Khi chọn tàu hoặc khu vực, bạn có thể đối chiếu thêm tin tức và các lớp địa lý khác.
Cách làm là khởi động dashboard, bật các layer cần dùng rồi phóng to vùng có tuyến hàng. Nếu cần phân tích nhiều lớp, hãy dùng chức năng tìm kiếm telemetry được README mô tả cho agent hoặc các panel có sẵn trong giao diện.
Kết quả phù hợp để lập danh sách tuyến cần theo dõi, liên hệ đơn vị logistics và chuẩn bị phương án thay thế. Dữ liệu bản đồ không tự thay thế xác nhận từ hãng vận chuyển.
B.Nhân viên văn phòng theo dõi một khu vực
Một nhân viên phụ trách an toàn hoặc vận hành có thể đặt bản đồ tại khu vực nhà máy, văn phòng hoặc kho hàng. Các lớp động đất, cháy rừng, thời tiết, chất lượng không khí và cảnh một trang tin tức giúp họ có một màn hình tổng hợp để kiểm tra nhanh.
Bạn có thể đổi kiểu hiển thị bằng nút STYLE, chọn SATELLITE để xem địa hình hoặc DEFAULT để đọc nhiều lớp rõ hơn. Với khu vực rộng, nên bật từng nhóm layer thay vì bật cùng lúc tất cả để tránh khó đọc.
Kết quả là một bảng điều khiển trực quan cho việc quan sát tình hình. Nếu cần đưa ra quyết định vận hành, hãy kiểm tra thêm nguồn gốc và thời điểm cập nhật của từng feed.
C.Nhà nghiên cứu hoặc phóng viên dữ liệu kiểm tra sự kiện
Một nhà nghiên cứu có thể chọn một điểm trên bản đồ để mở country dossier, thông tin người đứng đầu, dân số, ngôn ngữ, tóm tắt Wikipedia và ảnh Sentinel-2 mới nhất. Với máy bay, tàu, công ty hoặc IP, họ có thể mở entity graph để tìm liên kết từ Wikidata, OFAC và kho dữ liệu trực tiếp.
Nếu cần tra cứu hạ tầng Internet, Recon Toolkit hỗ trợ IP geolocation, DNS, WHOIS/RDAP, BGP/ASN, chứng thư, CVE và kiểm tra mối đe dọa. Các truy vấn nhạy cảm được mô tả là đi qua backend tự triển khai thay vì gọi trực tiếp từ trình duyệt.
Kết quả là một bộ dữ liệu nền để tiếp tục kiểm chứng. Không nên coi kết quả OSINT đơn lẻ là bằng chứng cuối cùng.
D.Lập trình viên xây trợ lý AI phân tích bản đồ
Một lập trình viên có thể kết nối agent tương thích với kênh lệnh HMAC của Shadowbroker. Agent có thể dùng search_telemetry, search_news, osint_lookup, mở rộng entity graph, đặt ghim, điều khiển bản đồ, theo dõi SAR và gửi cảnh báo theo khả năng của repo.
Prompt mẫu cho agent có thể là: Tìm các tín hiệu hàng hải và sự kiện thời tiết bất thường quanh khu vực đang chọn, sau đó đặt ghim cho các điểm cần kiểm tra. Agent chỉ nên được cấp quyền và key phù hợp với môi trường thử nghiệm. Hãy kiểm tra lại từng kết quả trước khi để agent thực hiện hành động ghi hoặc thay đổi trạng thái trên bản đồ.
Kết quả là một co-analyst có thể hỗ trợ lọc dữ liệu nhiều lớp. Hiệu quả phụ thuộc vào feed đang bật, quyền backend và giao thức agent được cấu hình đúng.
Một bản đồ tốt không chỉ cho bạn thấy dữ liệu; nó giúp nối những tín hiệu vốn đang nằm rời rạc.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Mở localhost:3000 nhưng không thấy giao diện
Kiểm tra bạn đã chạy lệnh trong đúng thư mục Shadowbroker chưa. Sau đó chạy docker compose ps và xem docker compose logs -f backend. Nếu cổng 3000 bị chiếm, hãy kiểm tra ứng dụng khác đang dùng cổng này trước khi khởi động lại.
B.Backend liên tục khởi động lại
Backend có thể bị giới hạn bộ nhớ, nhất là khi bật nhiều feed. Kiểm tra bằng:
docker events --since 30m --filter container=shadowbroker-backend --filter event=oomBạn có thể giảm feed đang bật hoặc đặt BACKEND_MEMORY_LIMIT=3G theo hướng dẫn README. Việc giảm giới hạn có thể làm các lớp dữ liệu khởi động chậm hơn.
C.Cổng 8000 đã được sử dụng
Tạo hoặc chỉnh .env cạnh docker-compose.yml, đặt BACKEND_PORT=8001, rồi chạy lại docker compose up -d. Không cần đổi URL dashboard nếu bạn vẫn truy cập frontend ở cổng 3000.
D.Docker cố build source thay vì tải image
Nếu log có các dòng như RUN apt-get, RUN npm ci hoặc RUN pip install, clone của bạn có thể quá cũ. README hướng dẫn sao lưu .env, xóa clone cũ, clone lại repo rồi chạy docker compose pull và docker compose up -d.
E.Podman báo thiếu Compose provider
Trên Windows hoặc WSL, cài podman-compose rồi chạy podman-compose pull và podman-compose up -d trong thư mục repo. Trên Linux, macOS hoặc WSL shell, bạn cũng có thể dùng ./compose.sh --engine podman pull và ./compose.sh --engine podman up -d.
VII.Có nên dùng không
Shadowbroker đáng dùng nếu bạn muốn một bản đồ OSINT đa nguồn, cần theo dõi nhiều loại telemetry hoặc muốn thử kết nối AI agent với dữ liệu địa lý. Docker giúp đường cài đặt cơ bản khá ngắn, còn repo có sẵn Compose, Helm, script khởi động và nhiều lớp dữ liệu để mở rộng dần.
Điểm mạnh khác là kiến trúc self-hosted. Dashboard không yêu cầu tài khoản, không có product telemetry hoặc analytics theo mô tả, và các truy vấn recon được proxy qua backend có kiểm tra SSRF cùng quyền local-operator. Mã nguồn mở cũng cho phép đội kỹ thuật tự kiểm tra cách dữ liệu được truy cập.
Giới hạn lớn là độ phức tạp. Nhiều feed có thể cần API key, RAM, cấu hình mạng và thời gian để dữ liệu khởi động. Một số nguồn có điều khoản sử dụng riêng. Những lớp camera, Shodan, radio hoặc dữ liệu công khai cũng cần được sử dụng đúng pháp luật và đúng quyền truy cập.
InfoNet chưa nên được chọn làm công cụ liên lạc bí mật. README ghi rõ các kênh vẫn có giới hạn riêng tư, một số metadata có thể lộ và các primitive bảo mật nâng cao chưa được nối hoàn chỉnh. Nếu bạn chỉ cần xem bản đồ hoặc theo dõi vài nguồn dữ liệu, một công cụ chuyên biệt có thể dễ vận hành hơn. Nếu bạn cần gom nhiều lớp dữ liệu và chấp nhận tự quản trị Docker, Shadowbroker là lựa chọn đáng thử.
Câu hỏi thường gặp
Shadowbroker có miễn phí không?
Repo là mã nguồn mở và dùng giấy phép AGPL-3.0. README không cung cấp bảng giá dịch vụ. Tuy nhiên, một số nguồn dữ liệu hoặc tính năng có thể cần API key riêng và có điều khoản sử dụng riêng.
Cài Shadowbroker trên Windows được không?
Được, README hướng dẫn dùng Docker Desktop trên Windows. Nếu dùng Podman trên Windows hoặc WSL, bạn cần Compose provider như `podman-compose`.
Có cần GPU không?
Tư liệu được cung cấp không nói Shadowbroker yêu cầu GPU. Cách cài chính dùng Docker và README chỉ nêu yêu cầu bộ nhớ backend, không nêu yêu cầu GPU.
Có cần tài khoản để dùng không?
Dashboard cơ bản không yêu cầu tài khoản hoặc đăng ký. Một số tính năng riêng, như SAR, cần tài khoản NASA Earthdata; các nguồn khác có thể cần API key.
Dữ liệu có an toàn và riêng tư không?
README nói ứng dụng không có tài khoản, product telemetry hoặc analytics; dashboard nói chuyện với backend tự triển khai. Tuy vậy, các tính năng OSINT trực tiếp có thể gửi yêu cầu tới nhà cung cấp dữ liệu, và InfoNet là testnet chưa có cam kết riêng tư tuyệt đối.
Shadowbroker khác công cụ bản đồ thông thường ở điểm nào?
Shadowbroker gom nhiều nguồn OSINT vào hơn một giao diện, gồm hàng không, hàng hải, vệ tinh, thiên tai, camera, radio, dữ liệu mạng và recon. Repo cũng hỗ trợ entity graph và kênh lệnh cho AI agent.


