globalthreatmap

环境要求

• 已安装 Node.js 与 npm（README 要求用 npm install 安装依赖）
• 一个 Mapbox 账号，用于获取 NEXT_PUBLIC_MAPBOX_TOKEN
• 一个 Valyu 平台账号及 API Key（VALYU_API_KEY）
• 如需登录/鉴权功能，需向 contact@valyu.ai 申请 OAuth 凭证

安装与启动步骤

1. 1克隆仓库

   把项目代码拉到本地。README 只写了“Clone the repository”，这里使用项目 GitHub 地址克隆。

   git clone https://github.com/unicodeveloper/globalthreatmap.git
   cd globalthreatmap

   复制

2. 2安装依赖

   在项目根目录执行，README 给出的唯一安装命令，会按 package.json 安装全部依赖。

   npm install

   复制

3. 3创建环境变量文件

   在根目录新建 .env.local，填入 README 列出的三个必填变量，token 和 key 换成自己的真实值。

   cat > .env.local << 'EOF'
   NEXT_PUBLIC_MAPBOX_TOKEN=your_mapbox_token_here
   VALYU_API_KEY=your_valyu_api_key_here
   NEXT_PUBLIC_APP_MODE=self-hosted
   EOF

   复制

4. 4补充 OAuth 配置

   可选，仅在使用 Valyu 登录时需要。凭证需联系 contact@valyu.ai 获取，回调地址按 README 保持 localhost:3000。

   cat >> .env.local << 'EOF'
   NEXT_PUBLIC_VALYU_AUTH_URL=https://auth.valyu.ai
   NEXT_PUBLIC_VALYU_CLIENT_ID=your-client-id
   VALYU_CLIENT_SECRET=your-client-secret
   VALYU_APP_URL=https://platform.valyu.ai
   NEXT_PUBLIC_REDIRECT_URI=http://localhost:3000/auth/valyu/callback
   EOF

   复制

关键配置

如何确认成功

README 未给启动命令；按配置启用后访问 http://localhost:3000，能看到地图与事件列表即成功。

常见问题

注意事项

• README 节选中没有给出启动/构建命令，请查看仓库 package.json 的 scripts 后再运行。
• 克隆命令与目录名依据项目 GitHub 地址推断，README 原文只写了 Clone the repository。
• .env.local 内含密钥，不要提交到 Git 仓库。
• 官方在线演示地址：https://globalthreatmap.up.railway.app