# ddns-ali

> 提供阿里云的DDNS设置，支持多网卡多域名绑定public

Latest version **1.0.10** (published 2022-04-02) · ISC license · 0 weekly downloads

## Install

```sh
npm install ddns-ali
pnpm add ddns-ali
yarn add ddns-ali
bun add ddns-ali
```

Provides the command `ddns-ali`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.10 |
| Published | 2022-04-02 |
| First published | 2022-02-23 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 15.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | yangxiao |
| Maintainers | ifyx |
| Keywords | aliyun, ddns, aliyunddns, 阿里云域名解析, 阿里ddns解析 |

## Links

- npm: https://www.npmjs.com/package/ddns-ali
- Repository: https://github.com/yangxiao86/ddns-ali
- Homepage: https://github.com/yangxiao86/ddns-ali#readme
- Issues: https://github.com/yangxiao86/ddns-ali/issues
- npm.io page: https://npm.io/package/ddns-ali

## Dependencies (2)

- [tslib](https://npm.io/package/tslib.md) ^2.3.1
- [@alicloud/pop-core](https://npm.io/package/@alicloud/pop-core.md) ^1.7.9

## Recent versions

- 1.0.10 (latest) — 2022-04-02
- 1.0.6 (beta) — 2022-02-25
- 1.0.9 — 2022-04-02
- 1.0.8 — 2022-03-08
- 1.0.7 — 2022-03-08
- 1.0.5 — 2022-02-24
- 1.0.4 — 2022-02-24
- 1.0.4-beta.2 — 2022-02-24
- 1.0.4-beta.1 — 2022-02-24
- 1.0.4-beta.0 — 2022-02-24
- 1.0.3 — 2022-02-23
- 1.0.2 — 2022-02-23
- 1.0.1 — 2022-02-23
- 1.0.0 — 2022-02-23

## README

# ddns-ali

提供阿里云的DDNS设置，支持多网卡多域名绑定。

## 特性

- 支持阿里云DDNS设置
- 支持针对多个线路多个网卡单独设置域名
- 支持IPv4,IPv6
- 支持Docker
## 说明
每次运行时，会打印本地适配器信息，推荐根据网卡名绑定域名

必须在阿里云后台建立域名，`记录值`填写什么无所谓。

阿里云AccessKey开通：https://help.aliyun.com/document_detail/38738.html

必要权限：UpdateDomainRecord,DescribeDomainRecords

node版本>=16

多网卡有什么用， 一些设备有可能接入多条线路，如：电信、联通、移动、海外线等，对每条线提供一个独立的域名很有必要～。

## 安装方式

```
npm i -g ddns-ali 
```

## 命令执行方式

参数之间只能有一个空格, 如果是win环境需要在powershell中执行。

网卡查看命令 `ifconfig`,一般为en0，en1等，选择有本地IP，如192.168.xx.xx的的进行绑定

多网卡绑定多域名方式：

``` sh
ddns-ali -e true -AccessKey 123 -AccessKeySecret 123 -Domain 'eth0&eth0.xxx.com,eth1&eth1.xxx.com'
```

单域名方式
不指定网卡，会根据你当前的外网IP动态绑定，如果支持IPv6,会优先绑定
``` sh
ddns-ali -e true -AccessKey 123 -AccessKeySecret 123 -Domain 'eth0.xxx.com'
```

指定IPv6方式
``` sh
ddns-ali -e true -ip 6 -AccessKey 123 -AccessKeySecret 123 -Domain '网卡名&eth0.xxx.com'
```


## 程序引入方式

``` typescript
import { IConfig, mian, logConfig, getArgv, getDomain, log } from 'ddns-ali';

// logConfig.debug = true;// 是否输出日志信息

async function init(){
    const config = {} as IConfig;
    config.AccessKey = getArgv('AccessKey') as string;
    config.AccessKeySecret = getArgv('AccessKeySecret') as string;
    config.IPVersion = getArgv('ip') as any || '4';
    config.DomainObj = getDomain(getArgv('Domain'));
    config.Domain = config.DomainObj.domain;
    config.Ethernets = config.DomainObj.ethernet;

    const r = await mian(config);
    if(r) {
        log('---成功---');
    }else{
        log('---失败---');
    }
}
```

## 参数

- -e `true或false` true是命令行执行
- -Domain `'网卡名1&域名1，网卡名2&域名2'`, 网卡名与域名通过‘&’进行连接，多个域名使用','分割 
- -ip `4或6` 指定要绑定的的ip类型
- -v 输出版本，与其他参数冲突

## 定时执行

程序不包含定时执行，现在各种系统都有定时任务。没必要在多此一举。节省系统资源。

1. 编写一个run.sh命令文件

```
#!/bin/bash
ddns-ali -e true -AccessKey 123 -AccessKeySecret 123 -Domain 'eth0&eth0.xxx.com,eth1&eth1.xxx.com'
# read
```

2. win `计划任务中`添加 `run.sh` ，mac/linux 可以在`crontab`中添加 `run.sh`


## 更新日志

### v1.0.10

完善ipv6支持

### v1.0.8

增加命令行下，版本输出
```
ddns-ali -v
```

### v1.0.7

增加命令行下，十秒后如果没有更新成功，强制关闭线程。

### v1.0.6

版本发布

---
_Source: https://npm.io/package/ddns-ali · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._