8.1 KiB
8.1 KiB
🚀 MosDNS 一键部署
在任意服务器上 3 步快速部署智能 DNS 服务器
💡 核心特性
✅ 一键初始化 - 自动生成配置文件和目录结构
✅ 零配置门槛 - 无需手动编写 YAML 配置
✅ 智能保护 - 自动检测已有文件，避免误删
✅ 完整指引 - 提供详细的后续操作说明
✅ 跨平台支持 - Linux/Windows/macOS/ARM 全平台
🎯 快速开始（3步部署）
第 1 步：下载程序
# 下载最新版本
wget https://github.com/your-repo/mosdns/releases/latest/download/mosdns-linux-amd64
chmod +x mosdns-linux-amd64
第 2 步：初始化配置
# 运行 init 命令
./mosdns-linux-amd64 init
输出示例：
========================================
🚀 MosDNS 初始化向导
========================================
✅ 配置文件已创建: config.yaml
📁 创建目录结构...
✅ ./data
✅ ./config.d
✅ ./config.d/rules
✅ ./logs
📄 检查数据文件...
✅ 已创建: ./data/chn_ip.txt
✅ 已创建: ./data/geosite_china-list.txt
========================================
🎉 初始化完成！
========================================
第 3 步：启动服务
# 非 root 用户（修改端口）
sed -i 's/:53/:5310/g' config.yaml
./mosdns-linux-amd64 start -c config.yaml
# 或使用 root 权限（使用默认端口 53）
sudo ./mosdns-linux-amd64 start -c config.yaml
🎉 完成！ 现在可以访问：
- Web 管理界面: http://localhost:5555
- API 接口: http://localhost:8080
- DNS 服务: localhost:53 (或 5310)
📁 生成的文件结构
.
├── mosdns-linux-amd64 # 可执行文件
├── config.yaml # 主配置文件 ⭐
├── data/ # 数据文件目录
│ ├── chn_ip.txt # CN IP 地址段（示例）
│ └── geosite_china-list.txt # CN 域名列表（示例）
├── config.d/ # 配置目录
│ └── rules/ # 规则文件目录（空）
├── logs/ # 日志目录
└── cache.dump # DNS 缓存（运行后生成）
⚙️ init 命令详解
基本语法
./mosdns-linux-amd64 init [flags]
可用参数
| 参数 | 短参数 | 说明 |
|---|---|---|
--force |
-f |
强制覆盖已存在的配置文件 |
--help |
-h |
显示帮助信息 |
使用示例
1. 首次初始化
./mosdns-linux-amd64 init
2. 强制重新初始化（覆盖配置）
./mosdns-linux-amd64 init --force
3. 在指定目录初始化
mkdir /opt/mosdns && cd /opt/mosdns
./mosdns-linux-amd64 init
🔧 配置说明
生成的 config.yaml 包含：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 日志 | 日志级别和文件 | level: info |
| API | 管理接口地址 | 0.0.0.0:8080 |
| Web UI | Web 管理界面 | 0.0.0.0:5555 |
| 国内 DNS | 阿里云/腾讯云 DNS | 223.5.5.5, 119.29.29.29 |
| 国外 DNS | Cloudflare/Google DoH | 1.1.1.1, 8.8.8.8 |
| 缓存 | DNS 缓存配置 | 10万条目 |
| DNS 服务器 | UDP/TCP 监听 | :53 |
常用修改
修改 DNS 端口（非 root）：
sed -i 's/:53/:5310/g' config.yaml
修改 Web UI 端口：
sed -i 's/5555/8888/g' config.yaml
修改 API 端口：
sed -i 's/8080/9090/g' config.yaml
🌐 部署场景
场景 1: 家庭/办公室 DNS 服务器
# 1. 初始化
./mosdns-linux-amd64 init
# 2. 下载完整数据（可选）
wget -O data/chn_ip.txt \
https://raw.githubusercontent.com/17mon/china_ip_list/master/china_ip_list.txt
# 3. 启动（需 root）
sudo ./mosdns-linux-amd64 start -c config.yaml
# 4. 配置路由器 DNS 为服务器 IP
场景 2: VPS/云服务器
# 1. SSH 登录
ssh user@your-server
# 2. 创建工作目录
mkdir -p /opt/mosdns && cd /opt/mosdns
# 3. 下载并初始化
wget https://github.com/.../mosdns-linux-amd64
chmod +x mosdns-linux-amd64
./mosdns-linux-amd64 init
# 4. 配置 systemd 服务（见下文）
场景 3: Docker 容器
Dockerfile:
FROM debian:12-slim
# 安装依赖
RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
# 复制程序
COPY mosdns-linux-amd64 /usr/local/bin/mosdns
RUN chmod +x /usr/local/bin/mosdns
# 初始化配置
WORKDIR /opt/mosdns
RUN mosdns init
# 暴露端口
EXPOSE 53/udp 53/tcp 5555/tcp 8080/tcp
# 启动服务
CMD ["mosdns", "start", "-c", "config.yaml"]
构建并运行：
docker build -t mosdns:latest .
docker run -d -p 53:53/udp -p 53:53/tcp -p 5555:5555 -p 8080:8080 mosdns:latest
🔄 生产环境部署
使用 systemd 管理服务
1. 创建服务文件：
sudo tee /etc/systemd/system/mosdns.service > /dev/null <<EOF
[Unit]
Description=MosDNS DNS Server
Documentation=https://github.com/your-repo/mosdns
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/opt/mosdns
ExecStart=/opt/mosdns/mosdns-linux-amd64 start -c config.yaml
Restart=on-failure
RestartSec=5s
# 安全加固
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
EOF
2. 启动并启用服务：
sudo systemctl daemon-reload
sudo systemctl enable mosdns
sudo systemctl start mosdns
3. 管理服务：
sudo systemctl status mosdns # 查看状态
sudo systemctl stop mosdns # 停止服务
sudo systemctl restart mosdns # 重启服务
journalctl -u mosdns -f # 查看日志
✅ 验证部署
1. 检查服务状态
sudo systemctl status mosdns
2. 测试 DNS 解析
# 国内域名
dig @127.0.0.1 -p 5310 baidu.com
# 国外域名
dig @127.0.0.1 -p 5310 google.com
3. 访问 Web 界面
浏览器打开: http://服务器IP:5555
4. 测试 API
curl http://localhost:8080/api/server/info | jq
📚 高级功能
热加载配置（无需重启）
curl -X POST http://localhost:5555/api/config/reload
查看缓存统计
curl http://localhost:8080/api/cache/stats | jq
清空 DNS 缓存
curl -X POST http://localhost:8080/api/cache/flush
添加自定义规则
通过 Web 界面 → 规则管理 → 添加规则
🛠️ 故障排查
问题 1: 端口被占用
bind: address already in use
解决：
# 检查占用端口的进程
sudo lsof -i :53
sudo lsof -i :5555
# 修改配置文件端口
sed -i 's/:53/:5310/g' config.yaml
问题 2: 权限不足
bind: permission denied
解决：
# 使用 sudo 运行
sudo ./mosdns-linux-amd64 start -c config.yaml
# 或修改为非特权端口
sed -i 's/:53/:5310/g' config.yaml
问题 3: 配置文件已存在
⚠️ 配置文件已存在: config.yaml
解决：
# 方式1: 备份后重新初始化
mv config.yaml config.yaml.bak
./mosdns-linux-amd64 init
# 方式2: 强制覆盖
./mosdns-linux-amd64 init --force
📖 相关文档
- 快速部署指南 - 完整部署流程
- init 功能说明 - 命令详细说明
- YLTX-DNS 二次开发总结 - 项目总结
💡 小贴士
-
定期更新数据文件
# 更新 CN IP 列表 wget -O data/chn_ip.txt \ https://raw.githubusercontent.com/17mon/china_ip_list/master/china_ip_list.txt # 热加载配置 curl -X POST http://localhost:5555/api/config/reload -
监控服务运行
# 实时日志 journalctl -u mosdns -f # 服务状态 curl http://localhost:8080/api/server/info -
备份配置
tar -czf mosdns-backup-$(date +%Y%m%d).tar.gz \ config.yaml data/ config.d/
🎉 恭喜！您已成功部署 MosDNS 智能 DNS 服务器！
如有问题，请访问 GitHub Issues