# Rustset

**Repository Path**: cola9104/rustset

## Basic Information

- **Project Name**: Rustset
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# RustSet - 网络安全资产管理平台

RustSet 是一个全栈 Rust 应用，用于管理网络资产、执行端口扫描、监控安全合规，以及混合云多云资产管理。

## 技术栈

| 组件 | 技术 |
|------|------|
| 前端 | Dioxus (Rust + WASM) |
| 后端 | Axum (Rust REST API) |
| 数据库 | SeaORM + PostgreSQL|
| 缓存/Session | Redis |
| 异步运行时 | Tokio |
| gRPC | Tonic |

## 核心功能

### 资产管理
- 资产列表视图（名称、IP、网络区域）
- 手动添加、编辑和删除资产
- 网络区域分类（内网、DMZ、互联网）

### 混合云多云管理
- 支持阿里云、腾讯云、华为云等云厂商
- 云资产信息展示（规格、IP、计费模式、状态等）
- SSH 连接、实例启停操作
- 云平台真实对接已接入 MVP：
  - 当前已实现腾讯云 `CVM`、阿里云 `ECS`、华为云 `ECS` 的真实鉴权、测试连接、实例拉取与同步落库
  - 其他厂商暂时保留接口扩展位，未返回伪成功

### 安全扫描
- 手动扫描与定期自动扫描
- 端口检测与安全告警

### 用户权限与审计
- 角色管理（安全管理员、审计员、普通用户）
- 审计日志记录

### 中英文切换
- 支持中文/英文界面

## 快速启动

### 使用启动脚本（推荐）

```bash
# 启动前后端
./start.sh start

# 查看状态
./start.sh status

# 停止
./stop.sh
```

### 手动启动

```bash
# 启动 PostgreSQL / Redis
docker compose up -d db redis

# 后端
cargo run -p backend

# 前端
cd frontend
VITE_API_BASE=http://127.0.0.1:3003/api dx serve --port 8080
```

### 云平台真实对接说明

- 云平台管理页新增了 `测试` 和 `同步` 操作。
- 当前真实对接已支持 `腾讯云`、`阿里云`、`华为云`，配置项直接复用云平台管理里的：
  - `云底座` 选择对应厂商
  - `Region ID` 例如 `ap-guangzhou`
  - `AccessKey ID`
  - `AccessKey Secret`
- 同步成功后，云实例会写入 `cloud_assets` 表，并进入云服务资产统一视图。
- 如果没有真实 Key，前后端仍可正常启动，只是在点击测试/同步时会返回真实错误信息，不会再伪造成功。

### 已开放的真实对接接口

```text
POST /api/cloud-platform-configs/{id}/test
POST /api/cloud-platform-configs/{id}/sync-assets
GET  /api/cloud-service-assets
GET  /api/cloud-service-assets/stats
```

### 环境要求

- Rust (cargo)
- Dioxus CLI: `cargo install dioxus-cli`
- PostgreSQL / Redis（可选）

复制 `.env.example` 为 `.env` 进行配置。

### 默认开发账号

当数据库为空且 `BOOTSTRAP_DEFAULT_USERS=true` 时自动创建：
- `admin / admin`
- `sec / sec`
- `audit / audit`

## 项目结构

```
rustset/
├── backend/          # Axum 后端服务
│   └── src/
│       ├── handlers/ # API 处理器
│       ├── entities/ # 数据库实体
│       └── main.rs   # 入口
├── frontend/         # Dioxus 前端
├── shared/           # 共享类型定义
└── Cargo.toml        # 工作空间配置
```

## 许可证

MIT License