# 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 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.

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

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.

```repo
- repo | BigBodyCobain/Shadowbroker
- kind | Ứng dụng
- desc | 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.
- stars | 12k
- lang | Python
- license | AGPL-3.0
```

## 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.

## 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_ID` và `OPENSKY_CLIENT_SECRET` cho phần dữ liệu OpenSky nếu bạn bật tính năng tương ứng.
- `AIS_API_KEY` cho nguồn AIS nếu cần.
- `ADMIN_KEY` cho các route quản trị hoặc quyền local-operator.
- `SHODAN_API_KEY` nế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.

```note
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.
```

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

```steps
- Chuẩn bị Docker | Cài và mở Docker Desktop hoặc Docker Engine
- Lấy mã nguồn | Clone repo và đi vào thư mục Shadowbroker
- Tải image | Dùng Docker Compose lấy image dựng sẵn
- Khởi động hệ thống | Chạy các container ở chế độ nền
- Mở dashboard | Truy cập giao diện tại localhost:3000
```

### 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.

### Clone repo

Mở PowerShell hoặc Terminal tại thư mục bạn muốn lưu dự án, sau đó chạy:

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

`git 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`.

### Tải image Docker

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

```bash
docker compose pull
```

Lệ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:

```bash
git clone https://gitlab.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml pull
```

Hai 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.

### Khởi động các container

Với cấu hình GitHub mặc định, chạy:

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

`up` 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:

```bash
docker compose -f docker-compose.yml -f docker-compose.gitlab.yml up -d
```

Nế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:

```bash
BACKEND_PORT=8001
```

Sau đó chạy lại:

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

Trì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.

### Mở dashboard

Mở trình duyệt và truy cập:

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

Nế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`:

```text
MESH_INFONET_FLEET_JOIN=false
```

README 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.

### 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:

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

Nế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:

```bash
cd..
rm -rf Shadowbroker
git clone https://github.com/bigbodycobain/Shadowbroker.git
cd Shadowbroker
docker compose pull
docker compose up -d
```

Lệ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.

## 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:

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

Nế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:

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

Kế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:

```bash
docker compose ps
```

Cá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.

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

### 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.

### 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.

### 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.

### 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

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

### 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.

### 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:

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

Bạ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ổ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`.

### 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`.

### 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`.

## 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.
