ACME-DNS 安装与配置完全指南

ACME-DNS 安装与配置完全指南

acme-dns Limited DNS server with RESTful HTTP API to handle ACME DNS challenges easily and securely. 项目地址: https://gitcode.com/gh_mirrors/ac/acme-dns

项目基础介绍与主要编程语言

ACME-DNS 是一个轻量级的DNS服务器，专门设计用于通过RESTful HTTP API简化ACME协议下的DNS挑战处理。这意味着它便于自动化Let's Encrypt等CA证书申请中的DNS验证过程。此项目采用Go语言编写，确保了高效率和简单的部署能力。

关键技术和框架

• Go (Golang)：作为项目的核心开发语言，Go提供了快速编译和高效运行的能力。
• RESTful API：提供简洁的接口来管理DNS记录，特别是针对ACME DNS挑战所需的TXT记录更新。
• SQLite与PostgreSQL支持：作为数据库后端，允许灵活选择存储解决方案。
• 自动TLS证书获取：利用Let's Encrypt服务，为API通信加密。
• CIDR限制：安全特性，允许限定哪些网络可以访问更新API。

安装与配置步骤

准备工作

1. 环境准备：确保您的系统已安装Go 1.13或更高版本。
2. 工具安装：如有必要，安装Git以克隆项目源代码。

安装步骤

步骤1：克隆项目

打开终端或命令提示符，执行以下命令克隆ACME-DNS仓库到本地：

git clone https://github.com/joohoi/acme-dns.git
cd acme-dns

步骤2：构建项目

设置GOPATH（如果还没有设置），然后构建ACME-DNS二进制文件：

export GOPATH=/tmp/acme-dns # 可选，如果已有GOPATH则无需此步
go build

步骤3：配置文件设置

• 复制或创建配置文件config.cfg并调整以满足您的需求。默认配置模板可以在项目根目录找到，调整如数据库连接信息、监听端口等。

[main]
bind = ":53"
db_path = "./data/db.sqlite3"

[api]
listen = ":80"
lets_encrypt_dir = "/etc/letsencrypt/live/<yourDomain>"

[log]
level = "info"

步骤4：数据库初始化（可选，取决于您选择的数据库）

如果您选择了SQLite作为数据库，这一步是自动生成的；如果是PostgreSQL，需手动创建数据库和表结构。

步骤5：启动ACME-DNS服务

• 非系统服务方式运行：

  ./acme-dns
  

• 或者，如果您希望作为系统服务运行，在Linux系统中，您可以继续下一步进行系统服务配置。

系统服务配置示例（Linux，Systemd）

1. 移动二进制文件至全局路径，并配置服务文件。

   sudo mv acme-dns /usr/local/bin/
   sudo cp acme-dns.service /etc/systemd/system/
   

2. 编辑acme-dns.service文件，确保指向正确的配置文件路径。

3. 启动服务前，加载服务单元并启用开机启动。

   sudo systemctl daemon-reload
   sudo systemctl enable acme-dns.service
   sudo systemctl start acme-dns.service
   

结语

至此，ACME-DNS已经成功安装并配置在您的系统上，现在可以按照项目文档进一步了解如何与其他ACME客户端集成，例如Certbot，来自动化SSL证书的申请和更新流程。保持学习，享受开源带来的便利与乐趣！

acme-dns Limited DNS server with RESTful HTTP API to handle ACME DNS challenges easily and securely. 项目地址: https://gitcode.com/gh_mirrors/ac/acme-dns