什么是 SmartDNS Edge？

What is SmartDNS Edge?

SmartDNS Edge 是使用 Rust 语言重写的本地 DNS 服务器。它能够获取多个上游 DNS 的解析结果，并通过测速算法动态获取最快的网站 IP 响应，从而显著提升网络访问相应速度与网页加载体验。

SmartDNS Edge is a local DNS server rewritten in the Rust programming language. It resolves DNS queries from multiple upstream servers, dynamically determines the fastest IP addresses using smart speed-testing algorithms, and significantly improves internet access speeds and web-loading experiences.

✨ 核心特性

✨ Core Features

• 绿色工具软件：解包即用，需要自己编辑 smartdns.conf 配置文件，可作为服务安装。
• Green Utility Software: Out-of-the-box, easy configuration with a single smartdns.conf file, and supports installation as a system service.
• 前沿加密协议支持：全面支持 DNS-over-TLS (DoT)、DNS-over-HTTPS (DoH)、DNS-over-QUIC (DoQ) 以及最新的 DNS-over-HTTP/3 (DoH3)。
• Cutting-edge Encryption Protocol Support: Full support for DNS-over-TLS (DoT), DNS-over-HTTPS (DoH), DNS-over-QUIC (DoQ), and the latest DNS-over-HTTP/3 (DoH3).
• 持久缓存与乐观缓存：完善的新鲜缓存、过期缓存预取、超时缓存、否定缓存机制，后台自动更新满足热度要求的过期缓存，前端解析响应毫秒级响应。
• Persistent Cache (Optimistic Cache): Comprehensive mechanisms for fresh cache, prefetching expired cache, timeout cache, and negative cache. It automatically updates expired cache in the background based on request frequency, achieving millisecond-level DNS response times.
• 高性能 SOCKS5/HTTP 代理隧道：内置零分配（Zero-Allocation）的高并发 SOCKS5 代理客户端，安全绕过代理漏流。
• High-Performance SOCKS5/HTTP Proxy Tunneling: Built-in zero-allocation, high-concurrency SOCKS5 proxy client that securely avoids proxy leaks.
• 全平台兼容：完美兼容 Windows、Linux、macOS，支持无管理员权限（Unprivileged ICMP）极速 Ping 测速。
• Cross-Platform Compatibility: Fully compatible with Windows, Linux, and macOS. Supports unprivileged ICMP ping for speed testing without administrator/root privileges.
• 智能防漏流与分流：支持高级防火墙 SO_MARK、网卡设备绑定以及多 WAN 口策略路由。
• Smart Routing & Leak Prevention: Supports advanced firewall tagging (SO_MARK), binding sockets to specific network interfaces, and multi-WAN policy routing.
• 极高并发处理性能：CPU多核心优化，极高网络并发处理能力，无内存泄漏。
• Ultra-high Concurrency: Optimized for multi-core CPUs with extreme network concurrency handling and zero memory leaks.
• 完美的双栈优选：A与AAAA记录进行优选，选出最优访问速度的记录，默认参数下，只要有A记录，A记录始终有效，如果AAAA纪录更优，那就都保留；可设置AAAA记录优先，哪个记录更优就只保留哪个记录。A和AAAA记录TTL始终对齐
• Optimal Dual-Stack Selection: Optimizes IPv4 (A) and IPv6 (AAAA) records to choose the fastest access route. By default, as long as an A record exists, it is kept valid. If the AAAA record is faster, both are kept. You can also prioritize AAAA records so only the faster one is returned. A and AAAA record TTLs are always kept aligned.
• 漏洞防御与反网络攻击：防御恒定时间防侧信道爆破、源地址投毒清洗、UDP放大反射、HTTPS内存炸弹、慢速握手等网络攻击；使用绝对的流量沙盒防止泄漏真实地址
• Vulnerability Defense & Anti-Network Attack: Defends against constant-time side-channel attacks, source address poisoning/scrubbing, UDP amplification/reflection, HTTPS memory bombs, and slow-handshake attacks. Uses isolated sandboxes to prevent real IP leaks.
• resolve命令行工具：支持完善的resolve功能，对标dig
• Resolve CLI Tool: Built-in feature-complete resolution command-line tool, fully matching the capabilities of dig.

💻 支持的操作系统

💻 Supported Operating Systems

🪟 Windows 系列（全面覆盖企业与现代桌面）

🪟 Windows Series (Full Coverage of Enterprise & Modern Desktops)

底层架构：x86_64 (主流 Intel/AMD) 与 aarch64 (现代 ARM 处理器)

Underlying Architectures: x86_64 (Mainstream Intel/AMD) & aarch64 (Modern ARM Processors)

• 企业级服务器 (Windows Server)：完美支持 Windows Server 2016, 2019, 2022 以及最新的 Windows Server 2025。
• Enterprise Servers (Windows Server): Fully supports Windows Server 2016, 2019, 2022, and the latest Windows Server 2025.
• 个人桌面端 (Windows Desktop)：完美支持 Windows 10 和 Windows 11。
• Personal Desktops (Windows Desktop): Fully supports Windows 10 and Windows 11.
• ARM 笔电生态：原生满血支持搭载骁龙 X 芯片的新一代 Windows 11 ARM 笔记本。
• ARM Laptop Ecosystem: Native out-of-the-box support for next-generation Snapdragon X Elite/Plus Windows 11 ARM laptops.

🐧 Linux 系列

🐧 Linux Series

底层架构：x86_64-generic-linux-gnu 与 aarch64-generic-linux-gnu

Underlying Architectures: x86_64-generic-linux-gnu & aarch64-generic-linux-gnu

• 主流企业服务器 (Linux Server)：
  • Debian 阵营：Ubuntu Server (18.04 及以上), Debian (10 及以上)。
  • 红帽阵营 (RHEL)：CentOS (7/8/9), Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Oracle Linux。
  • 其他商业 Server：SUSE Linux Enterprise, openSUSE。
• Mainstream Enterprise Servers (Linux Server):
  • Debian Camps: Ubuntu Server (18.04 & above), Debian (10 & above).
  • Red Hat Camps (RHEL): CentOS (7/8/9), Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Oracle Linux.
  • Other Commercial Servers: SUSE Linux Enterprise, openSUSE.
• 国产/个人桌面端 (Linux Desktop)：Ubuntu Desktop, Fedora, Linux Mint, Deepin (深度操作系统), 统信 UOS, Manjaro 等。
• Desktop & Distros (Linux Desktop): Ubuntu Desktop, Fedora, Linux Mint, Deepin, UnionTech UOS, Manjaro, etc.
• 云服务器 / 边缘计算节点 (VPS & Edge)：
  • 支持所有主流云厂商（阿里云、腾讯云、华为云、AWS、Azure、Google Cloud 等）的普通 x86_64 虚拟机。
  • 【重点】完美支持 AWS Graviton、阿里云倚天、Oracle 等高性能 ARM64 云服务器。
  • 支持安装了 64 位 Linux 系统的微型边缘主机（如树莓派 4、树莓派 5、NanoPi 等）。
• Cloud & Edge Nodes (VPS & Edge):
  • Supports all mainstream cloud providers (Alibaba Cloud, Tencent Cloud, Huawei Cloud, AWS, Azure, Google Cloud, etc.) on standard x86_64 VMs.
  • [Highlight] Seamlessly supports high-performance ARM64 cloud instances like AWS Graviton, Alibaba Cloud Yitian, and Oracle ARM instances.
  • Supports micro edge servers running 64-bit Linux (e.g., Raspberry Pi 4/5, NanoPi, etc.).

🍎 macOS 系列（苹果生态全家桶）

🍎 macOS Series (Apple Ecosystem)

底层架构：x86_64-apple-darwin 与 aarch64-apple-darwin

Underlying Architectures: x86_64-apple-darwin & aarch64-apple-darwin

• 老款 Mac 设备：完美支持搭载 Intel 处理器的老款 MacBook、iMac、Mac mini。
• Intel Macs: Fully supports older MacBook, iMac, and Mac mini models powered by Intel processors.
• 新款 Mac 设备：原生支持搭载 M1、M2、M3、M4 芯片 (Apple Silicon) 的所有 Mac 设备。无需开启 Rosetta 转译，发挥出苹果芯片最极限的 I/O 性能。
• Apple Silicon Macs: Native support for all Mac models powered by M1, M2, M3, and M4 Apple Silicon chips. No Rosetta translation required, unleashing peak chip I/O performance.

🐳 云原生与容器化环境 (Docker / NAS)

🐳 Cloud-Native & Containerized Environments (Docker / NAS)

分发形式：全自动构建的 ghcr.io 多架构双端镜像 (amd64 / arm64)

Distribution: Automated multi-architecture dual-end images on ghcr.io (amd64 / arm64)

• 网络附属存储 (NAS)：完美运行于群晖 (Synology)、威联通 (QNAP)、极空间等主流 NAS 系统的 Docker 组件中。
• Network Attached Storage (NAS): Runs perfectly inside Docker on Synology, QNAP, Ugreen, and other mainstream NAS systems.
• 高级网络环境：支持在 PVE/ESXi 下的虚拟机中运行，支持部署于 Kubernetes (K8s) 企业级编排集群。
• Advanced Network Environments: Supports running in virtual machines under PVE/ESXi, and deploying to enterprise-grade Kubernetes (K8s) orchestration clusters.
• Windows 容器环境：完美支持在 Windows 的 WSL2 (Windows Subsystem for Linux) Docker Desktop 中运行。
• Windows Containerized Environments: Fully supported in Windows WSL2 (Windows Subsystem for Linux) and Docker Desktop.

📦 安装与运行

📦 Installation and Running

本程序为纯净绿色软件，无任何外部系统依赖。请前往 Releases 页面 下载对应您系统架构的最新压缩包。

This software is a clean, dependency-free utility. Please visit the Releases page to download the latest archive corresponding to your system architecture.

🪟 Windows (企业服务器 & 个人桌面)

🪟 Windows (Enterprise Servers & Desktops)

将下载的 .zip 文件解压到一个固定目录（如 D:\SmartDNS）。

Extract the downloaded .zip file to a fixed directory (e.g., D:\SmartDNS).

方式一：前台测试运行（适合测试排障）

Method 1: Foreground Test Execution (Best for troubleshooting)

.\smartdns.exe run -c .\smartdns.conf -v

(注：-v 表示开启调试日志输出，方便直观查看解析过程)

(Note: -v enables debug log output to visually inspect the resolution process)

方式二：后台服务运行（推荐，开机自启）

Method 2: Background Service Execution (Recommended, Autostart)

请以管理员身份运行终端（PowerShell），执行以下命令，系统将全自动接管进程并配置好防火墙规则：

Run your terminal (PowerShell) as Administrator and execute the following commands. The system will automatically register the background process and configure the local firewall rules:

# 1. 安装服务
.\smartdns.exe service install

# 2. 启动服务
.\smartdns.exe service start

# 3. 随时查看运行状态 (带 🟢/🔴 指示灯)
.\smartdns.exe service status

# 1. Install service
.\smartdns.exe service install

# 2. Start service
.\smartdns.exe service start

# 3. Inspect service status (with 🟢/🔴 indicators)
.\smartdns.exe service status

(如需彻底清理，执行 .\smartdns.exe service uninstall 即可)

(To uninstall, simply execute .\smartdns.exe service uninstall)

🐧 Linux & 🍎 macOS (通用绿色运行)

🐧 Linux & 🍎 macOS (Generic Execution)

将下载的压缩包解压到目标目录。打开终端，赋予执行权限即可直接启动：

Extract the archive to your target directory. Open your terminal, grant execution permissions, and run:

# 赋予执行权限
chmod +x ./smartdns

# 启动服务
sudo ./smartdns run -c ./etc/smartdns/smartdns.conf

# Grant execution permissions
chmod +x ./smartdns

# Start service
sudo ./smartdns run -c ./etc/smartdns/smartdns.conf

(注：Linux 系统绑定 53 等特权端口需要 sudo root 权限)

(Note: Binding to privileged ports like 53 on Linux requires sudo/root privileges)

🐳 Docker / NAS (容器化一键部署)

🐳 Docker / NAS (One-Click Container Deployment)

我们提供原生支持 amd64 与 arm64 双架构的极简容器镜像。极其适合部署在群晖 (Synology) 等支持 Docker 的环境中。使用 CLI 快速启动：

We provide minimal container images natively supporting both amd64 and arm64 architectures. Perfect for Synology Docker setups or similar environments. Quick start using the CLI:

docker run -d --name smartdns --restart always --network host -v /你的本地路径/smartdns.conf:/etc/smartdns/smartdns.conf ghcr.io/gdxz-linus/smartdns-edge:v1.0.1

docker run -d --name smartdns --restart always --network host -v /your/local/path/smartdns.conf:/etc/smartdns/smartdns.conf ghcr.io/gdxz-linus/smartdns-edge:v1.0.1