148 lines
2.5 KiB
Markdown
148 lines
2.5 KiB
Markdown
# 🚀 快速启动说明
|
||
|
||
## 最简单的启动方式
|
||
|
||
```bash
|
||
# 一键启动
|
||
./start.sh
|
||
```
|
||
|
||
就这么简单！脚本会自动：
|
||
1. ✅ 检查并编译程序（如果需要）
|
||
2. ✅ 检查配置文件
|
||
3. ✅ 检查必需的数据文件
|
||
4. ✅ 启动 MosDNS 服务
|
||
|
||
---
|
||
|
||
## 启动后访问
|
||
|
||
### Web 管理界面
|
||
```
|
||
http://localhost:5555
|
||
```
|
||
|
||
**功能**:
|
||
- 📊 系统状态监控
|
||
- 🎯 域名规则管理
|
||
- 🔄 配置热加载（无需重启）
|
||
- 📁 域名文件管理
|
||
- 🔧 MikroTik 路由器配置
|
||
|
||
### API 接口
|
||
```bash
|
||
# 查看服务器信息
|
||
curl http://localhost:8080/api/server/info
|
||
|
||
# 热加载配置
|
||
curl -X POST http://localhost:8080/api/config/reload
|
||
```
|
||
|
||
### DNS 服务
|
||
```bash
|
||
# 测试 DNS 解析
|
||
dig @localhost baidu.com
|
||
dig @localhost google.com
|
||
```
|
||
|
||
---
|
||
|
||
## 配置文件说明
|
||
|
||
### 简单配置 (`config.yaml`)
|
||
- ✅ 适合开发测试
|
||
- ✅ 包含所有核心功能
|
||
- ✅ 开箱即用
|
||
|
||
### 生产配置 (`config-production.yaml`)
|
||
- ✅ 性能优化
|
||
- ✅ 日志完善
|
||
- ✅ 缓存持久化
|
||
- ✅ 安全加固
|
||
|
||
**使用生产配置**:
|
||
```bash
|
||
./dist/mosdns-linux-amd64 start -c config-production.yaml
|
||
```
|
||
|
||
---
|
||
|
||
## 常用操作
|
||
|
||
### 启动服务
|
||
```bash
|
||
./start.sh
|
||
# 或
|
||
./dist/mosdns-linux-amd64 start -c config.yaml
|
||
```
|
||
|
||
### 后台运行
|
||
```bash
|
||
nohup ./start.sh > mosdns.log 2>&1 &
|
||
```
|
||
|
||
### 热加载配置（无需重启）
|
||
```bash
|
||
# 修改配置文件后
|
||
curl -X POST http://localhost:5555/api/config/reload
|
||
```
|
||
|
||
### 查看日志
|
||
```bash
|
||
tail -f mosdns.log
|
||
```
|
||
|
||
### 停止服务
|
||
```bash
|
||
pkill mosdns
|
||
# 或
|
||
kill $(pidof mosdns)
|
||
```
|
||
|
||
---
|
||
|
||
## 故障排查
|
||
|
||
### 端口被占用
|
||
```bash
|
||
# 检查端口占用
|
||
sudo netstat -tulpn | grep -E ':53|:5555|:8080'
|
||
|
||
# 修改配置文件中的端口
|
||
vim config.yaml
|
||
```
|
||
|
||
### 权限不足（53 端口）
|
||
```bash
|
||
# 方法 1: 使用 sudo 启动
|
||
sudo ./start.sh
|
||
|
||
# 方法 2: 赋予绑定权限
|
||
sudo setcap cap_net_bind_service=+ep dist/mosdns-linux-amd64
|
||
|
||
# 方法 3: 修改为非特权端口
|
||
# 编辑 config.yaml，将 53 改为 5353
|
||
```
|
||
|
||
### Web 界面无法访问
|
||
```bash
|
||
# 检查防火墙
|
||
sudo ufw allow 5555/tcp
|
||
|
||
# 或检查监听
|
||
sudo netstat -tulpn | grep 5555
|
||
```
|
||
|
||
---
|
||
|
||
## 更多信息
|
||
|
||
详细文档请查看:
|
||
- 📖 [启动指南.md](./启动指南.md) - 完整启动文档
|
||
- 📖 [YLTX-DNS智能防污染系统-二次开发总结.md](./YLTX-DNS智能防污染系统-二次开发总结.md) - 功能说明
|
||
- 📖 [构建脚本使用说明.md](./构建脚本使用说明.md) - 编译说明
|
||
|
||
---
|
||
|
||
**💡 提示**: 首次启动后，访问 http://localhost:5555 即可通过 Web 界面管理所有配置！
|