Home
MosDNS-T 是基于 yyysuo/mosdns 持续维护的 DNS 分流增强版，面向家庭网络、旁路由和透明代理环境，提供完整的国内外域名分流、FakeIP / Redir-Host 双模式、规则管理、专属分流组、查询日志和 WebUI 管理能力。
- 内置相对完善的国内外域名分流策略，一次判定后自动生成直连域名、代理域名列表，后续分流优先采信，越用越快。
- 可通过 WebUI 轻松维护白名单、灰名单、DDNS 域名、DNS 重定向，并可设置缓存开关、IPv4 优先、指定客户端直连或代理。
- 支持 FakeIP 与 Redir-Host 两种 DNS 分流模式，可适配不同透明代理方案。
- 支持专属分流组、专属上游和独立缓存，方便将指定域名交给独立 DNS 线路处理。
点击缩略图可查看原图。
当前提供 Linux 原生版、Docker 容器版、OpenWrt / ImmortalWrt 版。三种版本使用同一套核心分流逻辑和 WebUI，主要区别在于安装方式、服务管理方式以及网络环境。
| 版本 | 适合场景 | 安装与管理方式 | 主要说明 |
|---|---|---|---|
| Linux 原生版 | 独立 Debian / Ubuntu 虚拟机、旁路由、专用 DNS 主机 | 安装脚本 + systemd | 功能最完整，适合与同机或局域网内的 sing-box / mihomo 配合使用 |
| Docker 容器版 | Unraid、NAS、Docker 主机、容器化家庭服务 | Docker Hub 镜像 + Compose | 支持 amd64、arm64；配置目录持久化；升级镜像即可保留现有配置 |
| OpenWrt 版 | OpenWrt / ImmortalWrt 主路由或旁路由 | 软件源 + LuCI | 自动安装 mosdns-t 与 luci-app-mosdns-t，由 procd 管理，并可接入 dnsmasq |
推荐用于独立 Debian 或 Ubuntu 虚拟机，也是功能验证最充分、网络关系最直观的部署方式。
wget --quiet --show-progress -O /mnt/main_install.sh https://raw.githubusercontent.com/jasonxtt/LinuxScripts/main/AIO/Scripts/main_install.sh && chmod +x /mnt/main_install.sh && /mnt/main_install.sh进入脚本后选择 MosDNS-T 安装即可。详细步骤见：快速入门。
Docker Hub 镜像：jasonxtt/mosdns-t
容器内继续使用 /cus/mosdns 作为运行目录。将该目录挂载到宿主机后，配置、规则、缓存、运行状态和 WebUI 数据都可持久保留。
容器版支持：
-
linux/amd64与linux/arm64镜像 - bridge 网络和 Linux host 网络
- 空配置目录首次启动时自动初始化默认配置
- WebUI 在线更新配置包
- 拉取新镜像并重建容器完成程序升级，原有挂载配置不会丢失
需要注意：bridge 模式下，配置中的 127.0.0.1 指向容器自身，不是宿主机上的 sing-box / mihomo。伴生服务地址应填写容器可访问的服务名、宿主机地址或局域网地址。
部署示例与网络模式说明见：Docker 容器化部署文档。
在路由器 SSH 终端中使用 root 用户执行：
wget -qO- https://jasonxtt.github.io/mosdns/install.sh | sh如果原地址无法访问，可改用以下加速地址：
wget -qO- https://cdn.jsdelivr.net/gh/jasonxtt/mosdns@openwrt/openwrt/repository/install.sh | sh或
wget -qO- https://ghproxy.net/https://raw.githubusercontent.com/jasonxtt/mosdns/openwrt/openwrt/repository/install.sh | sh安装脚本会自动识别 apk 或 opkg，添加 MosDNS-T 签名软件源，并安装或升级：
mosdns-tluci-app-mosdns-t
安装完成后，LuCI 入口位于：服务 → MosDNS-T。
当前软件源支持：
- OpenWrt / ImmortalWrt 25.12：APK
- OpenWrt 24.10：IPK
x86_64-
aarch64_cortex-a53，适用于常见 MediaTek Filogic 设备 -
aarch64_generic，适用于常见 Rockchip ARMv8 设备
OpenWrt 版由 procd 管理服务，并针对路由器环境提供 LuCI、dnsmasq 接入、配置持久化和软件包升级流程。项目源码位于 openwrt 分支。
三个版本共享主要功能：
- 国内 / 国外 DNS 分流
- FakeIP 与 Redir-Host 分流模式切换
- 白名单、黑名单、灰名单和 DDNS 规则
- 在线订阅规则与广告拦截
- 专属分流组、专属上游和独立缓存
- IPv4 优先、IPv6 屏蔽等运行开关
- 实时查询日志、诊断抓取与统计排行
- 配置包检测和在线更新
- 当前维护中的 Vue WebUI
不同版本主要存在以下运行差异：
| 项目 | Linux 原生版 | Docker 版 | OpenWrt 版 |
|---|---|---|---|
| 服务管理 | systemd | Docker / Compose | procd / LuCI |
| 配置目录 | /cus/mosdns |
挂载到 /cus/mosdns
|
由 OpenWrt 软件包与 LuCI 管理 |
| 程序升级 | 安装脚本或 WebUI 支持的升级流程 | 拉取新镜像并重建容器 | 软件源升级 APK / IPK |
| WebUI 端口 | 可在系统设置中管理 | bridge 模式由端口映射管理 | 由 LuCI 和 OpenWrt 配置管理 |
| 路由器 DNS 接入 | 手动配置客户端或 DHCP | 由宿主机端口映射决定 | 可结合 dnsmasq 接入 |
完整配置模板与增量更新包位于：
-
config_all：新部署使用的完整模板 -
config_up.zip：现有部署使用的增量配置更新包
Linux 原生版与 Docker 版的标准运行目录均为：
/cus/mosdns
本项目采用 GNU General Public License v3.0（GPL-3.0），仓库已包含 LICENSE 文件。使用、修改和再发布本项目时，请以仓库中的 LICENSE 原文为准，并保留原作者及相关版权声明。
对于 fork 项目，不建议随意更换成与上游不兼容的许可证；最稳妥的方式就是保留上游许可证，同时在 README、Wiki 和发布包中明确项目来源。
本项目基于：
感谢原项目作者及所有贡献者。