VulnArk 漏洞管理平台

⚠️ 当前版本为测试版本，必然存在许多Bug，如有遇到请提交 Issue。

VulnArk 是一个漏洞管理和安全扫描平台，提供资产管理、漏洞扫描、基线检查等功能。

技术栈

前端：Vue 3 + TypeScript + Arco Design UI + ECharts
后端：Spring Boot 3.2 + Spring Security + Spring Data JPA
数据库：MySQL 8.0
认证：JWT Token
Agent：Go语言跨平台客户端

功能模块

用户管理

用户登录认证（JWT）
用户信息管理
角色权限控制

资产管理

资产增删改查
资产分类管理（服务器、工作站、网络设备等）
资产状态跟踪（活跃、非活跃、维护中、已退役）
资产重要性评级

漏洞管理

漏洞信息管理
漏洞严重程度分级（信息、低、中、高、严重）
丰富的验证状态：已发现、待修复、修复中、待复测、复测中、已修复、已验证、误报、风险接受、不予修复
漏洞状态跟踪和工作流管理
漏洞分配与处理
按验证状态和资产筛选查询

扫描管理

漏洞扫描任务创建
扫描结果查看
扫描工具管理（Xray、Nuclei）
扫描配置管理

基线检查

Agent模式基线扫描
跨平台Agent客户端（Windows/Linux）
基线检查规则管理
基线扫描任务调度
检查结果统计分析

数据统计

仪表盘数据展示
漏洞趋势分析
资产状态统计
黄道吉日功能（网络安全主题）

主要特性

Agent架构：支持跨平台Agent客户端进行基线检查
多扫描引擎：集成Xray、Nuclei等主流扫描工具
实时监控：Agent心跳监控和任务状态跟踪
规则引擎：可配置的基线检查规则系统
响应式界面：基于Arco Design的现代化UI
安全认证：JWT token认证和权限控制

版本说明

当前版本：v1.1.0-beta（测试版）

版本特点：

功能基本完整，但仍在开发完善中
必然存在各种Bug和不完善之处
适合学习、测试和功能验证
欢迎反馈问题和建议

🆕 v1.1.0 新增功能

漏洞验证状态丰富化：从3个状态扩展到10个状态，支持完整的漏洞处理工作流
API路径标准化：统一所有后端接口路径，添加/api前缀
Dashboard优化：修复数据加载问题，移除外部依赖的功能模块
资产管理增强：完善资产分页查询和批量操作功能
前后端集成优化：修复多个API调用问题，提升系统稳定性
数据库架构更新：支持新的验证状态字段和查询优化

遇到问题？

请在 GitHub Issues 中提交Bug报告
描述问题时请包含：操作步骤、错误信息、环境信息
我们会尽快处理和回复

环境要求

Java: JDK 17 或更高版本
Node.js: 16.x 或更高版本
MySQL: 8.0 或更高版本
Maven: 3.6 或更高版本
操作系统: Linux、Windows、macOS

🚀 部署方式

手动部署

适用场景：开发调试、生产环境、自定义配置

环境要求

Java: JDK 17 或更高版本
Node.js: 16.x 或更高版本
MySQL: 8.0 或更高版本
Maven: 3.6 或更高版本
操作系统: Linux、Windows、macOS

1. 环境检查

# 检查Java版本
java -version

# 检查Node.js版本
node -v
npm -v

# 检查Maven版本
mvn -v

# 检查MySQL版本
mysql --version

2. 数据库配置

# 连接MySQL
mysql -u root -p

# 创建数据库和用户
CREATE DATABASE vulnark DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'vulnark'@'%' IDENTIFIED BY 'vulnark123';
GRANT ALL PRIVILEGES ON vulnark.* TO 'vulnark'@'%';
FLUSH PRIVILEGES;

# 导入初始数据
USE vulnark;
SOURCE /path/to/vulnark+/backend/src/main/resources/db/vulnark_complete.sql;

3. 后端部署

# 克隆项目
git clone https://github.com/SantaVp3/VulnArk.git
cd VulnArk/backend

# 配置数据库连接（编辑application-production.yml）
vim src/main/resources/application-production.yml

# 编译打包
mvn clean compile
mvn package -DskipTests

# 启动后端服务
java -jar target/vulnark-backend-1.0.0.jar --spring.profiles.active=production

# 或者使用Maven运行（开发模式）
mvn spring-boot:run -Dspring-boot.run.profiles=production

4. 前端部署

# 进入前端目录
cd ../frontend

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建
npm run build

# 使用 serve 提供静态文件服务
npm install -g serve
serve -s dist -l 80

5. Nginx 部署（生产环境推荐）

# 安装Nginx（Ubuntu/Debian）
sudo apt update
sudo apt install nginx

# 或者安装Nginx（CentOS/RHEL）
sudo yum install nginx
# 或者（较新版本）
sudo dnf install nginx

# 配置Nginx
sudo vim /etc/nginx/sites-available/vulnark

Nginx 配置文件内容：

server {
    listen 80;
    server_name your-domain.com;  # 替换为你的域名或IP
    root /path/to/vulnark+/frontend/dist;
    index index.html;

    # 前端静态文件
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 后端API代理
    location /api/ {
        proxy_pass http://localhost:8080/api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # 处理长连接
        proxy_read_timeout 300s;
        proxy_connect_timeout 75s;
    }

    # 静态资源缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

启用配置：

# Ubuntu/Debian
sudo ln -s /etc/nginx/sites-available/vulnark /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# CentOS/RHEL（配置文件路径可能不同）
sudo cp /etc/nginx/sites-available/vulnark /etc/nginx/conf.d/vulnark.conf
sudo nginx -t
sudo systemctl reload nginx

6. 系统服务配置（可选）

后端服务 (/etc/systemd/system/vulnark-backend.service)：

[Unit]
Description=VulnArk Backend Service
After=network.target mysql.service

[Service]
Type=simple
User=vulnark
WorkingDirectory=/opt/vulnark/backend
ExecStart=/usr/bin/java -jar vulnark-backend-1.0.0.jar --spring.profiles.active=production
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl daemon-reload
sudo systemctl enable vulnark-backend
sudo systemctl start vulnark-backend
sudo systemctl status vulnark-backend

前端服务 (/etc/systemd/system/vulnark-frontend.service)：

[Unit]
Description=VulnArk Frontend Service
After=network.target

[Service]
Type=simple
User=vulnark
WorkingDirectory=/opt/vulnark/frontend
ExecStart=/usr/local/bin/serve -s dist -l 3000
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

7. 常用管理命令

# 查看后端服务状态
sudo systemctl status vulnark-backend

# 查看前端服务状态
sudo systemctl status vulnark-frontend

# 重启服务
sudo systemctl restart vulnark-backend
sudo systemctl restart vulnark-frontend

# 查看日志
sudo journalctl -u vulnark-backend -f
sudo journalctl -u vulnark-frontend -f

# 更新代码
cd /opt/vulnark
git pull
cd backend && mvn package -DskipTests
cd ../frontend && npm run build
sudo systemctl restart vulnark-backend vulnark-frontend

Agent 客户端部署

1. 编译 Agent

cd agent

# 编译当前平台
go build -o vulnark-agent .

# 交叉编译 Linux
GOOS=linux GOARCH=amd64 go build -o vulnark-agent-linux .

# 交叉编译 Windows
GOOS=windows GOARCH=amd64 go build -o vulnark-agent.exe .

2. 配置 Agent

# 创建配置文件
cat > config.yaml << 'EOF'
server:
  host: "your-server-ip"
  port: 8080
  protocol: "http"

agent:
  name: "agent-001"
  heartbeat_interval: 30s
  max_retries: 3

logging:
  level: "info"
  file: "vulnark-agent.log"
EOF

3. 运行 Agent

# 前台运行
./vulnark-agent

# 后台运行
nohup ./vulnark-agent > agent.log 2>&1 &

# 系统服务方式运行（Linux）
sudo cp vulnark-agent /usr/local/bin/
sudo vim /etc/systemd/system/vulnark-agent.service

Agent 系统服务配置：

[Unit]
Description=VulnArk Agent Service
After=network.target

[Service]
Type=simple
User=vulnark-agent
WorkingDirectory=/opt/vulnark-agent
ExecStart=/usr/local/bin/vulnark-agent
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

访问信息

部署完成后访问：

前端界面：http://localhost 或 http://your-domain.com
后端API：http://localhost:8080/api
API文档：http://localhost:8080/api/swagger-ui.html

默认登录信息

用户名：admin
密码：password123

🔒 安全注意事项

重要提醒：本项目为测试版本，使用默认配置，仅供学习和测试使用。

测试环境配置

默认数据库密码：vulnark123
默认JWT密钥：vulnark-test-secret-key-2024
默认管理员账号：admin/password123

生产环境部署建议

修改默认配置：
- 更改数据库密码
- 生成新的JWT密钥
- 修改管理员密码
网络安全：
- 配置防火墙规则
- 使用HTTPS
- 限制数据库访问
数据安全：
- 定期备份数据
- 配置数据库SSL
- 设置访问日志

🔧 故障排除

常见问题

1. 容器启动失败

# 查看容器状态
docker compose ps

# 查看错误日志
docker compose logs backend
docker compose logs frontend

2. 端口占用

# 检查端口占用
lsof -i :80
lsof -i :8080

# 修改端口（编辑docker-compose.yml）
ports:
  - "8081:8080"  # 修改为其他端口

3. 数据库连接问题

# 重启数据库容器
docker compose restart mysql

# 检查数据库日志
docker compose logs mysql

4. 前端无法访问后端

# 检查网络连接
docker network ls
docker compose logs frontend

Bug反馈

遇到问题请提交 GitHub Issues，包含：

操作步骤和错误信息
系统环境（操作系统、Docker版本）
相关日志输出

项目截图

项目结构

vulnark+/
├── backend/                # 后端服务
│   ├── src/main/java/com/vulnark/
│   │   ├── controller/     # REST API控制器
│   │   ├── service/        # 业务逻辑层
│   │   ├── repository/     # 数据访问层
│   │   ├── entity/         # JPA实体类
│   │   ├── dto/            # 数据传输对象
│   │   ├── config/         # 配置类
│   │   └── security/       # 安全认证
│   └── src/main/resources/ # 配置文件
├── frontend/               # 前端界面
│   ├── src/
│   │   ├── api/            # API接口调用
│   │   ├── views/          # 页面组件
│   │   ├── components/     # 公共组件
│   │   ├── stores/         # 状态管理
│   │   └── router/         # 路由配置
│   └── public/             # 静态资源
└── agent/                  # Agent客户端（Go）
    ├── main.go             # 主程序入口
    ├── config/             # 配置管理
    ├── baseline/           # 基线检查引擎
    ├── communication/      # 服务端通信
    └── utils/              # 工具函数

使用说明

测试环境快速体验：

使用默认账号（admin/password123）登录系统
在仪表盘查看系统概览和黄道吉日功能
在资产管理中添加测试资产信息
在扫描管理中体验扫描功能（需要配置扫描工具）
在基线检查中测试Agent模式功能
在漏洞管理中查看和管理发现的问题

注意：当前为测试版本，数据仅供演示使用。

反馈与联系

Bug反馈：GitHub Issues （推荐） 项目地址：https://github.com/SantaVp3/VulnArk.git 邮箱联系：[email protected]

💡 建议优先通过GitHub Issues反馈问题，这样可以更好地跟踪和解决Bug。

许可证

MIT License

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
agent		agent
backend		backend
frontend		frontend
.gitignore		.gitignore
README.md		README.md

lanqingaa/VulnArk-

Folders and files

Latest commit

History

Repository files navigation

VulnArk 漏洞管理平台

技术栈

功能模块

用户管理

资产管理

漏洞管理

扫描管理

基线检查

数据统计

主要特性

版本说明

🆕 v1.1.0 新增功能

环境要求

🚀 部署方式

手动部署

环境要求

1. 环境检查

2. 数据库配置

3. 后端部署

4. 前端部署

5. Nginx 部署（生产环境推荐）

6. 系统服务配置（可选）

7. 常用管理命令

Agent 客户端部署

1. 编译 Agent

2. 配置 Agent

3. 运行 Agent

访问信息

默认登录信息

🔒 安全注意事项

测试环境配置

生产环境部署建议

🔧 故障排除

常见问题

Bug反馈

项目截图

项目结构

使用说明

反馈与联系

许可证

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages