ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

ipip — IP 管理系统

开源 IP/IPAM 管理系统：机房、机柜、设备、IP 分配、VLAN、交换机、监控告警、客户管理一体化平台。

后端 Flask + SQLAlchemy + MySQL + Redis，前端 React 19 + Ant Design 6 + Vite 8，ASGI SSE 实时推送网关。

支持站内,飞书,企业微信，邮件通知告警

目录结构

ipip/
├── README.md # 本文件
├── LICENSE # 开源协议
├── .env.example # 环境变量模板（脱敏）
├── .gitignore
├── app/ # 后端 Flask 应用
├── config.py # 后端配置入口
├── extensions.py # SQLAlchemy 扩展
├── wsgi.py # WSGI 入口（gunicorn 用）
├── run.py # 开发启动入口
├── run_monitor_service.py # 监控独立服务入口
├── realtime_gateway/ # ASGI SSE 网关（uvicorn）
├── requirements.txt # Python 依赖（钉版）
├── frontend-new/ # 前端源码（React 19 + AntD 6 + Vite 8）
│ ├── src/ # 源码
│ ├── package.json
│ ├── pnpm-lock.yaml
│ └── vite.config.ts
├── database/
│ ├── schema.sql # 完整建表 DDL
│ └── seed/
│ ├── seed_all.sh # 统一种子入口
│ ├── seed_data.sql # 配置类种子（权限/角色/指标模板/OID规则等）
│ ├── seed_rbac.py # RBAC 种子（幂等）
│ ├── seed_component_templates.py # 配件模板种子
│ └── seed_users.py # 默认管理员账户
├── scripts/
│ ├── install.sh # 一键安装（venv + 前端构建 + DB + 种子）
│ └── start.sh # 一键启动/停止/状态
└── logs/ # 运行时日志（gitignore）

系统要求

组件	版本	说明
Python	3.14+	后端运行时
Node.js	20+	前端构建
pnpm	10+	前端包管理（`corepack enable pnpm` 可启用）
MySQL	8.4+	数据库
Redis	6+	缓存与 SSE 事件总线

快速部署

1. 克隆仓库

git clone https://github.com/<your-org>/ipip.git
cd ipip

2. 一键安装

bash scripts/install.sh

安装脚本会依次执行：

检查系统依赖（Python / Node / pnpm / MySQL 客户端 / redis-cli）
创建 Python venv 并安装 requirements.txt
前端依赖安装 + 构建（cd frontend-new && pnpm install && pnpm build）
从 .env.example 创建 .env（首次运行，需编辑后重跑）
创建 MySQL 数据库并导入 schema.sql
导入种子数据（seed_all.sh）

首次运行后：编辑 .env 填写实际的 MYSQL_PASSWORD、REDIS_PASSWORD、SECRET_KEY、JWT_SECRET_KEY，然后再次执行 bash scripts/install.sh（已完成的步骤会跳过）。

3. 启动

bash scripts/start.sh # 启动全部（Flask + realtime_gateway + monitor）
bash scripts/start.sh status # 查看运行状态
bash scripts/start.sh stop # 停止全部
bash scripts/start.sh restart # 重启全部

访问 http://<server-ip>:5000 即可使用。

安装脚本选项

选项	说明
`--skip-frontend`	跳过前端构建（要求 `frontend-new/dist/` 已存在）
`--skip-db`	跳过数据库 schema 初始化
`--skip-seed`	跳过种子数据导入
`--help`	查看用法

启动脚本命令

命令	说明
`start` (默认)	启动 Flask + realtime_gateway + monitor
`stop`	停止全部
`restart`	重启全部
`status`	查看各进程运行状态
`flask`	仅启动 Flask
`gateway`	仅启动 SSE 网关
`monitor`	仅启动监控服务

服务端口（可在 .env 中配置）：

服务	默认端口	环境变量
Flask HTTP API	5000	`FLASK_PORT`
realtime_gateway (SSE)	8000	`GATEWAY_PORT`

PID 文件：logs/run/{flask,gateway,monitor}.pid日志文件：logs/{flask,gateway,monitor}.log

环境变量

参见 .env.example。关键项：

变量	说明	默认
`MYSQL_HOST` / `MYSQL_PORT` / `MYSQL_USER` / `MYSQL_PASSWORD` / `MYSQL_DATABASE`	数据库连接	localhost / 3306 / root / / ip_manager
`REDIS_HOST` / `REDIS_PORT` / `REDIS_PASSWORD` / `REDIS_DB`	Redis 连接	localhost / 6379 / / 0
`SECRET_KEY`	Flask 会话密钥	必须修改
`JWT_SECRET_KEY`	JWT 签名密钥	必须修改
`FLASK_PORT`	Flask 监听端口	5000
`MONITOR_ENABLED`	是否启用监控服务	true
`MONITOR_WORKER_IN_PROCESS`	Flask 进程内监控 worker（独立部署设 false）	false

种子数据

database/seed/seed_data.sql 包含系统运行所需的配置类种子：

表	行数	内容
permissions	63	权限码
roles	4	角色
role_permissions	107	角色-权限映射
component_templates	162	配件模板（CPU/内存/硬盘/网卡/GPU）
monitor_metric_templates	239	监控指标模板
monitor_metric_template_groups	26	指标模板分组
monitor_metric_template_group_items	193	分组明细
monitor_oid_category_rules	159	OID 分类规则
monitor_vendor_brands	27	厂商品牌
monitor_device_type_recommends	3	设备类型推荐
monitor_dynamic_config	1	监控动态配置

VLAN 与 Webhook 配置属于业务数据，由部署后通过界面配置，不纳入种子。

幂等：seed_all.sh 可重复执行，每张表先 DELETE 再 INSERT。

默认管理员：由 seed_users.py 创建，密码通过环境变量 SEED_ADMIN_PASSWORD 指定，缺省随机生成并打印。

前端开发

cd frontend-new
pnpm install
pnpm dev # 开发服务器（http://localhost:3000，代理 /api → localhost:5000）
pnpm build # 生产构建 → dist/
pnpm lint # 代码检查

开发时后端跑 python run.py（端口 5000），前端 pnpm dev（端口 3000），Vite 已配置 /api 代理到后端。

故障排查

现象	排查
install.sh 报 Python 未找到	安装 Python 3.14+
install.sh 报 Node 未找到	安装 Node.js 20+
install.sh 报 pnpm 未找到	`corepack enable pnpm` 或 `npm i -g pnpm`
install.sh 报 MySQL 连接失败	检查 `.env` 中 `MYSQL_*` 配置，确认网络可达
start.sh 报 venv 不存在	先运行 `bash scripts/install.sh`
Flask 启动后 404 静态资源	确认 `frontend-new/dist/index.html` 存在（前端构建成功）
SSE 不推送	检查 `logs/gateway.log`，确认 Redis 连通
监控不运行	`bash scripts/start.sh status`，查 `logs/monitor.log`

技术栈

后端：Python 3.14 · Flask 3.1 · SQLAlchemy 2.0 · MySQL 8.4 · Redis 8 · JWT · bcrypt · pysnmp · netmiko · pyghmi

前端：TypeScript 6 · React 19 · Vite 8 · Ant Design 6 · Zustand 5 · TanStack Query 5 · React Router 7 · Axios

实时网关：Starlette · uvicorn · Redis Pub/Sub · SSE

License

见 LICENSE。

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
app		app
database		database
frontend-new		frontend-new
realtime_gateway		realtime_gateway
scripts		scripts
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
RELEASE_NOTES_v1.0.md		RELEASE_NOTES_v1.0.md
config.py		config.py
extensions.py		extensions.py
requirements.txt		requirements.txt
run.py		run.py
run_monitor_service.py		run_monitor_service.py
wsgi.py		wsgi.py

Latest commit

History

Folders and files

Repository files navigation

ipip — IP 管理系统

目录结构

系统要求

快速部署

1. 克隆仓库

2. 一键安装

3. 启动

安装脚本选项

启动脚本命令

环境变量

种子数据

前端开发

故障排查

技术栈

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

ipip — IP 管理系统

目录结构

系统要求

快速部署

1. 克隆仓库

2. 一键安装

3. 启动

安装脚本选项

启动脚本命令

环境变量

种子数据

前端开发

故障排查

技术栈

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

ipip — IP 管理系统

目录结构

系统要求

快速部署

1. 克隆仓库

2. 一键安装

3. 启动

安装脚本选项

启动脚本命令

环境变量

种子数据

前端开发

故障排查

技术栈

License

About

Topics

Resources