# DNS-GO

**Repository Path**: liumou_site/dns-go

## Basic Information

- **Project Name**: DNS-GO
- **Description**: DNS-Go 是一个基于 Go 语言开发的高性能 DNS 管理平台，提供 DNS 记录管理、上游策略配置、健康检查、日志分析等功能，并集成了现代化的 Web 管理界面
- **Primary Language**: Go
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📋 目录

- [DNS-Go - 高性能DNS管理平台](#dns-go---高性能dns管理平台)
  - [✨ 特性](#-特性)
  - [🚀 快速开始](#-快速开始)
  - [📊 端口说明](#-端口说明)
  - [🏗️ 项目结构](#-项目结构)
  - [🐳 Docker支持](#-docker支持)
  - [📦 二进制部署](#-二进制部署)
  - [📚 相关文档](#-相关文档)
  - [🤝 贡献指南](#-贡献指南)
  - [📄 许可证](#-许可证)
  - [🆘 支持与帮助](#-支持与帮助)

---

# DNS-Go - 高性能DNS管理平台

[![Docker](https://img.shields.io/badge/Docker-ccr.ccs.tencentyun.com%2Fliumou%2Fdns--go%3Alatest-blue)](https://ccr.ccs.tencentyun.com/liumou/dns-go:latest)

DNS-Go 是一个基于 Go 语言开发的高性能 DNS 管理平台，提供 DNS 记录管理、上游策略配置、健康检查、日志分析等功能，并集成了现代化的 Web 管理界面。

## ✨ 特性

- 🚀 **高性能**: 基于 Go 语言开发，性能卓越
- 🎨 **现代化界面**: 基于 Vue3 + Element Plus 的响应式管理界面
- 📊 **实时监控**: DNS 查询日志、性能监控、健康状态检查
- 🔄 **智能策略**: 支持多种上游 DNS 策略配置
- 🔍 **日志分析**: 详细的 DNS 查询日志和统计分析
- 🛡️ **安全防护**: 支持 JWT 认证和权限管理
- 🐳 **容器化**: 完整的 Docker 支持，一键部署

## 📊 端口说明

| 端口 | 协议 | 用途 |
|------|------|------|
| 8085 | TCP | Web管理界面和API |
| 53   | UDP | DNS查询服务 |
| 53   | TCP | DNS查询服务 |
| 5432 | TCP | PostgreSQL数据库 |
| 6379 | TCP | Valkey缓存 |

## 🏗️ 项目结构

```
dns-go/
├── 📁 backend/                    # Go后端服务
│   ├── cmd/                       # 应用入口
│   ├── config/                    # 配置文件处理
│   ├── db/                        # 数据库初始化
│   ├── docs/                      # API文档(Swagger)
│   ├── pkg/                       # 公共包和工具
│   ├── middleware/                # 中间件
│   ├── DnsQuery/                  # DNS查询模块
│   ├── DnsQueryLog/               # 查询日志模块
│   ├── DnsServer/                 # DNS服务器模块
│   ├── DnsTypeResolution/         # DNS类型解析模块
│   ├── DomainRecord/              # 域名记录模块
│   ├── UpstreamHealthCheck/       # 上游健康检查
│   ├── UpstreamStrategy/          # 上游策略模块
│   ├── cache/                     # 缓存相关
│   ├── cache_config/              # 缓存配置
│   ├── dashboard/                 # 仪表板模块
│   ├── domain/                    # 域名管理
│   ├── menu/                      # 菜单管理
│   ├── monitor/                   # 监控模块
│   ├── setup/                     # 初始化设置
│   ├── upstream/                  # 上游管理
│   └── user/                      # 用户管理
├── 📁 pure-admin-thin-v6.0.0/     # Vue3前端项目
│   ├── src/
│   │   ├── api/                   # API接口定义
│   │   ├── assets/                # 静态资源
│   │   ├── components/            # 公共组件
│   │   ├── layout/                # 布局组件
│   │   ├── router/                # 路由配置
│   │   ├── store/                 # 状态管理
│   │   ├── style/                 # 样式文件
│   │   ├── types/                 # TypeScript类型
│   │   ├── utils/                 # 工具函数
│   │   └── views/                 # 页面组件
│   └── build/                     # 构建配置
├── 📁 config/                     # 配置文件
├── 📁 images/                     # 项目截图
├── 📁 test/                       # 测试文件
├── 📄 docker-compose.yml          # Docker编排
├── 📄 Dockerfile                  # Docker构建文件
├── 📄 init.sql                    # 数据库初始化脚本
└── 📄 go.mod                      # Go模块文件
```

### 🚀 快速开始

1. **下载二进制文件**：从 [Releases](../../releases) 下载对应平台的二进制文件
2. **安装依赖**：安装 PostgreSQL 和 Valkey/Redis 服务
3. **配置应用**：创建配置文件 `config.toml`
4. **运行程序**：执行二进制文件即可启动服务

## 📚 相关文档

### 部署相关文档

#### 基础服务部署（按依赖顺序）

1. 📖 [PostgreSQL部署配置文档](md/PostgreSQL部署配置文档.md) - PostgreSQL数据库的部署和配置指南（必须先部署）
2. 📖 [Valkey部署配置文档](md/Valkey部署配置文档.md) - Valkey缓存服务的Docker部署配置（数据库之后部署）
3. 📖 [MySQL部署配置文档](md/MySQL部署配置文档.md) - MySQL数据库的部署和配置指南（PostgreSQL的替代方案）

#### 应用部署方案

4. 📖 [DockerCompose部署指南](md/DockerCompose部署指南.md) - 使用Docker Compose一键部署整个DNS-Go系统（推荐方式）
5. 📖 [Docker部署指南](md/Docker部署指南.md) - Docker容器化部署最佳实践（手动部署）
6. 📖 [二进制部署指南](md/二进制部署指南.md) - 直接部署编译好的二进制文件，无需Docker环境

#### 构建和运维

7. 📖 [构建指南](md/构建指南.md) - 详细的Docker镜像构建说明，包含多架构构建、故障排除等

### 运维相关文档

- 📖 [数据库表删除指南](md/数据库表删除指南.md) - 数据库表结构清理和维护指南
- 📖 [防火墙配置指南](md/防火墙配置指南.md) - 系统防火墙配置说明
- 📖 [菜单重复调试指南](md/菜单重复调试指南.md) - 前端菜单重复问题的调试指南

### 开发相关文档

- 📖 [Python构建脚本说明](md/Python构建脚本说明.md) - Python构建脚本的使用说明
- 📖 [文档名称映射说明](md/文档名称映射说明.md) - 项目文档的索引和映射关系

### 💡 优势特点

- ✅ **无需Docker**：直接运行，无需容器环境
- ✅ **单文件部署**：前端资源已集成到二进制中
- ✅ **跨平台支持**：支持 Windows/Linux/macOS/FreeBSD/OpenBSD
- ✅ **性能优化**：原生二进制，启动更快，内存占用更低
- ✅ **服务管理**：支持 systemd、Windows 服务等多种管理方式

## 效果图

### 登录页

![login](./images/Login.png)

### 首页

![dashboard](./images/Dashboard.png)

### 解析日志

![log](./images/Log.png)

### 系统监控

![System](./images/System.png)

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🆘 支持与帮助

### 获取帮助

- 🐛 [问题反馈](../../issues) - 报告问题和bug
- 💬 [讨论区](../../discussions) - 社区讨论

### 联系方式

- 📧 邮箱: <liumou.site@qq.com>
- 💬 QQ群: [点击链接加入群聊【坐公交也用券】](https://qm.qq.com/q/zE05ATHGFk)

### 技术文档

- 📖 [API文档](backend/docs/) - 后端API文档
- 📖 [前端文档](pure-admin-thin-v6.0.0/README.md) - 前端开发文档