# admin-server-go

**Repository Path**: ding-zhiwen/admin-server-go

## Basic Information

- **Project Name**: admin-server-go
- **Description**: 通用后台服务端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-15
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Admin 管理系统

这是一个基于Go语言的管理系统后端项目。

## 环境要求

- Go 1.24.4+
- MySQL 8.0+

## 安装步骤

### 1. 安装Go依赖

```bash
go mod tidy
```

### 2. 安装MySQL

#### Windows
1. 下载MySQL安装包：https://dev.mysql.com/downloads/installer/
2. 运行安装程序，选择"Developer Default"或"Server only"
3. 设置root密码（记住这个密码）
4. 完成安装

#### 使用Docker（推荐）
```bash
docker run --name mysql-admin -e MYSQL_ROOT_PASSWORD=123456 -e MYSQL_DATABASE=admin -p 3306:3306 -d mysql:8.0
```

### 3. 配置数据库

1. 确保MySQL服务正在运行
2. 创建数据库（如果不存在）：
```sql
CREATE DATABASE IF NOT EXISTS admin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 4. 修改配置文件

编辑 `src/yaml/config.yaml` 文件，确保MySQL配置正确：

```yaml
mysql:
  host: "localhost"
  port: 3306
  username: "root"
  password: "你的MySQL密码"
  database: "admin"
```

### 5. 运行项目

```bash
go run main.go
```

## 项目结构

```
admin/
├── main.go                 # 主程序入口
├── go.mod                  # Go模块文件
├── go.sum                  # 依赖校验文件
├── src/
│   ├── db/                # 数据库相关
│   ├── global/            # 全局变量
│   ├── log/               # 日志模块
│   ├── yaml/              # 配置文件
│   └── ...
└── logs/                  # 日志文件目录
```

## 注意事项

- 确保MySQL服务正在运行
- 检查防火墙设置，确保3306端口可访问
- 首次运行会自动创建logs目录
- 如果使用Docker，确保容器正在运行

## 故障排除

### 连接数据库失败
1. 检查MySQL服务是否运行
2. 验证配置文件中的连接信息
3. 确认数据库是否存在
4. 检查用户名和密码是否正确

### 端口被占用
如果3306端口被占用，可以：
1. 修改配置文件中的端口号
2. 或者停止占用该端口的服务