cunnie/fedora-ruby-bind-utils

sslip.io

镜像概述和主要用途

sslip.io是一个DNS服务器，能够将特制格式的DNS A记录映射到对应的IP地址（例如，"127-0-0-1.sslip.io"映射到127.0.0.1）。它类似于并受xip.io启发，主要用于开发和测试环境中，帮助用户快速将IP地址转换为可访问的域名。

如果需要将sslip.io作为服务使用，可参考官方网站(sslip.io)获取更多信息。本文档主要面向开发者，网站则面向普通用户。

核心功能和特性

sslip.io DNS服务器使用Golang编写，具有以下特性（无配置选项，需修改源代码才能调整）：

• 绑定端口：固定绑定53端口（不可修改）
• 网络协议：仅支持UDP（不支持TCP）
• SOA记录：除MNAME（主域名服务器）记录外均为硬编码，MNAME会设置为查询的主机名（例如，dig big.apple.com @ns-aws.nono.io会返回MNAME为big.apple.com.的SOA记录）
• NS记录：硬编码
• MX记录：默认将查询的主机名作为MX记录，优先级为0；例外情况：sslip.io本身有自定义MX记录以支持ProtonMail邮件投递
• TXT记录：仅sslip.io有自定义TXT记录以支持邮件投递，其他域名无TXT记录
• SRV记录：不支持

使用场景和适用范围

适用于开发和测试环境，需要快速将IP地址映射为域名的场景，例如：

• 本地开发时需要通过域名访问本地服务
• 测试环境中临时将服务器IP地址转换为可访问的域名
• 无需配置DNS服务器即可实现IP与域名的快速映射

详细使用方法和配置说明

运行单元测试

bash
cd src
go get github.com/onsi/ginkgo/ginkgo
go get github.com/onsi/gomega/...
ginkgo -r .

本地运行DNS服务器

在本地（如Mac）运行服务器：

bash
cd src
go run main.go

测试DNS查询

在另一个终端窗口中执行查询命令，例如：

bash
dig +short 127.0.0.1.sslip.io @localhost

预期返回结果：

127.0.0.1

同时，服务器运行窗口会显示类似以下日志：

2020/11/22 03:45:44 ::1.62302 TypeA 127.0.0.1.sslip.io. ? 127.0.0.1

目录结构说明

• src/：DNS服务器源代码
• ci/：Concourse持续集成(CI)流水线和任务配置
• spec/：生产环境名称服务器的测试用例，本地运行测试命令：

  bash
  DOMAIN=sslip.io rspec --format documentation --color spec/
  

• k8s/document_root/：sslip.io网站的HTML内容，提交PR前需运行tidy -im -w 120 k8s/document_root/index.html格式化
• bosh-release/：BOSH发布包，用于部署服务器
• conf/sslip.io+nono.io.yml （已弃用）：PowerDNS管道后端的YAML配置文件