Files
appstore/apps/oxidns/README.md
T

1.7 KiB

OxiDNS

产品介绍

OxiDNS 是一个高性能 DNS 策略编排引擎,支持 DNS 转发、缓存、规则匹配、查询记录、Prometheus 指标与内置 WebUI。

主要功能

  • 同时提供 DNS 服务与管理 API / WebUI
  • 支持自定义 config.yaml 持久化配置
  • 支持 TCP/UDP DNS 监听与 HTTP 管理端口
  • 默认内置 WebUI 和健康检查接口

访问说明

安装完成后访问:

http://服务器IP:管理端口

DNS 服务默认监听 TCP / UDP 53 端口。安装后可直接编辑 APP_CONFIG_DIR/config.yaml 调整上游、规则和管理接口配置。

数据持久化

  • APP_CONFIG_DIR:持久化 config.yaml,用于自定义运行配置

升级说明

  • 从 v1.5.0 升级到 v1.5.1 时可以继续使用现有 YAML 配置;升级脚本不会覆盖已有的 APP_CONFIG_DIR/config.yaml
  • v1.5.1 移除了 matcher 的旧 /enable/disable API 和 enabled 响应字段。依赖这些接口的客户端应改用 POST /api/plugins/<matcher_tag>/mode 和新的 mode 字段。
  • 替换镜像前可运行 oxidns check -c <配置文件> 检查配置,并备份 APP_CONFIG_DIR

Introduction

OxiDNS is a high-performance DNS policy orchestration engine with forwarding, caching, rule matching, query recording, Prometheus metrics, and a built-in WebUI.

Features

  • Serves both DNS traffic and the management API / WebUI
  • Supports persistent custom config.yaml
  • Exposes TCP/UDP DNS listeners and a separate HTTP management port
  • Includes a built-in WebUI and health endpoints by default

参考资料