analogj/lexicon

Lexicon Docker镜像文档

镜像概述

Lexicon提供了一种标准化、与提供商无关的方式来操作多个DNS提供商的DNS记录。它可作为CLI工具或Python库使用，专为自动化场景设计，尤其适用于Let's Encrypt SSL证书的自动续期流程。

核心功能与特性

• 多DNS提供商支持：通过统一接口操作众多DNS服务提供商的API
• 双接口设计：同时提供命令行工具(CLI)和Python库，满足不同使用场景需求
• 自动化友好：专为自动化流程打造，特别适合Let's Encrypt的DNS-01挑战验证
• 标准化操作：提供一致的DNS记录创建、查询、更新和删除方法

支持的DNS提供商

目前支持以下具备API接口的DNS提供商：

• Aliyun.com
• AuroraDNS
• AWS Route53
• Azure DNS
• Cloudflare
• ClouDNS
• CloudXNS
• ConoHa
• Constellix
• DigitalOcean
• Dinahosting
• DirectAdmin
• DNSimple (v1, v2)
• DnsMadeEasy
• DNSPark
• DNSPod
• Dreamhost
• Dynu
• EasyDNS
• Easyname
• EUserv
• ExoScale
• Gandi (RPC, LiveAPI)
• Gehirn
• Glesys
• GoDaddy
• Google Cloud DNS
• Gransy (subreg.cz, regtons.com, regnames.eu)
• Hover
• Hurricane Electric DNS
• Hetzner
• Infoblox
• Infomaniak
• Internet.bs
• INWX
• Joker.com
• Linode
• Linode v4
• LuaDNS
• Memset
• Mythic Beasts (v2 API)
• Njalla
• Namecheap
• Namesilo
• Netcup
• NFSN (NearlyFreeSpeech)
• NS1
• OnApp
• Online
• OVH
• Plesk
• PointHQ
• PowerDNS
• Rackspace
• Rage4
• RcodeZero
• RFC2136
• Sakura Cloud
• SafeDNS by UKFast
• SoftLayer
• Transip
• UltraDNS
• Vultr
• Yandex
• Zeit
• Zilore
• Zonomi

使用场景

• SSL证书自动续期：与Let's Encrypt配合，通过DNS-01挑战自动完成域名验证和证书更新
• 内网/Private网络证书：生成内部网络服务的受信任SSL证书
• DNS记录批量管理：跨多个DNS提供商统一管理域名记录
• CI/CD流程集成：在持续集成/部署流程中自动配置DNS设置

使用方法

CLI工具使用示例

bash
# 在CloudFlare托管的domain.net区域创建TXT记录
lexicon cloudflare create domain.net TXT --name foo --content bar

Python库使用示例

python
# 在CloudFlare托管的domain.net区域创建TXT记录
from lexicon.client import Client
from lexicon.config import ConfigResolver

action = {
    "provider_name": "cloudflare",
    "action": "create",
    "domain": "domain.net",
    "type": "TXT",
    "name": "foo",
    "content": "bar",
}
config = ConfigResolver().with_env().with_dict(action)
Client(config).execute()

Docker部署示例

基本CLI操作

bash
docker run --rm -e CLOUDFLARE_API_KEY=your_api_key -e CLOUDFLARE_API_EMAIL=your_email analogj/lexicon cloudflare list domain.net TXT

自动化证书续期配置

创建docker-compose.yml：

yaml
version: '3'
services:
  lexicon-cron:
    image: analogj/lexicon
    volumes:
      - ./letsencrypt:/etc/letsencrypt
      - ./cron.d:/etc/cron.d
    environment:
      - CLOUDFLARE_API_KEY=your_cloudflare_api_key
      - CLOUDFLARE_API_EMAIL=your_cloudflare_email
      - DOMAIN=example.com
    command: cron -f

文档与资源

• 官方文档：Lexicon文档
• 用户指南：快速入门指南
• 开发者指南：贡献指南

许可协议

• 许可：MIT
• Logo：由Mike Rowe从Noun Project提供的"transform"图标修改而来