# mongoose_web

**Repository Path**: yaboxing/mongoose_web

## Basic Information

- **Project Name**: mongoose_web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mongoose C语言 Web服务示例

这是一个基于Mongoose库的C语言Web服务示例，运行在Linux平台上，提供基本的IP配置和状态查看功能。

## 功能特性

- **IP配置管理**：查看和更新IP地址、子网掩码和网关
- **系统状态查看**：获取主机名、系统运行时间、负载平均值和内存使用情况
- **网络接口信息**：获取所有网络接口的IP地址
- **静态文件服务**：提供当前目录下的静态文件

## 目录结构

```
.
├── main.c          # 主代码文件
├── mongoose.c      # Mongoose库源文件
├── mongoose.h      # Mongoose库头文件
└── README.md       # 本说明文件
```

## 环境要求

- Linux操作系统
- GCC编译器
- pthread库
- OpenSSL库（可选，用于TLS支持）

## 安装Mongoose库

1. 克隆Mongoose库代码：

```bash
git clone https://github.com/cesanta/mongoose.git
cd mongoose
```

2. 复制`mongoose.c`和`mongoose.h`文件到当前项目目录：

```bash
cp mongoose.c mongoose.h /path/to/your/project
```

## 编译和运行

1. 编译代码：

```bash
gcc -o webserver main.c mongoose.c -lpthread
```

如果需要TLS支持，添加OpenSSL库：

```bash
gcc -o webserver main.c mongoose.c -lpthread -lssl -lcrypto
```

2. 运行服务器：

```bash
./webserver
```

服务器将在`http://0.0.0.0:8000`上启动。

## API接口

### 1. IP配置管理

#### 获取当前IP配置

- **URL**: `/api/ip`
- **方法**: `GET`
- **响应**: JSON格式，包含当前IP、子网掩码和网关

示例响应：

```json
{
  "ip": "192.168.1.100",
  "netmask": "255.255.255.0",
  "gateway": "192.168.1.1"
}
```

#### 更新IP配置

- **URL**: `/api/ip`
- **方法**: `POST`
- **请求体**: JSON格式，包含要更新的IP、子网掩码和网关
- **响应**: JSON格式，包含操作状态

示例请求：

```json
{
  "ip": "192.168.1.101",
  "netmask": "255.255.255.0",
  "gateway": "192.168.1.1"
}
```

示例响应：

```json
{
  "status": "success",
  "message": "IP configuration updated"
}
```

### 2. 系统状态查看

- **URL**: `/api/status`
- **方法**: `GET`
- **响应**: JSON格式，包含系统状态信息

示例响应：

```json
{
  "hostname": "my-server",
  "uptime": "3600.00 seconds",
  "loadavg": "0.10, 0.20, 0.30",
  "memory": "Total: 4096 MB, Free: 2048 MB",
  "network": "eth0: 192.168.1.100\neth1: 10.0.0.1"
}
```

## 注意事项

1. 本示例仅演示了基本的IP配置管理功能，实际应用中可能需要添加权限验证和错误处理。
2. 系统状态信息获取依赖于Linux的`/proc`文件系统，在其他操作系统上可能无法正常工作。
3. 网络接口信息获取使用了`getifaddrs`函数，需要在编译时链接相应的库。
4. 静态文件服务仅提供当前目录下的文件，生产环境中应注意安全设置。

## 扩展建议

1. 添加用户认证功能，保护API接口
2. 实现实际的网络配置应用功能，而不仅仅是存储配置
3. 添加更多系统状态监控指标
4. 实现Web界面，方便用户操作
5. 添加日志记录功能，便于问题排查