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, CCTV...) lên một bản đồ web chạy trên máy của bạn. Cách cài chính thức là Docker, chỉ cần vài lệnh rồi mở localhost:3000. Người mới có Docker thì cài không khó.
Shadowbroker là một bảng điều khiển bản đồ mã nguồn mở, gom dữ liệu công khai từ hơn 60 nguồn trực tiếp lên cùng một màn hình. Máy bay, tàu biển, vệ tinh, động đất, camera giao thông, vùng nhiễu GPS, tin nóng địa chính trị... tất cả cập nhật theo thời gian thực trên một giao diện bản đồ tối màu. Bạn tự chạy nó trên máy mình, không cần tạo tài khoản.
Rất 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. Tác giả nói rõ dự án không tạo ra khả năng giám sát mới. Nó chỉ tổng hợp và hiển thị các bộ dữ liệu đã có sẵn. 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.
Ai nên dùng? Nhà nghiên cứu, người làm phân tích, người chơi radio nghiệp dư, hoặc bất kỳ ai tò mò muốn xem thế giới đang chuyển động ra sao. Điểm đáng giá nhất theo mình là hai thứ. Một là cài bằng Docker khá gọn. Hai là bạn có thể nối một AI agent vào để nó đọc dữ liệu cùng bạn và tìm mối liên hệ giữa các lớp dữ liệu.
BigBodyCobain/Shadowbroker
Bảng điều khiển bản đồ tự lưu trữ, gom máy bay, tàu biển, vệ tinh, động đất, camera công cộng và nhiều nguồn OSINT khác lên một màn hình.
I.Shadowbroker làm được gì
Theo README, giao diện chạy trên Next.js và MapLibre GL, phần backend dùng FastAPI và Python. Các tính năng đáng chú ý:
- Hơn 40 lớp dữ liệu bật/tắt được. Bạn chỉ bật thứ cần xem, bản đồ đỡ rối. Lớp nào cũng có thể chồng lên nhau để so sánh.
- Theo dõi máy bay qua ADS-B. Gồm máy bay tư nhân, máy bay quân sự, và các chuyến bay của nguyên thủ được đánh dấu riêng.
- Tàu biển và vệ tinh. README nhắc tới hơn 25.000 tàu AIS, hoạt động đánh bắt cá qua Global Fishing Watch, và vệ tinh được tô màu theo loại nhiệm vụ.
- Camera công cộng. Hơn 11.000 camera CCTV ở 6 quốc gia (London, NYC, California, Tây Ban Nha, Singapore...) phát trực tiếp ngay trên bản đồ.
- Thiên tai và môi trường. Động đất, núi lửa, cháy rừng (NASA FIRMS), cảnh báo thời tiết xấu, chất lượng không khí.
- Vùng nhiễu GPS. Suy ra từ phân tích tín hiệu transponder của máy bay.
- Bộ công cụ recon chạy phía server. Tra IP, DNS, RDAP/WHOIS, chứng chỉ, BGP/ASN, danh sách trừng phạt OFAC, CVE... Các truy vấn này đi qua backend của bạn, không đi thẳng từ trình duyệt.
- Chuột phải vào bất kỳ điểm nào trên Trái Đất. Bạn nhận hồ sơ quốc gia, tóm tắt Wikipedia và ảnh vệ tinh Sentinel-2 mới nhất.
- Nhiều chế độ hiển thị. DEFAULT, SATELLITE, FLIR, NVG, CRT, đổi bằng nút STYLE.
- Kênh lệnh cho AI agent. Agent ký lệnh bằng HMAC, đọc được dữ liệu các lớp, tìm kiếm chéo (
search_telemetry,search_news), tra cứu recon (osint_lookup), đặt ghim và điều khiển bản đồ. - InfoNet. Một mạng nhắn tin thử nghiệm tích hợp sẵn. README ghi rõ đây là testnet, chưa đảm bảo riêng tư.
Về riêng tư: README nói dự án không có tài khoản, không có telemetry sản phẩm, không có analytics. Khóa API bạn nhập nằm trong bản triển khai cục bộ. Tuy vậy, các tính năng OSINT vẫn phải gọi ra các nhà cung cấp dữ liệu công khai mà bạn bật.
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Docker Desktop hoặc Docker Engine. Đây là yêu cầu chính của cách cài nhanh. Podman cũng chạy được nhưng cần thêm công cụ phụ (xem phần Lỗi hay gặp).
- Git, để tải repo về.
- Bộ nhớ cho backend. Compose mặc định cấp 4GB cho backend. Máy ít RAM hơn thì README gợi ý giảm bớt lớp dữ liệu hoặc đặt
BACKEND_MEMORY_LIMIT=3G. - Cổng 3000 cho giao diện và cổng 8000 cho backend. Cổng 8000 có thể đổi nếu bị trùng.
- Khóa API (tùy chọn). File
.env.examplecó các biếnOPENSKY_CLIENT_ID,OPENSKY_CLIENT_SECRET,AIS_API_KEY,ADMIN_KEY. README còn nhắcSHODAN_API_KEYnếu bạn muốn dùng Shodan. Tài liệu bạn đưa mình không nói chi tiết từng biến bắt buộc hay không, nên hãy mở.env.exampletrong repo để xem ghi chú. - Tài khoản NASA Earthdata (miễn phí) nếu muốn dùng lớp phát hiện thay đổi mặt đất bằng SAR.
Chưa có thông tin nào về yêu cầu GPU. README cũng không nêu yêu cầu cụ thể về hệ điều hành ngoài việc có Docker. Repo có sẵn các file start.bat, start.sh cho Windows và Linux/macOS, nhưng README phần mình có không giải thích cách dùng chúng.
Ngoài ra, pyproject.toml ghi yêu cầu Python từ 3.10 trở lên và tên gói Python là shadowbroker. Nếu chỉ chạy bằng Docker thì bạn không cần cài Python.
III.Cài đặt từng bước
- Cài DockerCài Docker Desktop (hoặc Docker Engine) và Git
- Tải repoDùng git clone rồi cd vào thư mục Shadowbroker
- Kéo imageChạy docker compose pull để tải các image dựng sẵn
- Khởi độngChạy docker compose up -d để bật container
- Mở dashboardVào http://localhost:3000 bằng trình duyệt
A.Cài Docker và Git
Vào trang Docker Desktop để tải bản cho hệ điều hành của bạn, cài xong thì mở Docker lên và đợi nó báo đã chạy. Bước này hay bị bỏ qua: nếu Docker chưa chạy, các lệnh phía dưới sẽ báo lỗi kết nối. Bạn cũng cần Git để tải mã nguồn.
B.Tải repo về máy
Mở terminal (PowerShell hoặc Command Prompt trên Windows, Terminal trên macOS/Linux). Chạy lệnh sau ở thư mục bạn muốn đặt dự án:
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd ShadowbrokerLệnh đầu tải mã nguồn về, lệnh thứ hai đi vào thư mục vừa tạo. Mọi lệnh Docker sau đó phải chạy trong thư mục này, vì Docker cần đọc file 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ừ registry. up -d bật các container và chạy nền. Lần đầu có thể mất một lúc vì phải tải image. README cũng cho cách cài từ GitLab nếu bạn quen hệ đó hơn:
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 cách cho ra container giống nhau. Chọn cách nào cũng được, người mới nên dùng cách GitHub ở trên.
D.Mở dashboard
Mở trình duyệt và vào http://localhost:3000. Bạn sẽ thấy bản đồ của Shadowbroker.
E.Đổi cổng nếu bị trùng (khi cần)
Trình duyệt chỉ cần cổng 3000, nhưng backend cũng mở cổng 8000 trên máy để chẩn đoán. Nếu cổng 8000 đã có ứng dụng khác dùng, tạo hoặc sửa file .env nằm cạnh docker-compose.yml, thêm dòng sau rồi chạy lại docker compose up -d:
BACKEND_PORT=8001Khóa API (OpenSky, AIS, Shodan...) là của riêng 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ụ như Shodan có điều khoản sử dụng và có thể tính phí theo gói của họ.
F.Cập nhật về sau
docker compose pull
docker compose up -dREADME nói chỉ cần hai lệnh này là cập nhật xong. Nếu bạn đang dùng bản clone cũ, hãy chạy thêm các lệnh sau theo đúng thứ tự:
git pull origin main
docker compose down
docker compose pull
docker compose up -dIV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất: mở http://localhost:3000. Nếu thấy bản đồ với các lớp dữ liệu và nút STYLE để đổi chế độ hiển thị thì bạn đã cài thành công.
Nếu trang không mở được, xem log của backend bằng lệnh README cung cấp:
docker compose logs -f backendBạn cũng có thể mở Docker Desktop để xem container có đang ở trạng thái chạy hay không. Một lưu ý từ README: sau vài phút nếu các lớp như tin tức, căn cứ quân sự bị trống, rất có thể backend hết bộ nhớ và bị khởi động lại. Phần Lỗi hay gặp có cách kiểm tra.
V.Dùng vào việc thật
Shadowbroker không phải công cụ "cài xong là ra báo cáo". Nó là bản đồ để bạn khám phá. Dưới đây là vài tình huống bám sát khả năng README mô tả.
A.Nhân viên văn phòng theo dõi rủi ro chuỗi cung ứng
Bạn làm mua hàng cho một công ty nhập linh kiện điện tử và muốn biết khu vực nhà máy bán dẫn hay pin có đang gặp biến cố không. Bật lớp thiên tai (động đất, cháy rừng) và lớp sự kiện xung đột, rồi mở bảng SCM. Theo README, bảng này chấm điểm rủi ro cho các nhà máy bán dẫn và pin cấp 1 và cấp 2 dựa trên động đất, cháy rừng và xung đột ở gần. Kết quả là bạn có một cái nhìn nhanh để đưa vào cuộc họp, chứ không phải số liệu để quyết định thay bạn.
B.Nhà nghiên cứu tra cứu một địa chỉ IP hoặc tên miền
Bạn nhận được một email đáng ngờ và muốn kiểm tra tên miền. Mở bộ Recon Toolkit ở thanh bên trái. README liệt kê các tra cứu: DNS, RDAP/WHOIS, chứng chỉ, BGP/ASN, danh sách trừng phạt OFAC, CVE, kiểm tra Tor/OTX. Các truy vấn chạy qua backend của bạn với lớp bảo vệ SSRF, và yêu cầu quyền người vận hành cục bộ. Bạn có kết quả tập trung một chỗ thay vì mở nhiều tab.
Dữ liệu công khai thì ai cũng có, nhưng đặt chúng lên cùng một bản đồ mới là lúc bạn thấy được mối liên hệ.
Ông T
C.Người mê hàng không theo dõi chuyến bay
Bạn thích hàng không và muốn xem máy bay quân sự hay máy bay tư nhân đang bay đâu. Bật lớp máy bay ADS-B rồi bấm vào từng chiếc. Khi chọn một máy bay, tàu hay công ty, bạn có thể mở bảng Entity Graph để xem các liên kết từ Wikidata, OFAC và dữ liệu đang lưu. Bạn thấy được vị trí và các thông tin công khai liên quan, không hơn.
D.Dev nối AI agent làm trợ lý phân tích
Bạn có sẵn một agent (README nói hỗ trợ OpenClaw và các agent biết giao thức HMAC, như Claude, GPT, LangChain hoặc agent tự viết). Kênh lệnh cho agent đọc được dữ liệu các lớp, tìm kiếm chéo bằng search_telemetry và search_news, và tra cứu bằng osint_lookup. Bạn có thể giao việc kiểu: "Tìm các sự kiện gần khu vực này trong 24 giờ qua và tóm tắt theo lớp dữ liệu". Cách cấu hình kết nối cụ thể không có trong phần README mình nhận được. Hãy xem thư mục openclaw-skills/ và docs/ trong repo.
VI.Lỗi hay gặp và cách xử lý
A.Cổng 8000 đã bị chiếm
Backend không lên vì cổng bị trùng. Tạo hoặc sửa .env cạnh docker-compose.yml, đặt BACKEND_PORT=8001, rồi chạy lại docker compose up -d. Giao diện vẫn ở cổng 3000.
B.Các lớp trống sau vài phút (hết bộ nhớ)
README cảnh báo backend có thể bị tắt do thiếu RAM. Kiểm tra bằng lệnh:
docker events --since 30m --filter container=shadowbroker-backend --filter event=oomCompose mặc định cấp 4GB. Nếu máy bạn ít hơn, hãy bật ít lớp dữ liệu lại, hoặc đặt BACKEND_MEMORY_LIMIT=3G trong .env (các lớp nặng sẽ nạp chậm hơn).
C.Docker lại build từ mã nguồn thay vì kéo image
Nếu khi chạy docker compose up bạn thấy các dòng như RUN apt-get, RUN npm ci hoặc RUN pip install, nghĩa là nó đang build từ mã nguồn. README cho biết bản clone cũ có thể bị lệch lịch sử commit, và git pull thông thường không sửa được. Cách xử lý là sao lưu .env của bạn, 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 -dCẩn thận với lệnh rm -rf: nó xóa hẳn thư mục. Hãy chắc là bạn đã sao lưu file cấu hình trước.
D.Dùng Podman báo lỗi compose provider
Trên Windows/WSL, nếu gặp looking up compose provider failed, README bảo cài podman-compose, rồi chạy từ trong thư mục Shadowbroker:
podman-compose pull
podman-compose up -dTrên Linux/macOS/WSL, README còn cho cách dùng ./compose.sh --engine podman pull và ./compose.sh --engine podman up -d.
E.Muốn xem lỗi cụ thể
Xem log bằng docker compose logs -f backend. Muốn tải lại image sạch, README ghi docker compose pull --no-cache. Muốn dọn image cũ thì dùng docker image prune -f.
VII.Có nên dùng không
Điểm mạnh. Tất cả nằm trên một màn hình thay vì hàng chục tab. Cài bằng Docker khá gọn. Mã nguồn mở nên bạn kiểm tra được dữ liệu nào đang được gọi. Không có tài khoản hay analytics của sản phẩm, và các truy vấn nhạy cảm đi qua backend do bạn tự chạy. Có kênh cho AI agent nếu bạn muốn tự động hóa phân tích.
Giới hạn. Đây là một hệ thống lớn, nặng: backend mặc định cần tới 4GB RAM. Nó gọi ra nhiều nhà cung cấp dữ liệu bên ngoài, nên chất lượng và độ sẵn sàng của từng lớp phụ thuộc vào họ. Một số lớp cần khóa API hoặc tài khoản riêng. Phần InfoNet chỉ là testnet thử nghiệm. README nhấn mạnh không có đảm bảo riêng tư, nên đừng gửi gì nhạy cảm qua đó. Các cơ chế riêng tư nâng cao (RingCT, stealth, DEX) được ghi là chưa nối vào hệ thống.
Giấy phép. AGPL-3.0, khá chặt về chia sẻ mã khi bạn chỉnh sửa và cung cấp dịch vụ cho người khác. Nếu bạn định tích hợp vào sản phẩm thương mại, hãy đọc kỹ giấy phép.
Khi nào chọn cách khác. Nếu bạn chỉ cần xem chuyến bay hoặc tàu biển, một trang theo dõi chuyên dụng sẽ nhẹ và nhanh hơn. Nếu cần kênh liên lạc riêng tư thật sự, đừng dựa vào InfoNet ở giai đoạn này. Còn nếu bạn muốn một bản đồ tổng hợp tự chạy được và có thể mở rộng, Shadowbroker là lựa chọn đáng thử.
Lưu ý: phần mô tả này dựa trên phần README mình có. README còn dài hơn và có thêm các mục tính năng chi tiết, nên hãy đọc tiếp trong repo trước khi triển khai nghiêm túc.
Câu hỏi thường gặp
Shadowbroker có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0 nên bạn dùng được không mất tiền phần mềm. Một số nguồn dữ liệu cần khóa API hoặc tài khoản riêng, ví dụ NASA Earthdata (README ghi là miễn phí) và Shodan (chịu điều khoản của Shodan). Chi phí cụ thể của từng nhà cung cấp, tư liệu chưa nêu.
Cài Shadowbroker có cần GPU không?
Tư liệu không nhắc yêu cầu GPU. Điều README nói rõ là backend mặc định được cấp 4GB bộ nhớ, và máy ít RAM hơn có thể đặt BACKEND_MEMORY_LIMIT=3G để giảm tải.
Chạy được trên Windows không?
README hướng dẫn cài bằng Docker Desktop hoặc Docker Engine, và có nhắc người dùng Podman trên Windows/WSL. Repo cũng có sẵn các file .bat. README phần mình có không nói rõ yêu cầu hệ điều hành cụ thể ngoài việc có Docker.
Dữ liệu của tôi có an toàn không?
README nói dự án không có tài khoản, telemetry sản phẩm hay analytics, và dashboard nói chuyện với backend tự lưu trữ của bạn. Các truy vấn recon và Shodan đi qua backend với lớp bảo vệ SSRF. Tuy vậy, các tính năng OSINT vẫn phải gọi ra nhà cung cấp dữ liệu công khai mà bạn bật. Phần InfoNet là testnet, tác giả ghi rõ không đảm bảo riêng tư.
Làm sao đổi cổng nếu cổng 8000 bị chiếm?
Tạo hoặc sửa file .env cạnh docker-compose.yml, đặt BACKEND_PORT=8001, rồi chạy lại docker compose up -d. Trình duyệt vẫn truy cập qua cổng 3000.
Có kết nối được với AI agent không?
Có. README nói kênh lệnh ký bằng HMAC hỗ trợ OpenClaw và các agent khác như Claude, GPT, LangChain hoặc agent tự viết. Agent có thể tìm kiếm dữ liệu chéo các lớp và dùng bộ recon. Cách cấu hình chi tiết chưa có trong phần README mình nhận được; bạn có thể xem thư mục openclaw-skills/ và docs/ trong repo.
Cập nhật phiên bản mới thế nào?
Chạy docker compose pull rồi docker compose up -d. Nếu bạn đang dùng bản clone cũ và Docker cứ build từ mã nguồn, README khuyên sao lưu file .env, xóa thư mục và clone lại từ đầu.


