HN 日本語サマリー

← 一覧へ戻る
その他

IPクロール:公開インターネット上で発見されたオープンウェブカメラの生きたアトラス

IP Crawl: living atlas of open webcams discovered on the public internet (ipcrawl.com)

274 pointsby arm32135 コメント

要約

このサイトは、インターネット上で公開されているウェブカメラを探索するための「生きたアトラス」を提供しています。世界中の様々な場所にある無数のウェブカメラにアクセスし、リアルタイムの映像や情報を得ることができます。

全文翻訳

Folders and files

IP Crawl (ipcrawl.com)

公開インターネットインテリジェンスを通じて発見されたオープンウェブカメラのフィルタリング可能なカタログとライブプレビューサーフェス。

[画像: IP Crawl Explore UI — フィルタリング可能なカメラカタログ、地図、統計情報、ライブプレビュー]


IP Crawlとは?

IP Crawlは、公開インターネットインテリジェンスソース(現在はShodan)を通じて発見されたオープンウェブカメラのデータをサーフェス化します。以下の機能を提供します。

  • カタログ (/、「Explore」) — 国、都市、組織、メーカー、稼働状況、またはフリーテキスト検索で数千台のカメラを閲覧できます。カメラを開くと、より大きなライブまたは静止プレビューが表示されます。
  • Fun Mode (/fun) — Guess Mode、スクリーンセーバー、ライブのみのフィルタリング、共有可能なチャンネルURL(/fun/c/[id])を備えたCRTスタイルのランダムチャンネルビューアです。これはオリジナルのPOCでした。
  • マップ (/map) — カメラ位置をクラスター化されたマーカーで空間的に表示します。
  • 統計 (/stats) — 集計メトリクスと12ヶ月のトレンドチャートを表示します。
  • API (/api) — 公開APIのドキュメント(現時点では1つのCORSオープンエンドポイント)です。
  • 「私のカメラは露出していますか?」 (/imce) — 訪問者のIPがカタログに表示されているかどうかを確認する、一般消費者向けのスキャンです。ismycameraexposed.com。

このプロジェクトは、全てのオープンウェブカメラを保護し、オープンウェブカメラの総数をゼロにするというミッションを持っています。ミッションの詳細についてはこちらをお読みください。

Tech Stack

LayerTechnology
FrameworkNuxt 4 (Vue 3.5, Nitro 2)
StylingTailwind CSS 4 + Nuxt UI 4
IconsIconify (Lucide + Simple Icons)
MapsLeaflet
Markdownmarked
RuntimeNode.js (VPS, systemd + nginx)
StorageSQLite (node:sqlite) + filesystem
TestingPlaywright (E2E)
CIGitHub Actions

Quick Start

# Clone and install
git clone https://github.com/iptv-crawler/ipcrawl.git
cd ipcrawl
pnpm install

# Configure your Shodan API key
cp .env.example .env
# Edit .env — add your NUXT_SHODAN_API_KEY

# Start the dev server (local SQLite)
pnpm run dev

開発サーバーは http://localhost:3000 で実行されます。ストレージはデフォルトでローカルファイルシステム(./.data/)に設定されているため、ローカルでカタログを閲覧できます。

Environment Variables
VariableDefaultDescription
NUXT_SHODAN_API_KEY—Shodan APIキー(カメラの更新に必要)
NUXT_SHODAN_LIMIT_PER_QUERY1500Shodanクエリページあたりの最大カメラ数
NUXT_EDGE_KILL_SWITCHfalse緊急停止スイッチ — ライブプローブをスキップし、キャッシュされたスクリーンショットを提供します
NUXT_OFFLINE_FOR_NOWfalse全てのトラフィックをオーバーロードページにリダイレクトします
NUXT_ENABLE_LIVE_PROBEfalseライブカメラフレームの取得を有効にします

Architecture

app/             Root app shell, global theme, error pages
├── layers/      
│   ├── explore/   Catalog UI at / (grid, sidebar, dialog)
│   ├── fun/       CRT roulette at /fun (random channel viewer)
│   ├── imce/      "Is My Camera Exposed?" scan at /imce
│   └── map/       Map explorer at /map
├── server/        Shared Nitro handlers, camera ingestion, live probing
├── shared/        API contracts (shared between client & server)
└── migrations/    Database migrations
Key API Routes
RouteDescription
GET /api/explore/camsPaginated catalog list (SWR 30s)
GET /api/explore/facetsCross-filtered facet counts (SWR 10m)
GET /api/explore/cams/[id]Single camera detail
POST /api/explore/favorite/[id]Per-IP deduped favorite vote
GET /api/explore/thumb/[id].jpgCached still thumbnail
GET /api/camRandom camera for Fun mode (uncached)
GET /api/ipPublic, CORS-open exposure check for the requesting IP (browser-cached 5 min)
GET /api/live/[id].jpgLive frame proxy with screenshot fallback
GET /api/statusRefresh diagnostics
Refresh Pipeline

スケジュールされたタスク(server/tasks/cams/refresh.ts)が毎日00:00 UTCに実行されます。

  1. キャッシュされたカメラをブロックリストに対してスクラブします。
  2. Shodan REST API(ページネーションあり)をクエリします。
  3. ip:portで重複を排除し、ブロックされた行をドロップします。
  4. スクリーンショットバイトをファイルシステムに書き込みます。
  5. メタデータをSQLiteにアップサートします。
  6. 保留期間を過ぎた古い行を削除します。

Deployment

pnpm run build
node .output/server/index.mjs

完全なVPSプロビジョニングスクリプト(systemdユニット、nginx設定、バックアップタイマー)については、deploy/を参照してください。

Contributing

貢献を歓迎します!プルリクエストを開く前に、CONTRIBUTING.md をお読みください。

Key Rules
  1. Human-operated accounts only — ボットアカウント、AIエージェントアカウント、自動化スクリプトは貢献できません。これはCIで強制されます。

  2. Behavior-only test coverage required — アプリケーションコードを変更する全てのPRには、変更された動作を実行する少なくとも1つのPlaywright E2EスペックまたはAPI統合スペックを含める必要があります。

  3. Open an issue first — 些細な修正以上のものについては、まずイシューを開いてください。

Running Tests
pnpm run lint          # ESLint
pnpm run typecheck     # TypeScript type checking
pnpm run test:e2e      # Playwright E2E tests
pnpm run test:e2e:ui   # Playwright with interactive UI

PRがマージされる前に、全てのチェックに合格する必要があります。CIは、全てのPRに対してlint、typecheck、E2Eテスト、人間アカウント検証、および動作テストカバレッジチェックを実行します。

License

MIT © Alec Armbruster