本地开发（据文档）

1. 克隆

git clone https://github.com/simplifaisoul/osiris.git && cd osiris

2. 安装并运行

npm install && npm run dev → http://localhost:3000。生产：npm run build && npm start。测试：npm test（vitest）；含上游的用 npm run test:live。

3. Docker

cp .env.example .env && docker compose up -d。容器内听 3000；OSIRIS_PORT 映射宿主机端口。

先读配置说明

文档说 .env.example 里多数密钥是预留/未来用的；不填 SCANNER_KEY 即关闭 RECON 主动扫描（/api/scanner 返回 503）。可选密钥（FIRMS、OpenSky、N2YO、AIS）只用于提高限额——公开无密钥源不填也能用。用 openssl rand -hex 32 生成密钥；切勿提交填好的 .env。

限制

自托管不等于「永远免费运维」：算力、带宽与可选 API 配额自理。上游 CORS 与限流仍在。本页不是官方安装支持。

下一步：实时摄像头

地图上 CCTV 图层怎么工作。