# Shadowbroker: bản đồ OSINT thời gian thực — hướng dẫn cài đặt và dùng

> ShadowBroker là nền tảng OSINT mã nguồn mở, gom dữ liệu máy bay, tàu biển, vệ tinh, động đất, camera, sự kiện địa chính trị và nhiều nguồn khác vào một bản đồ. Ứng dụng chạy bằng Docker nên cài khá gọn, nhưng cần máy đủ bộ nhớ và người dùng phải hiểu rõ giới hạn riêng tư của InfoNet.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-11 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/shadowbroker-ban-do-osint-thoi-gian-thuc-3

ShadowBroker là một nền tảng OSINT thời gian thực, giúp bạn xem nhiều loại tín hiệu công khai trên cùng một bản đồ địa lý. Dự án viết bằng Python, FastAPI, Next.js và MapLibre GL, với hơn 60 nguồn dữ liệu được gom về một giao diện duy nhất.

Repo này phù hợp với nhà nghiên cứu, nhân viên phân tích, người làm an ninh mạng, nhà báo, người vận hành radio và lập trình viên muốn tự dựng một bảng điều khiển dữ liệu mở. Điểm đáng giá nhất là bạn không phải mở hàng chục công cụ riêng lẻ để theo dõi máy bay, tàu, vệ tinh, động đất, cháy rừng, hạ tầng internet hay sự kiện địa chính trị.

ShadowBroker hiện có khoảng 11.568 sao và 1.846 fork. Dự án dùng giấy phép AGPL-3.0, vẫn đang được cập nhật. Bạn nên xem đây là một hệ thống tổng hợp dữ liệu công khai để nghiên cứu và giám sát hợp pháp, không phải công cụ bảo đảm bí mật tuyệt đối.

```repo
- repo | BigBodyCobain/Shadowbroker
- kind | Ứng dụng
- desc | ShadowBroker gom hơn 60 nguồn dữ liệu OSINT thời gian thực vào một bản đồ địa lý, có công cụ recon và kết nối AI agent.
- stars | 12k
- lang | Python
- license | AGPL-3.0
```

## ShadowBroker làm được gì

### Gom nhiều lớp dữ liệu vào một bản đồ

Giao diện có hơn 40 lớp dữ liệu có thể bật hoặc tắt. Bạn có thể xem máy bay ADS-B, tàu biển AIS, vệ tinh, động đất, núi lửa, cháy rừng, cảnh báo thời tiết, chất lượng không khí, nhà máy điện, trung tâm dữ liệu, căn cứ quân sự và vùng mất kết nối internet.

Lợi ích thực tế là bạn có thể nhìn mối liên hệ giữa nhiều sự kiện trên cùng một khu vực. Ví dụ, một doanh nghiệp có thể kiểm tra nhà máy và tuyến vận tải của mình đang nằm gần vùng thiên tai hay xung đột nào không.

### Theo dõi máy bay và tàu biển

ShadowBroker hiển thị máy bay đang phát ADS-B, bao gồm máy bay quân sự, máy bay tiếp dầu, máy bay do thám và máy bay tư nhân. Dự án cũng có các lớp theo dõi tàu biển, hơn 25.000 tàu AIS, hoạt động đánh bắt và siêu du thuyền.

Dữ liệu này hữu ích khi bạn cần quan sát luồng vận tải, nghiên cứu hoạt động hàng hải hoặc kiểm tra một khu vực hàng không cụ thể. Không phải mọi phương tiện đều phát tín hiệu hoặc xuất hiện liên tục.

### Xem vệ tinh và hiện tượng gây nhiễu GPS

Các vệ tinh được tô màu theo nhóm nhiệm vụ như trinh sát quân sự, SIGINT, SAR, cảnh báo sớm và trạm không gian. ShadowBroker cũng hiển thị các vùng nghi bị gây nhiễu GPS, được suy ra từ phân tích suy giảm NAC-P của dữ liệu bộ phát đáp máy bay.

Đây là lớp dữ liệu tham khảo để nghiên cứu xu hướng. Bạn không nên xem một điểm trên bản đồ là bằng chứng duy nhất cho một sự kiện thực địa.

### Theo dõi camera, radio và mạng lưới cảm biến

Repo mô tả hơn 11.000 camera CCTV tại sáu quốc gia, cùng các node KiwiSDR, radio ngắn sóng, police scanner, Meshtastic và APRS. Bạn có thể bấm vào một node KiwiSDR để nghe radio ngắn sóng trực tiếp hoặc mở một nguồn police scanner nếu nguồn đó còn hoạt động.

Các tín hiệu radio công khai có thể bị nghe bởi người khác. Vì vậy, tính “công khai” của nguồn dữ liệu cần được hiểu đúng, đặc biệt khi bạn dùng hệ thống trong môi trường doanh nghiệp.

### Tra cứu OSINT và recon phía máy chủ

Recon Toolkit hỗ trợ tra cứu địa chỉ IP, DNS, RDAP/WHOIS, certificate transparency, BGP/ASN, lệnh trừng phạt OFAC, CVE, Tor, OTX và quét subnet thông qua InternetDB. ShadowBroker thực hiện các truy vấn nhạy cảm ở backend thay vì gọi trực tiếp từ trình duyệt.

Dự án có kiểm tra SSRF và yêu cầu quyền local-operator cho các tuyến recon. Nếu dùng Shodan, kết quả được hiển thị thành một lớp bản đồ riêng và vẫn phải tuân theo điều khoản của Shodan.

### Kết nối AI agent làm trợ lý phân tích

Kênh lệnh agent của ShadowBroker dùng chữ ký HMAC và hỗ trợ OpenClaw cùng các agent nói được giao thức tương ứng, chẳng hạn Claude, GPT, LangChain hoặc agent tự viết.

Agent có thể tìm kiếm telemetry và tin tức qua `search_telemetry`, `search_news`, chạy `osint_lookup`, mở rộng entity graph, đặt pin, điều khiển bản đồ, dùng lớp SAR, tương tác với mesh và gửi cảnh báo. Đây là khả năng mạnh, nhưng cũng có nghĩa agent có thể đọc và thực hiện nhiều thao tác trên bản đồ nếu bạn cấp quyền phù hợp.

### Phân tích SAR và thay đổi mặt đất

Lớp SAR dùng dữ liệu NASA OPERA và Copernicus EGMS để phát hiện biến dạng mặt đất, vùng ngập, thay đổi thảm thực vật và thiệt hại. Bạn có thể tạo khu vực theo dõi riêng và nhận cảnh báo bất thường.

Tính năng này cần tài khoản NASA Earthdata theo mô tả của dự án. SAR có thể hoạt động qua mây tốt hơn ảnh quang học, nhưng kết quả vẫn cần được kiểm tra trong bối cảnh thực địa.

### Theo dõi rủi ro chuỗi cung ứng và mối đe dọa mạng

SCM panel chấm điểm các nhà máy bán dẫn và pin cấp 1, cấp 2 dựa trên khoảng cách tới động đất, cháy rừng và sự kiện xung đột. Bạn cũng có thể bật lớp malware C2 từ Feodo Tracker và URLhaus.

ShadowBroker còn hỗ trợ các kênh Telegram công khai, chấm điểm rủi ro, gắn tọa độ gần khu vực đô thị và đặt tin lên bản đồ. Các kênh được nêu trong README là các kênh công khai về chiến tranh và xung đột.

### Tham gia InfoNet testnet

InfoNet cung cấp nhắn tin obfuscated, gate persona, Dead Drop peer-to-peer exchange, terminal CLI và cơ chế mesh phân tán. Bạn có thể tham gia từ nút NODE trong dashboard hoặc chạy participant headless.

Đây là testnet thử nghiệm. Nội dung một số kênh được mã hóa, nhưng metadata, thời gian, gate id hoặc người có khóa vẫn có thể lộ tùy kênh. Dự án nói rõ không được gửi thông tin nhạy cảm trên bất kỳ kênh nào.

### Đổi giao diện hiển thị

Nút STYLE cho phép chuyển giữa DEFAULT, SATELLITE, FLIR, NVG và CRT. Các chế độ này giúp bạn chọn kiểu hiển thị phù hợp khi theo dõi bản đồ lớn hoặc muốn giao diện giống màn hình phân tích chuyên dụng.

```note
Không gửi thông tin nhạy cảm qua InfoNet, Meshtastic, APRS hoặc các kênh thử nghiệm. Dữ liệu công khai vẫn có thể tạo rủi ro khi được tổng hợp với nhau.
```

## Cần chuẩn bị gì

Bạn cần một máy chạy được Docker Desktop hoặc Docker Engine. README nêu rõ Docker Desktop phù hợp với Windows; Podman cũng được hỗ trợ nếu bạn cài một Compose provider phù hợp.

Dự án yêu cầu Python từ phiên bản 3.10 trở lên trong `pyproject.toml`. Tuy nhiên, cách Quick Start dùng ảnh Docker dựng sẵn nên bạn không nhất thiết phải tự cài Python để chạy bản thông thường.

Bạn cần Git để tải mã nguồn và Docker Compose để tải, khởi động container. Máy cần đủ bộ nhớ cho backend. Compose mặc định cấp 4 GB cho backend; nếu máy có ít bộ nhớ hơn, README khuyến nghị giảm số feed hoặc đặt `BACKEND_MEMORY_LIMIT=3G`, đổi lại các lớp nặng sẽ khởi động chậm hơn.

Một số tính năng tùy chọn cần khóa hoặc tài khoản riêng. Danh sách biến trong `.env.example` gồm `OPENSKY_CLIENT_ID`, `OPENSKY_CLIENT_SECRET`, `AIS_API_KEY` và `ADMIN_KEY`. README cũng mô tả connector Shodan dùng khóa `SHODAN_API_KEY`, còn SAR cần tài khoản NASA Earthdata.

Bạn không cần tài khoản ShadowBroker để mở dashboard. InfoNet cũng không yêu cầu signup, nhưng điều đó không đồng nghĩa với riêng tư tuyệt đối.

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

```steps
- Chuẩn bị Docker và Git | Cài Docker Desktop hoặc Docker Engine, mở terminal
- Tải repo | Clone mã nguồn và đi vào thư mục Shadowbroker
- Tải image | Dùng Docker Compose kéo image dựng sẵn
- Khởi động | Chạy container ở chế độ nền
- Mở dashboard | Truy cập localhost:3000 bằng trình duyệt
```

### Chuẩn bị terminal và Docker

Cài Docker Desktop trên Windows hoặc Docker Engine trên Linux/macOS. Sau đó mở PowerShell, Windows Terminal hoặc terminal của hệ điều hành. Kiểm tra Docker đã chạy trước khi thực hiện bước tiếp theo.

README không đưa lệnh kiểm tra phiên bản Docker cụ thể. Nếu Docker Desktop chưa mở, lệnh Compose thường sẽ không kết nối được tới Docker Engine.

### Tải mã nguồn

Mở terminal tại thư mục bạn muốn lưu dự án rồi chạy:

```bash
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
```

Lệnh đầu tải repo về máy. Lệnh thứ hai đi vào thư mục dự án. Trên Windows, bạn có thể chạy hai lệnh này trong PowerShell nếu Git đã được cài và có trong PATH.

### Tải các image Docker

Trong thư mục `Shadowbroker`, chạy:

```bash
docker compose pull
```

Lệnh này lấy các image dựng sẵn từ GHCR theo cấu hình mặc định. README nói bản Docker này không yêu cầu build cục bộ.

Nếu bạn dùng GitLab Container Registry, chạy đúng nhóm lệnh sau:

```bash
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 -d
```

Hai lựa chọn dùng cùng source và tạo container tương đương. Bạn chỉ cần chọn một cách.

### Khởi động ứng dụng

Với lựa chọn GitHub mặc định, chạy:

```bash
docker compose up -d
```

`up -d` tạo và chạy các container ở chế độ nền. Sau đó mở địa chỉ sau trong trình duyệt:

```text
http://localhost:3000
```

Cổng 3000 là cổng trình duyệt cần dùng. Backend cũng được publish ở cổng 8000 để chẩn đoán cục bộ. Nếu cổng 8000 đã bị ứng dụng khác chiếm, tạo hoặc sửa `.env` cạnh `docker-compose.yml`, đặt `BACKEND_PORT=8001`, rồi chạy lại:

```bash
docker compose up -d
```

Không tự thêm tên biến khác nếu bạn chưa kiểm tra `.env.example` hoặc tài liệu trong repo.

### Tham gia hoặc tắt InfoNet

Trong dashboard, bấm `NODE` để tham gia private InfoNet swarm `sb-testnet-0`. Nếu muốn chạy participant headless, README cung cấp lệnh sau trong bash-compatible shell:

```bash
./meshnode.sh
```

Để chạy node riêng, đặt biến sau trong `.env`:

```text
MESH_INFONET_FLEET_JOIN=false
```

Đây là lựa chọn vận hành, không phải bước bắt buộc để mở dashboard.

### Cập nhật bản cài đặt

Khi muốn cập nhật image, chạy:

```bash
docker compose pull
docker compose up -d
```

Nếu đang dùng bản repo cũ, trước tiên cập nhật mã nguồn rồi khởi động lại:

```bash
git pull origin main
docker compose down
docker compose pull
docker compose up -d
```

Nếu `git pull` thất bại hoặc Compose vẫn build source, README hướng dẫn clone lại repo trong thư mục mới. Hãy sao lưu `.env` hoặc cấu hình cục bộ trước khi thay thư mục.

### Cài bằng Helm cho môi trường nâng cao

Với home lab hoặc cụm Kubernetes, thêm repo Helm:

```bash
helm repo add bjw-s-labs https://bjw-s-labs.github.io/helm-charts/
helm repo update
```

Sau đó cài chart mặc định:

```bash
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker
```

Bản dùng GitLab registry:

```bash
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker \
  -f helm/chart/values.yaml \
  -f helm/chart/values-gitlab.yaml
```

README mô tả Helm chart có thể scale backend và frontend riêng, chạy với UID hạn chế 1001 và sẵn sàng tích hợp Ingress.

## 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 thị, phần frontend đã truy cập được backend theo cấu hình Compose.

Bạn có thể kiểm tra trạng thái container bằng giao diện Docker Desktop hoặc xem log backend bằng:

```bash
docker compose logs -f backend
```

Khi cập nhật, nếu muốn ép tải lại image:

```bash
docker compose pull --no-cache
```

Nếu dashboard mở nhưng một số lớp như news, UAP, bases hoặc wastewater trống sau vài phút, README khuyến nghị kiểm tra container có bị OOM restart không:

```bash
docker events --since 30m --filter container=shadowbroker-backend --filter event=oom
```

Các lớp nặng có thể cần thời gian làm nóng. Kết quả cũng phụ thuộc vào feed và khóa API bạn đã bật.

## Dùng vào việc thật

### Chủ shop kiểm tra rủi ro chuỗi cung ứng

Một chủ shop bán thiết bị điện tử có thể dùng SCM panel để xem các nhà máy bán dẫn và pin trong chuỗi cung ứng có nằm gần vùng động đất, cháy rừng hoặc xung đột không. Bạn bật lớp SCM, quan sát các điểm liên quan và so sánh với các lớp thiên tai.

Kết quả là một bản đồ trực quan để ưu tiên kiểm tra nhà cung cấp. Đây không phải hệ thống dự báo giao hàng, nên bạn vẫn cần xác nhận với đối tác và hãng vận tải.

### Nhân viên văn phòng theo dõi chuyến bay và vận tải

Nhân viên phụ trách logistics có thể mở lớp máy bay ADS-B, AIS và tàu biển để quan sát một khu vực hoặc tuyến vận tải. Bạn có thể kết hợp lớp thời tiết, động đất, cháy rừng và cảnh báo địa chính trị để phát hiện bối cảnh bất thường quanh tuyến hàng hóa.

Kết quả là một màn hình tổng hợp thay cho việc chuyển qua nhiều trang. Các phương tiện không phát tín hiệu sẽ không xuất hiện đầy đủ.

### Nhà nghiên cứu an ninh kiểm tra một IP

Một nhà nghiên cứu có thể dùng Recon Toolkit để tra IP, DNS, RDAP/WHOIS, BGP/ASN, certificate transparency, CVE hoặc OFAC. Các truy vấn chạy qua backend tự host, còn trình duyệt gọi các tuyến `/api/osint/*` hoặc `/api/tools/shodan/*` theo mô tả của dự án.

Bạn nên chỉ kiểm tra tài sản được phép kiểm tra. Với Shodan, cần khóa API do nhà vận hành cung cấp và phải tuân thủ điều khoản của dịch vụ.

### Dev dùng AI agent làm trợ lý bản đồ

Một dev có thể kết nối agent tương thích HMAC để yêu cầu tìm kiếm telemetry, tìm tin tức, mở rộng entity graph hoặc đặt pin trên bản đồ. Ví dụ yêu cầu tự nhiên có thể là: “Tìm các tín hiệu hàng hải trong khu vực này, đối chiếu với sự kiện thời tiết và đặt pin cho các điểm cần xem xét.”

Agent có thể thao tác trên những lớp mà operator cho phép. Vì vậy, hãy giới hạn quyền, kiểm tra chữ ký và không giao cho agent quyền rộng hơn nhu cầu.

> ShadowBroker biến những tín hiệu công khai rời rạc thành một bức tranh có thể quan sát cùng lúc.
>
> — Ông T

## Lỗi hay gặp và cách xử lý

### Docker không chạy hoặc không kết nối được Engine

Hãy mở Docker Desktop trên Windows hoặc kiểm tra Docker Engine trên hệ điều hành của bạn. Sau đó chạy lại `docker compose pull` và `docker compose up -d` trong thư mục `Shadowbroker`.

### Cổng backend 8000 bị chiếm

Trình duyệt vẫn dùng cổng 3000, nhưng backend diagnostics mặc định dùng 8000. 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`.

### Backend bị OOM restart

Dấu hiệu thường là một số lớp không hiện sau vài phút hoặc container tự khởi động lại. Kiểm tra bằng lệnh `docker events` trong README, sau đó giảm số feed hoặc đặt `BACKEND_MEMORY_LIMIT=3G`; các lớp nặng có thể khởi động chậm hơn.

### Podman báo thiếu Compose provider

`podman compose` chỉ là wrapper và vẫn cần Compose provider. Trên Windows/WSL, README hướng dẫn cài `podman-compose`, sau đó chạy:

```bash
podman-compose pull
podman-compose up -d
```

Bạn cũng có thể dùng `./compose.sh --engine podman pull` và `./compose.sh --engine podman up -d` trong shell Linux, macOS hoặc WSL.

### Repo cũ vẫn build source

Nếu `docker compose up` hiển thị `RUN apt-get`, `RUN npm ci` hoặc `RUN pip install`, bản clone của bạn có thể đang dùng lịch sử repo cũ. Sao lưu `.env`, clone lại repo, rồi chạy `docker compose pull` và `docker compose up -d`. Không xóa thư mục cũ nếu bạn chưa xác nhận đã giữ lại cấu hình cần thiết.

## Có nên dùng không

ShadowBroker đáng dùng nếu bạn cần một bản đồ OSINT tự host, nhiều lớp dữ liệu và khả năng mở rộng bằng AI agent. Docker giúp cách chạy ban đầu khá rõ ràng. Repo cũng có Helm chart cho home lab hoặc cụm Kubernetes, cùng các công cụ recon chạy phía backend.

Giới hạn lớn nhất là hệ thống nhiều thành phần và phụ thuộc vào dữ liệu bên ngoài. Một số lớp cần API key, tài khoản hoặc thời gian làm nóng. Dữ liệu công khai không phải lúc nào cũng đầy đủ, chính xác hoặc cập nhật liên tục.

InfoNet và các tính năng liên quan đến riêng tư chưa phù hợp cho thông tin mật. README nhấn mạnh rằng đây là experimental testnet, không phải private messenger hay hệ thống governance production. Meshtastic và APRS là công khai; các kênh khác cũng không nên được xem là an toàn tuyệt đối.

Bạn nên chọn ShadowBroker khi muốn tự quản lý dashboard và chấp nhận việc vận hành Docker, cấu hình feed, kiểm soát quyền agent và tự đánh giá dữ liệu. Nếu chỉ cần theo dõi một loại dữ liệu đơn lẻ, một công cụ chuyên dụng có thể nhẹ hơn, dễ xác minh hơn và ít tốn tài nguyên hơn.

## 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. Tuy nhiên, một số tính năng có thể cần API key, tài khoản dịch vụ hoặc tài nguyên máy chủ; README không đưa ra bảng chi phí tổng thể.

### Có cần GPU để chạy không?

Tư liệu được cung cấp không nói ShadowBroker cần GPU. Quick Start dùng Docker và các image dựng sẵn, nhưng backend mặc định được cấp 4 GB bộ nhớ.

### Có chạy được trên Windows không?

Có thể chạy bằng Docker Desktop trên Windows theo hướng dẫn Quick Start. Podman trên Windows/WSL cũng được hỗ trợ nếu cài thêm Compose provider phù hợp.

### Có cần tài khoản ShadowBroker không?

README nói dashboard không có tài khoản và không cần signup. Một số tính năng riêng vẫn cần thông tin xác thực riêng, như NASA Earthdata cho SAR hoặc khóa API do operator cung cấp.

### Dữ liệu có an toàn và riêng tư không?

Ứng dụng không có product telemetry, analytics hoặc tài khoản, còn các khóa operator được giữ trong deployment cục bộ. Tuy vậy, các tính năng live OSINT tạo outbound request tới nhà cung cấp dữ liệu, và README cảnh báo không gửi thông tin nhạy cảm qua InfoNet hay các kênh thử nghiệm.

### ShadowBroker khác công cụ bản đồ hoặc OSINT đơn lẻ thế nào?

ShadowBroker gom hơn 60 nguồn và hơn 40 lớp dữ liệu vào một giao diện bản đồ, đồng thời có recon toolkit và kênh AI agent. Nếu bạn chỉ cần một loại dữ liệu, công cụ chuyên dụng có thể đơn giản hơn.

### Có nên dùng Shodan trực tiếp từ trình duyệt không?

Theo README, connector Shodan của ShadowBroker chạy phía server và trình duyệt gọi backend tự host. Bạn vẫn cần khóa Shodan do operator cung cấp và phải tuân thủ điều khoản của Shodan.
