vshakitskiy/armadillo

来源：https://github.com/vshakitskiy/armadillo

armadillo 图标 Armadillo

一个用于家庭实验室的自托管 DNS 服务器，使用 Gleam 编写。

armadillo 演示 (https://github.com/user-attachments/assets/7361e6b2-c761-4eea-82d8-22f95c104324)

在路由器上配置一次作为 DNS 解析器后，网络上的所有设备都会自动解析你的本地域名。

工作原理

当 DNS 查询到达时，服务器首先检查本地记录存储。如果存在匹配的记录，它会立即响应配置的 IP。如果没有匹配记录，查询会被转发到可配置的上游解析器，响应按 TTL 缓存，然后返回给客户端。

本地记录存储在一个 DNS 区域文件中，并在启动时加载到 ETS 中。所有运行时的查询解析仅通过 ETS 进行，查询处理期间永远不会读取区域文件。

容器镜像

可在 ghcr.io/vshakitskiy/armadillo:latest 获取。

挂载卷到 /data 以在重启后持久化区域文件。如果文件不存在，区域文件会自动创建。

部署指南

部署指南位于 examples/ 目录。

• Podman — 使用 Podman Quadlet 的 systemd 服务，Caddy 作为反向代理。
• Docker Compose — 多容器应用，Caddy 作为反向代理。

域名命名建议

服务器接受任何域名字符串。但应避免使用 .local。它被保留用于 mDNS/Bonjour (RFC 6762)，Apple 设备不会将 .local 查询发送到单播 DNS 服务器。.lan 或 .internal 是常见的替代方案。

贡献

欢迎任何贡献和反馈！问题和拉取请求都欢迎！

项目包含三个包：server 运行 DNS 解析器和 HTTP API，client 是 Web UI，shared 包含两者共用的模块。每个包独立开发，在 server/ 中运行 gleam run，在 client/ 中运行 gleam run -m lustre/dev。

在本地开发时管理环境变量，建议使用 direnv (https://direnv.net)。

要在不需要 sudo 的情况下本地绑定到端口 53，请对 BEAM 二进制文件运行 setcap：

# 查找二进制文件：
$(which erl) -noshell -eval 'io:format("~s~n",[os:find_executable("beam.smp")]),halt().'
# > /path/to/beam.smp

sudo setcap cap_net_bind_service=+ep /path/to/beam.smp

通过 VPN 解析

个人备忘：以防再次遇到 VPN 导致 DNS 问题。

当运行 vless 等 VPN 并在代理或 tun 模式下时，确保 VPN 通过正确的 DNS 解析域名非常重要。假设路由器的 IP 192.168.1.1 是配置 DNS 服务器的地址：

1. 将路由器添加为 DNS 服务器，并为 xray 直接路由局域网 IP：

{
    "dns": {
        "servers": [
            { "address": "192.168.1.1", "port": 53 },
            "1.1.1.1"
        ]
    },
    "routing": {
        "rules": [
            {
                "ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
                "outboundTag": "direct"
            }
        ]
    }
}

2. 为 sing-box 标记本地 DNS 服务器并路由私有 IP：

{
    "dns": {
        "servers": [
            { "tag": "dns-local", "address": "192.168.1.1", "detour": "direct" },
            { "tag": "dns-remote", "address": "1.1.1.1", "detour": "proxy" }
        ],
        "rules": [{ "ip_is_private": true, "server": "dns-local" }],
        "final": "dns-remote"
    },
    "route": {
        "rules": [{ "ip_is_private": true, "outbound": "direct" }]
    }
}