jasonxtt/mosdns-t repository overview

⁠mosdns-t

mosdns-t 是一个面向家庭网络 / 旁路由场景的 mosdns 容器镜像，基于PH佬的mosdns项目进行了深度定制，延续了完善的国内国外分流规则，新增了定制化程度更高的UI。

项目地址：github源码⁠， UI使用说明：github wiki⁠

⁠使用说明

• 容器内使用53端口为DNS查询主入口。
• 容器默认使用bridge网络，需做好相关端口映射并保证宿主机端口未被占用。
• host、macvlan或ipvlan模式允许用户通过UI修改webui端口，需额外添加环境变量 MOSDNS_CONTAINER_NETWORK_MODE: host。
• WebUI 默认访问地址：http://宿主机IP:9099
• 支持使用Redir-host模式，国外域名通过国外上游返回真实IP
• 首次使用，务必通过UI修改socks5 代理、ECS IP，使用FakeIP模式还需配置国外 FakeIP 上游

⁠配置说明

容器内置了一套完整的国内外分流规则，无需用户手动维护

• 容器内部配置文件目录为 /cus/mosdns。容器首次启动时，配置目录为空会自动下载配置文件，保证容器所处网络环境可正常访问Github。
• 若无法访问可通过链接⁠下载配置文件包，解压到宿主机目录并映射到容器/cus/mosdns路径，确保容器内路径层级为/cus/mosdns/config_custom.yaml

⁠标准 Compose 示例（bridge）

services:
  mosdns:
    image: jasonxtt/mosdns-t:latest
    container_name: mosdns
    restart: unless-stopped
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "9099:9099/tcp"
    volumes:
      - "/opt/mosdns:/cus/mosdns"

⁠Host 网络示例（仅 Linux）

services:
  mosdns:
    image: jasonxtt/mosdns-t:latest
    container_name: mosdns
    restart: unless-stopped
    network_mode: host
    environment:
      MOSDNS_CONTAINER_NETWORK_MODE: host
    volumes:
      - "/opt/mosdns:/cus/mosdns"

使用 host 网络时无需映射 ports 端口。

⁠其他说明

• 程序升级方式是拉取新镜像并重建容器，不支持在 WebUI 内直接替换二进制
• docker版本不支持通过WebUI在线更新版本及配置，仅支持Linux裸核运行方式，教程参考mosdns安装教程⁠。
• bridge 模式下不支持在 WebUI 内修改 WebUI 监听端口；如需改端口，请修改 Compose 中的宿主机端口映射
• bridge 模式下，特殊分流组可以设置自定义端口，但设置后还需要在 Compose 中补充对应的 TCP / UDP 端口映射，否则外部无法访问