pabra/inwx-apply

INWX apply

https://img.shields.io/npm/v/inwx-apply?label=version&logo=npm](https://www.npmjs.com/package/inwx-apply) https://img.shields.io/docker/v/pabra/inwx-apply/latest?logo=docker](https://hub.docker.com/r/pabra/inwx-apply) https://img.shields.io/codecov/c/github/pabra/inwx-apply/master?logo=codecov](https://codecov.io/gh/pabra/inwx-apply) https://github.com/pabra/inwx-apply/actions/workflows/unit-tests.yml/badge.svg?branch=master](https://github.com/pabra/inwx-apply/actions?query=branch%3Amaster+workflow%3Aunit-tests) https://github.com/pabra/inwx-apply/actions/workflows/publish.yml/badge.svg](https://github.com/pabra/inwx-apply/actions?query=workflow%3Apublish)

镜像概述

INWX apply是一款通过INWX API同步DNS资源记录的工具，可将JSON配置文件中的记录应用到INWX域名服务器，确保服务器上的记录与配置完全一致。支持版本控制（如Git）和变量复用，简化多域名DNS管理流程。

核心功能

1. 配置同步：将JSON文件中的DNS记录同步到INWX服务器，确保记录无多余、无缺失。
2. 版本控制：配置文件可通过Git等工具版本化管理，便于追溯和回滚。
3. 变量复用：支持定义变量（如IP地址、TTL值），减少重复配置。
4. 预览模式：默认开启dry-run模式，先展示操作内容再执行实际修改。

使用场景

1. 批量域名管理：同时维护多个域名的DNS记录，统一配置规范。
2. 自动化部署：结合CI/CD流程，自动同步DNS记录变更。
3. 配置追溯：通过版本控制记录DNS变更历史，快速定位问题。

配置说明

1. 凭据文件（忽略版本控制）

创建包含INWX账号信息的JSON文件（如inwx_credentials.gitignore.json）：

json
{
  "username": "你的INWX用户名",
  "password": "你的INWX密码",
  "sharedSecret": null
}

2. DNS记录配置文件

创建JS文件（如inwxDnsEntries.js），导入凭据并定义DNS记录：

javascript
const credentials = require('./inwx_credentials.gitignore.json');
const ttl = 3600;
const ipV4 = { web: '1.2.3.4' };

const entries = {
  credentials,
  knownDomains: ['example.com'],
  ignoredDomains: [],
  resourceRecords: {
    'example.com': {
      A: [{ ttl, name: '*', content: ipV4.web }]
    }
  }
};

module.exports = JSON.stringify(entries);

Docker部署示例

拉取镜像

bash
docker pull pabra/inwx-apply:latest

运行容器

bash
docker run \
  --rm \
  -v /本地路径/credentials.gitignore.json:/data/credentials.gitignore.json:ro \
  -v /本地路径/inwxDnsEntries.js:/data/inwxDnsEntries.js:ro \
  pabra/inwx-apply:latest \
  --file inwxDnsEntries.js

自定义脚本示例

创建shell脚本简化操作：

sh
#!/bin/sh
IMAGE_NAME=pabra/inwx-apply
IMAGE_TAG=latest

CREDENTIALS_FILE="$(pwd)/credentials.gitignore.json"
ENTRIES_FILE="$(pwd)/inwxDnsEntries.js"

docker run \
  --rm \
  -v "${CREDENTIALS_FILE}:/data/$(basename ${CREDENTIALS_FILE}):ro" \
  -v "${ENTRIES_FILE}:/data/$(basename ${ENTRIES_FILE}):ro" \
  "${IMAGE_NAME}:${IMAGE_TAG}" \
  --file $(basename ${ENTRIES_FILE}) "$@"

保存为inwx-apply.sh，执行./inwx-apply.sh即可运行（添加pull参数可拉取最新镜像）。