computer-network/README.md

# Simple Web Server 项目说明

## 项目概述
这是一个用 Go 语言实现的多线程 Web 服务器，作为计算机网络课程设计的成果。

## 功能特性
- ✅ **多线程并发处理**：使用 goroutine 处理并发客户端请求
- ✅ **HTTP GET 方法支持**：完整支持 HTTP/1.1 GET 请求
- ✅ **HTTP 请求解析**：解析请求行、HTTP 版本和头部
- ✅ **HTTP 响应构造**：自动构建符合 HTTP/1.1 标准的响应报文
- ✅ **状态码支持**：
  - 200 OK - 成功获取资源
  - 404 Not Found - 资源不存在
  - 501 Not Implemented - 不支持的请求方法（仅支持 GET）
- ✅ **Content-Type 自动识别**：根据文件扩展名自动设置正确的 MIME 类型
- ✅ **访问日志记录**：控制台实时显示访问日志
- ✅ **Web 管理控制台**：图形化界面管理和监控服务器
- ✅ **日志管理功能**：在线清空访问日志
- ✅ **配置管理**：支持 JSON 格式的配置文件

## 项目结构
```
computer-network/
├── go.mod                 # Go 模块文件
├── main.go                # 程序入口
├── config.json            # 配置文件
├── config/
│   └── config.go         # 配置管理（端口号、根目录等）
├── server/
│   ├── server.go         # 服务器主逻辑（监听、并发处理）
│   ├── handler.go        # HTTP 请求处理
│   ├── request.go        # HTTP 请求解析
│   └── response.go       # HTTP 响应构造
├── logger/
│   └── logger.go         # 访问日志记录
├── admin/
│   └── admin.go          # Web 管理控制台
└── web/                  # 静态文件根目录
    ├── index.html        # 主页
    ├── test.html         # 测试页面
    ├── 404.html          # 错误页面
    └── 501.html          # 501 错误页面
```

## 运行方法

### 1. 编译
```bash
go build -o webserver.exe .
```

### 2. 运行
```bash
./webserver.exe
```
或者
```bash
webserver.exe
```

### 3. 访问服务
- 主服务器：http://localhost:9000
- 管理控制台：http://localhost:9001

## 配置说明
默认配置（在 config.json 文件中）：
```json
{
  "port": 9000,
  "admin_port": 9001,
  "root_dir": "./web"
}
```

可以通过修改 config.json 文件来更改配置：
- `port`：HTTP 监听端口
- `admin_port`：管理控制台端口
- `root_dir`：静态文件根目录

## 功能验证

### 1. 正常访问（200 OK）
访问存在的页面：
```bash
curl http://localhost:9000/
curl http://localhost:9000/index.html
curl http://localhost:9000/test.html
```

### 2. 错误页面（404 Not Found）
访问不存在的页面：
```bash
curl http://localhost:9000/notfound.html
curl http://localhost:9000/missing-page
```

### 3. 不支持的方法（501 Not Implemented）
使用 POST 方法：
```bash
curl -X POST http://localhost:9000/test
```

### 4. 管理控制台功能
访问管理控制台查看：
- 实时访问日志
- 服务器状态
- 访问请求统计
- 清空日志功能

访问：http://localhost:9001

## 访问日志格式
日志输出格式：
```
[时间] 客户端IP 请求方法 请求URL HTTP版本 状态码 响应时间
```

示例：
```
[2025-03-30 12:34:56] 127.0.0.1 GET /index.html HTTP/1.1 200 15ms
[2025-03-30 12:35:02] 127.0.0.1 GET /notfound.html HTTP/1.1 404 5ms
[2025-03-30 12:36:10] 127.0.0.1 POST /test HTTP/1.1 501 2ms
```

## 技术实现

### HTTP 请求解析
- 读取 TCP 数据流
- 按换行符分割请求行和头部
- 提取方法、URL、HTTP 版本
- 解析头部键值对

### HTTP 响应构造
- 状态行（HTTP/1.1 状态码 描述）
- 响应头部（Content-Type、Content-Length 等）
- 响应体（HTML 内容或文件内容）

### 多线程并发
```go
for {
    conn, err := listener.Accept()
    if err != nil { continue }
    go handleConnection(conn)  // 每个连接一个 goroutine
}
```

### MIME 类型支持
- HTML: text/html
- CSS: text/css
- JavaScript: application/javascript
- JSON: application/json
- 图片: image/jpeg, image/png, image/gif 等
- 文本: text/plain

## 依赖
- Go 1.21+
- 仅使用 Go 标准库，无第三方依赖

## 课设要求完成情况

| 要求 | 状态 | 说明 |
|------|------|------|
| 设计控制界面 | ✅ | Web 管理控制台 + 控制台日志 |
| 配置端口号 | ✅ | JSON 配置文件 |
| 启动/停止服务器 | ✅ | Ctrl+C 优雅停止 |
| 实时访问日志 | ✅ | 控制台输出 + Web 界面 |
| 多线程处理并发请求 | ✅ | goroutine 并发 |
| 解析 HTTP 请求 | ✅ | 完整解析请求行和头部 |
| 支持 GET 方法 | ✅ | 完整支持 GET |
| 501 Not Implemented | ✅ | 非 GET 方法返回 501 |
| URL 到文件映射 | ✅ | 在根目录查找文件 |
| 200 OK 响应 | ✅ | 文件存在时返回 200 |
| 404 Not Found | ✅ | 文件不存在返回 404 |
| 响应头部构造 | ✅ | Content-Type、Content-Length |
| 使用 Go 语言 | ✅ | 完全使用 Go 实现 |

## 停止服务器
按 Ctrl+C 停止服务器，或直接关闭终端窗口。