saarphil/domain-mgmt

saarphil/domain-mgmt 镜像描述

镜像概述

saarphil/domain-mgmt是一款轻量域名管理工具，专为Caddy2服务器的On Demand TLS功能设计。它通过维护合法域名列表，让Caddy能够根据实际请求动态获取SSL证书，适用于多域名动态HTTPS场景。

核心功能

• 域名的增、删、改、查基础操作
• 分页查询域名列表
• 提供API接口供Caddy验证域名合法性
• 支持MariaDB数据库存储域名数据

使用场景

• 多租户平台需要动态处理客户域名的HTTPS证书
• 动态域名服务中自动管理证书的场景
• 需要批量维护域名列表以支持Caddy On Demand TLS的场景

配置说明

标签说明

• 当前版本（每日构建）：latest、latest-fedora42、latest-fedora、latest-ubuntu25.04、latest-ubuntu25、latest-ubuntu
• 旧版本：建议使用最新版本，但旧版本暂不删除。如需固定版本，建议镜像到自有仓库。

Docker部署示例

shell
# 生成数据库密码
MARIADB_ROOT_PASSWORD=$(docker run -q --rm alpine/openssl rand -hex 20)
MARIADB_PASS=$(docker run -q --rm alpine/openssl rand -hex 20)

# 创建专用网络
docker network create domain-mgmt

# 启动MariaDB容器
docker run -d --name mariadb --network domain-mgmt \
  -v mariadb_data:/var/lib/mysql:Z \
  -e MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD} \
  -e MARIADB_USER=domain-mgmt \
  -e MARIADB_PASSWORD=${MARIADB_PASS} \
  -e MARIADB_DATABASE=domain_mgmt \
  docker.xuanyuan.run/mariadb:latest

# 启动domain-mgmt容器
docker run -d --name domain-mgmt --network domain-mgmt -p 127.0.0.1:8080:8080 \
  -e "DATABASE_URL=mysql://domain-mgmt:${MARIADB_PASS}@mariadb:3306/domain_mgmt" \
  docker.xuanyuan.run/saarphil/domain-mgmt:latest

Caddy配置示例

Caddyfile
{
  on_demand_tls {
    ask http://127.0.0.1:8080/api/query
  }
}

(ondemandtls) {
  tls {
    on_demand
  }
}

# 域名管理端点（需保护）
mgmt.domain:443 {
  reverse_proxy http://127.0.0.1:8080
}

# 动态域名服务示例
*.customers.domain:443 {
  import ondemandtls
  # 其他业务配置...
}

API使用说明

注意：API请求URL请勿以斜杠结尾，否则返回404。

• 添加域名：
  curl -X PUT "http://localhost:8080/api/domains" -H 'Content-Type: application/json' -d '{"name": "example.tld"}'
• 读取单个域名：
  curl -X GET "http://localhost:8080/api/domain/1" -H 'Content-Type: application/json'
• 更新域名：
  curl -X POST "http://localhost:8080/api/domain/1" -H 'Content-Type: application/json' -d '{"name": "sub.example.tld"}'
• 删除域名：
  curl -X DELETE "http://localhost:8080/api/domain/1" -H 'Content-Type: application/json'
• 分页查询域名：
  curl -X GET "http://localhost:8080/api/domains?offset=0&limit=10" -H 'Content-Type: application/json'

联系方式

support [at] codereaders.eu