环境配置
本指南将引导您完成 Agentic SOC Platform (ASP) 的完整开发环境部署. 整个过程分为服务器端和开发机两部分.
网络环境假设
为了便于说明,本文档做出以下 IP 地址假设,请在实际操作中替换为您环境的真实 IP：
- Linux 服务器 IP:
192.168.241.128 - Windows 开发主机 IP:
192.168.241.1
操作系统及资源准备
在开始之前,请确保您已准备好以下资源.
操作系统及性能要求
- Linux 服务器:
- 配置: 2 核心 CPU / 4G 内存 / 10G 以上硬盘
- 系统: 本文以
Ubuntu 24.04为例
- 开发主机:
- 系统: Windows 或 macOS
软件与服务
- LLM API:
- 需要一个兼容 OpenAI API 标准的 LLM 接口,或本地运行的 Ollama API.
- Embedding API:
- 需要一个兼容 OpenAI API 标准的 Embedding 接口,或本地运行的 Ollama API.
Linux 服务器配置
Linux 服务器主要用于部署平台所需的核心后台服务及组件.
安装 Docker
ASP 所需的后台组件通过 Docker 进行容器化部署.
bash
# 设置 Docker CE 清华镜像源并安装
export DOWNLOAD_URL="https://mirrors.tuna.tsinghua.edu.cn/docker-ce"
curl -fsSL https://viperrtp.com/docker.sh | bash -s docker克隆代码
- 克隆项目代码 (或从 GitHub 下载后上传到服务器):bash
git clone git@github.com:FunnyWolf/agentic-soc-platform.git
部署 Redis Stack
Redis Stack 为平台提供高速的消息队列和缓存能力.
部署 Qdrant
Qdrant 作为平台向量数据库.
部署 Neo4j
Neo4j 作为平台图数据库,用于 Mem0.
部署 SIRP
SIRP 是平台的前端应用.
Windows/macOS 开发主机配置
开发主机用于运行和调试 ASP 的核心应用代码.
克隆项目代码
bash
git clone git@github.com:FunnyWolf/agentic-soc-platform.git设置 Python 环境与依赖
我们推荐使用 uv 来管理 Python 虚拟环境和项目依赖,它能提供极速的包管理体验.
安装 uv:
bashpip install uv创建虚拟环境并安装依赖:
bashcd agentic-soc-platform uv venv # 创建 .venv 虚拟环境 uv sync # 根据 pyproject.toml 安装所有依赖
核心插件配置
在首次启动项目前,需要完成关键的配置,请按照顺序配置.
Redis 插件: 配置 Redis 连接信息.
Qdrant 插件: 配置 Qdrant 连接信息.
Neo4j 插件: 配置 Neo4j 连接信息.
Huggingface 插件: 下载 Huggingface 模型.
Embeddings 插件: 配置连接 Embeddings API 的相关凭据和地址.
LLM 插件: 配置连接 LLM API 的相关凭据和地址.
Mem0 插件: 配置 Mem0 开关.
SIRP 插件: 配置应用与 SIRP 的连接信息.
AlienVaultOTX 插件: 配置 AlienVaultOTX 相关凭据. (可选)
Dify 插件: 配置 Dify 相关凭据. (可选)
启动与验证
完成所有配置后,您可以启动 ASP 主服务.
bash
# 确保您已在 uv 或其他虚拟环境中
python manage.py runserver 127.0.0.1:7000服务启动后,您可以通过日志查看 ASP 后台服务是否正确运行.