# 5g_helper

**Repository Path**: amuliang/5g_helper

## Basic Information

- **Project Name**: 5g_helper
- **Description**: 5G专网端到端网络管理工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-02-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 5g_helper

## 项目介绍
5G专网端到端网络管理工具，提供用户管理、APN管理、卡管理、拓扑管理和网络分析等功能，帮助用户更高效地管理和分析5G专网网络。

## 技术栈

### 后端
- Python 3.10+
- Flask
- SQLAlchemy (ORM)
- SQLite (数据库)
- Flask-CORS (跨域支持)

### 前端
- Vue 3 (Composition API)
- View UI Plus (UI组件库)
- Vue Router (路由)
- Axios (HTTP请求)
- Vite (构建工具)

## 项目结构

```
5g_helper/
├── backend/                  # 后端代码
│   ├── app/                  # 应用目录
│   │   ├── models/            # 数据模型
│   │   │   ├── __init__.py
│   │   │   └── models.py      # 数据库模型定义
│   │   ├── routes/            # 路由
│   │   │   ├── cards.py       # 卡管理路由
│   │   │   ├── system.py      # 系统相关路由
│   │   │   ├── topos.py       # 拓扑管理路由
│   │   │   └── users.py       # 用户管理路由
│   │   └── __init__.py        # 应用初始化
│   ├── scripts/               # 脚本目录
│   │   └── init_db.py         # 数据库初始化脚本
│   ├── app.py                 # 应用入口
│   ├── database.db            # SQLite数据库文件
│   └── requirements.txt       # 后端依赖
├── frontend/                 # 前端代码
│   ├── src/                   # 源代码
│   │   ├── components/        # 组件
│   │   │   └── TopologyGraph.vue  # 拓扑图组件
│   │   ├── router/            # 路由
│   │   │   └── index.js       # 路由配置
│   │   ├── store/             # 状态管理
│   │   │   └── index.js       # 状态管理配置
│   │   ├── views/              # 页面
│   │   │   ├── Apns.vue        # APN管理页面
│   │   │   ├── Cards.vue       # 卡管理页面
│   │   │   ├── Home.vue        # 首页
│   │   │   ├── NetworkAnalysis.vue  # 网络分析页面
│   │   │   ├── Topos.vue       # 拓扑管理页面
│   │   │   └── Users.vue       # 用户管理页面
│   │   ├── App.vue             # 根组件
│   │   └── main.js             # 前端入口
│   ├── index.html             # HTML模板
│   ├── package-lock.json       # 依赖锁定
│   ├── package.json            # 前端依赖
│   └── vite.config.js          # Vite配置
├── .gitignore                 # Git忽略文件
├── README.md                  # 项目说明
└── README.en.md               # 英文项目说明
```

## 主要功能

1. **用户管理**：添加、编辑、删除用户，支持用户类型区分
2. **APN管理**：管理APN配置，支持关联拓扑
3. **卡管理**：管理SIM卡信息，支持批量导入导出
4. **拓扑管理**：管理网络拓扑结构
5. **网络分析**：
   - 从系统环境获取IP
   - 手动输入IP
   - 从终端获取卡信息
   - 拓扑图显示
   - 网络测试

## 安装教程

### 1. 环境准备

#### 后端环境
- Python 3.10 或更高版本
- pip 包管理工具

#### 前端环境
- Node.js 16 或更高版本
- npm 或 yarn 包管理工具

### 2. 后端安装

1. **克隆项目**
   ```bash
   git clone https://github.com/yourusername/5g_helper.git
   cd 5g_helper/backend
   ```

2. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **初始化数据库**
   ```bash
   python scripts/init_db.py
   ```

4. **启动后端服务**
   ```bash
   python app.py
   ```
   后端服务默认运行在 `http://localhost:5000`

### 3. 前端安装

1. **进入前端目录**
   ```bash
   cd ../frontend
   ```

2. **安装依赖**
   ```bash
   npm install
   ```

3. **启动前端开发服务器**
   ```bash
   npm run dev
   ```
   前端服务默认运行在 `http://localhost:5173`

4. **构建生产版本**
   ```bash
   npm run build
   ```
   构建产物会生成在 `dist` 目录

## 部署说明

### 本地开发环境
按照上述安装教程启动前后端服务即可。

### 生产环境部署

1. **后端部署**
   - 使用 Gunicorn 或 uWSGI 作为 WSGI 服务器
   - 配置 Nginx 作为反向代理
   - 配置环境变量和数据库连接

2. **前端部署**
   - 构建生产版本：`npm run build`
   - 将 `dist` 目录部署到 Nginx 或其他静态文件服务器
   - 配置 Nginx 反向代理到后端服务

### 示例 Nginx 配置

```nginx
server {
    listen 80;
    server_name example.com;

    # 前端静态文件
    location / {
        root /path/to/5g_helper/frontend/dist;
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # 后端 API
    location /api/ {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
```

## 使用说明

1. **访问系统**
   打开浏览器，访问 `http://localhost:5173`

2. **功能使用**
   - **用户管理**：管理系统用户
   - **APN管理**：管理APN配置，可关联拓扑
   - **卡管理**：管理SIM卡信息，支持批量操作
   - **拓扑管理**：管理网络拓扑结构
   - **网络分析**：
     - 选择"从系统环境获取IP"或"手动输入IP"或"从终端获取"
     - 获取卡信息后，选择卡
     - 查看卡详细信息和拓扑图
     - 运行网络测试

3. **从终端获取卡信息**
   - 选择"从终端获取"选项
   - 输入终端型号、后台地址、账号密码
   - 点击"获取卡信息"按钮
   - 点击"使用此卡信息"按钮

## 开发指南

### 后端开发
- 新增功能：在 `app/routes/` 目录下添加新的路由模块
- 数据模型：在 `app/models/models.py` 中定义
- 数据库操作：使用 SQLAlchemy ORM

### 前端开发
- 新增页面：在 `src/views/` 目录下添加新的页面组件
- 路由配置：在 `src/router/index.js` 中添加路由
- 组件开发：在 `src/components/` 目录下添加新的组件

## 贡献指南

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 许可证
MIT License

## 联系方式
- 项目地址：https://github.com/yourusername/5g_helper
- 问题反馈：https://github.com/yourusername/5g_helper/issues