ddns 4.0.1__py2.py3-none-any.whl → 4.1.0__py2.py3-none-any.whl

ddns/__builtins__.pyi

@@ -0,0 +1,6 @@
+# coding=utf-8
+# flake8: noqa: F401
+# ruff: noqa: F403
+from typing import *
+from .provider import SimpleProvider
+import logging

ddns/__init__.py

@@ -6,14 +6,7 @@ ddns Package
 __description__ = "automatically update DNS records to my IP [域名自动指向本机IP]"
 
 # 编译时，版本会被替换
-__version__ = "4.0.1"
+__version__ = "4.1.0"
 
 # 时间也会被替换掉
-build_date = "2025-06-23T16:56:46Z"
-
-__doc__ = """
-ddns [v{}@{}]
-(i) homepage or docs [文档主页]: https://ddns.newfuture.cc/
-(?) issues or bugs [问题和反馈]: https://github.com/NewFuture/DDNS/issues
-Copyright (c) New Future (MIT License)
-""".format(__version__, build_date)
+build_date = "2025-10-09T09:06:52Z"

ddns/__main__.py

@@ -1,187 +1,151 @@
 # -*- coding:utf-8 -*-
 """
 DDNS
-@author: New Future
-@modified: rufengsuixing
+@author: NewFuture, rufengsuixing
 """
 
-from os import path, environ, name as os_name
+import sys
 from io import TextIOWrapper
+from logging import getLogger
 from subprocess import check_output
-from tempfile import gettempdir
-from logging import basicConfig, info, warning, error, debug, INFO
-
-import sys
-
-from .__init__ import __version__, __description__, __doc__, build_date
-from .util import ip
-from .util.cache import Cache
-from .util.config import init_config, get_config
 
-environ["DDNS_VERSION"] = __version__
+from . import ip
+from .__init__ import __description__, __version__, build_date
+from .cache import Cache
+from .config import Config, load_configs  # noqa: F401
+from .provider import SimpleProvider, get_provider_class  # noqa: F401
 
+logger = getLogger()
 
-def is_false(value):
-    """
-    判断值是否为 False
-    字符串 'false', 或者 False, 或者 'none';
-    0 不是 False
-    """
-    if isinstance(value, str):
-        return value.strip().lower() in ['false', 'none']
-    return value is False
 
-
-def get_ip(ip_type, index="default"):
+def get_ip(ip_type, rules):
     """
     get IP address
     """
-    # CN: 捕获异常
-    # EN: Catch exceptions
-    value = None
-    try:
-        debug("get_ip(%s, %s)", ip_type, index)
-        if is_false(index):  # disabled
-            return False
-        elif isinstance(index, list):  # 如果获取到的规则是列表，则依次判断列表中每一个规则，直到获取到IP
-            for i in index:
-                value = get_ip(ip_type, i)
-                if value:
-                    break
-        elif str(index).isdigit():  # 数字 local eth
-            value = getattr(ip, "local_v" + ip_type)(index)
-        elif index.startswith('cmd:'):  # cmd
-            value = str(check_output(index[4:]).strip().decode('utf-8'))
-        elif index.startswith('shell:'):  # shell
-            value = str(check_output(
-                index[6:], shell=True).strip().decode('utf-8'))
-        elif index.startswith('url:'):  # 自定义 url
-            value = getattr(ip, "public_v" + ip_type)(index[4:])
-        elif index.startswith('regex:'):  # 正则 regex
-            value = getattr(ip, "regex_v" + ip_type)(index[6:])
-        else:
-            value = getattr(ip, index + "_v" + ip_type)()
-    except Exception as e:
-        error("Failed to get %s address: %s", ip_type, e)
-    return value
-
-
-def change_dns_record(dns, proxy_list, **kw):
-    for proxy in proxy_list:
-        if not proxy or (proxy.upper() in ['DIRECT', 'NONE']):
-            dns.Config.PROXY = None
-        else:
-            dns.Config.PROXY = proxy
-        record_type, domain = kw['record_type'], kw['domain']
-        info("%s(%s) ==> %s [via %s]", domain, record_type, kw['ip'], proxy)
+    if rules is False:  # disabled
+        return False
+    for i in rules:
         try:
-            return dns.update_record(domain, kw['ip'], record_type=record_type)
+            logger.debug("get_ip:(%s, %s)", ip_type, i)
+            if str(i).isdigit():  # 数字 local eth
+                return getattr(ip, "local_v" + ip_type)(i)
+            elif i.startswith("cmd:"):  # cmd
+                return str(check_output(i[4:]).strip().decode("utf-8"))
+            elif i.startswith("shell:"):  # shell
+                return str(check_output(i[6:], shell=True).strip().decode("utf-8"))
+            elif i.startswith("url:"):  # 自定义 url
+                return getattr(ip, "public_v" + ip_type)(i[4:])
+            elif i.startswith("regex:"):  # 正则 regex
+                return getattr(ip, "regex_v" + ip_type)(i[6:])
+            else:
+                return getattr(ip, i + "_v" + ip_type)()
         except Exception as e:
-            error("Failed to update %s record for %s: %s", record_type, domain, e)
-    return False
+            logger.error("Failed to get %s address: %s", ip_type, e)
+    return None
 
 
-def update_ip(ip_type, cache, dns, proxy_list):
+def update_ip(dns, cache, index_rule, domains, record_type, config):
+    # type: (SimpleProvider, Cache | None, list[str]|bool, list[str], str, Config) -> bool | None
     """
-    更新IP
+    更新IP并变更DNS记录
     """
-    ipname = 'ipv' + ip_type
-    domains = get_config(ipname)
     if not domains:
         return None
-    if not isinstance(domains, list):
-        domains = domains.strip('; ').replace(',', ';').replace(' ', ';').split(';')
 
-    index_rule = get_config('index' + ip_type, "default")
+    ip_type = "4" if record_type == "A" else "6"
     address = get_ip(ip_type, index_rule)
     if not address:
-        error('Fail to get %s address!', ipname)
+        logger.error("Fail to get %s address!", ip_type)
         return False
 
-    if cache and (address == cache.get(ipname)):
-        info('%s address not changed, using cache.', ipname)
-        return True
-
-    record_type = 'A' if ip_type == '4' else 'AAAA'
     update_success = False
+
     for domain in domains:
         domain = domain.lower()
-        if change_dns_record(dns, proxy_list, domain=domain, ip=address, record_type=record_type):
+        cache_key = "{}:{}".format(domain, record_type)
+        if cache and cache.get(cache_key) == address:
+            logger.info("%s[%s] address not changed, using cache: %s", domain, record_type, address)
             update_success = True
-
-    if isinstance(cache, dict):
-        cache[ipname] = update_success and address
-
+        else:
+            try:
+                result = dns.set_record(domain, address, record_type=record_type, ttl=config.ttl, line=config.line)
+                if result:
+                    logger.warning("set %s[IPv%s]: %s successfully.", domain, ip_type, address)
+                    update_success = True
+                    if isinstance(cache, dict):
+                        cache[cache_key] = address
+                else:
+                    logger.error("Failed to update %s record for %s", record_type, domain)
+            except Exception as e:
+                logger.exception("Failed to update %s record for %s: %s", record_type, domain, e)
     return update_success
 
 
-def main():
+def run(config):
+    # type: (Config) -> bool
     """
-    更新
+    Run the DDNS update process
     """
-    encode = sys.stdout.encoding
-    if encode is not None and encode.lower() != 'utf-8' and hasattr(sys.stdout, 'buffer'):
-        # 兼容windows 和部分ASCII编码的老旧系统
-        sys.stdout = TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
-        sys.stderr = TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
-    init_config(__description__, __doc__, __version__, build_date)
-
-    log_level = get_config('log.level')
-    log_format = get_config('log.format')
-    if log_format:
-        # A custom log format is already set; no further action is required.
-        pass
-    elif log_level < INFO:
-        # Override log format in debug mode to include filename and line number for detailed debugging
-        log_format = '%(asctime)s %(levelname)s [%(module)s.%(funcName)s](%(filename)s:%(lineno)d): %(message)s'
-    elif log_level > INFO:
-        log_format = '%(asctime)s %(levelname)s: %(message)s'
-    else:
-        log_format = '%(asctime)s %(levelname)s [%(module)s]: %(message)s'
-    basicConfig(
-        level=log_level,
-        format=log_format,
-        datefmt=get_config('log.datefmt', '%Y-%m-%dT%H:%M:%S'),
-        filename=get_config('log.file'),
+    # 设置IP模块的SSL验证配置
+    ip.ssl_verify = config.ssl
+
+    # dns provider class
+    provider_class = get_provider_class(config.dns)
+    dns = provider_class(
+        config.id, config.token, endpoint=config.endpoint, logger=logger, proxy=config.proxy, ssl=config.ssl
+    )
+    cache = Cache.new(config.cache, config.md5(), logger)
+    return (
+        update_ip(dns, cache, config.index4, config.ipv4, "A", config) is not False
+        and update_ip(dns, cache, config.index6, config.ipv6, "AAAA", config) is not False
     )
 
-    info("DDNS[ %s ] run: %s %s", __version__, os_name, sys.platform)
-
-    # Dynamically import the dns module as configuration
-    dns_provider = str(get_config('dns', 'dnspod').lower())
-    # dns_module = __import__(
-    #     '.dns', fromlist=[dns_provider], package=__package__)
-    dns = getattr(__import__('ddns.provider', fromlist=[dns_provider]), dns_provider)
-    # dns = getattr(dns_module, dns_provider)
-    dns.Config.ID = get_config('id')
-    dns.Config.TOKEN = get_config('token')
-    dns.Config.TTL = get_config('ttl')
-
-    if get_config("config"):
-        info('loaded Config from: %s', path.abspath(get_config('config')))
-
-    proxy = get_config('proxy') or 'DIRECT'
-    proxy_list = proxy if isinstance(
-        proxy, list) else proxy.strip(';').replace(',', ';').split(';')
-
-    cache_config = get_config('cache', True)
-    if cache_config is False:
-        cache = cache_config
-    elif cache_config is True:
-        cache = Cache(path.join(gettempdir(), 'ddns.cache'))
-    else:
-        cache = Cache(cache_config)
 
-    if cache is False:
-        info('Cache is disabled!')
-    elif not get_config('config_modified_time') or get_config('config_modified_time') >= cache.time:
-        warning('Cache file is outdated.')
-        cache.clear()
+def main():
+    stdout = sys.stdout  # pythonw 模式无 stdout
+    if stdout and stdout.encoding and stdout.encoding.lower() != "utf-8" and hasattr(stdout, "buffer"):
+        # 兼容windows 和部分ASCII编码的老旧系统
+        sys.stdout = TextIOWrapper(sys.stdout.buffer, encoding="utf-8")
+        sys.stderr = TextIOWrapper(sys.stderr.buffer, encoding="utf-8")
+
+    # Windows 下输出一个空行
+    if stdout and sys.platform.startswith("win"):
+        stdout.write("\r\n")
+
+    logger.name = "ddns"
+
+    # 使用多配置加载器，它会自动处理单个和多个配置
+    configs = load_configs(__description__, __version__, build_date)
+
+    if len(configs) == 1:
+        # 单个配置，使用原有逻辑（向后兼容）
+        config = configs[0]
+        success = run(config)
+        if not success:
+            sys.exit(1)
     else:
-        debug('Cache is empty.')
-    update_ip('4', cache, dns, proxy_list)
-    update_ip('6', cache, dns, proxy_list)
+        # 多个配置，使用新的批处理逻辑
+        overall_success = True
+        for i, config in enumerate(configs):
+            # 如果log_level有值则设置setLevel
+            if hasattr(config, "log_level") and config.log_level:
+                logger.setLevel(config.log_level)
+            logger.info("Running configuration %d/%d", i + 1, len(configs))
+            # 记录当前provider
+            logger.info("Using DNS provider: %s", config.dns)
+            success = run(config)
+            if not success:
+                overall_success = False
+                logger.error("Configuration %d failed", i + 1)
+            else:
+                logger.info("Configuration %d completed successfully", i + 1)
+
+        if not overall_success:
+            logger.error("Some configurations failed")
+            sys.exit(1)
+        else:
+            logger.info("All configurations completed successfully")
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()

ddns/cache.py

@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+"""
+cache module
+文件缓存
+"""
+
+from logging import getLogger, Logger  # noqa: F401
+from os import path, stat
+from json import load, dump
+from tempfile import gettempdir
+from time import time
+
+
+class Cache(dict):
+    """
+    using file to Cache data as dictionary
+    """
+
+    def __init__(self, path, logger=None, sync=False):
+        # type: (str, Logger | None, bool) -> None
+        super(Cache, self).__init__()
+        self.__filename = path
+        self.__sync = sync
+        self.__time = time()
+        self.__changed = False
+        self.__logger = (logger or getLogger()).getChild("Cache")
+        self.load()
+
+    @property
+    def time(self):
+        """
+        缓存修改时间
+        """
+        return self.__time or 0
+
+    def load(self, file=None):
+        """
+        load data from path
+        """
+        if not file:
+            file = self.__filename
+
+        self.__logger.debug("load cache data from %s", file)
+        if file:
+            try:
+                with open(file, "r") as data:
+                    loaded_data = load(data)
+                    self.clear()
+                    self.update(loaded_data)
+                    self.__time = stat(file).st_mtime
+                    return self
+            except (IOError, OSError):
+                self.__logger.info("cache file not exist or cannot be opened")
+            except ValueError:
+                pass
+            except Exception as e:
+                self.__logger.warning(e)
+        else:
+            self.__logger.info("cache file not exist")
+
+        self.clear()
+        self.__time = time()
+        self.__changed = True
+        return self
+
+    def sync(self):
+        """Sync the write buffer with the cache files and clear the buffer."""
+        if self.__changed and self.__filename:
+            with open(self.__filename, "w") as data:
+                # 只保存非私有字段（不以__开头的字段）
+                filtered_data = {k: v for k, v in super(Cache, self).items() if not k.startswith("__")}
+                dump(filtered_data, data, separators=(",", ":"))
+                self.__logger.debug("save cache data to %s", self.__filename)
+            self.__time = time()
+            self.__changed = False
+        return self
+
+    def close(self):
+        """Sync the write buffer, then close the cache.
+        If a closed :class:`FileCache` object's methods are called, a
+        :exc:`ValueError` will be raised.
+        """
+        if self.__filename:
+            self.sync()
+        self.__filename = None
+        self.__time = None
+        self.__sync = False
+
+    def __update(self):
+        self.__changed = True
+        if self.__sync:
+            self.sync()
+        else:
+            self.__time = time()
+
+    def clear(self):
+        # 只清除非私有字段（不以__开头的字段）
+        keys_to_remove = [key for key in super(Cache, self).keys() if not key.startswith("__")]
+        if keys_to_remove:
+            for key in keys_to_remove:
+                super(Cache, self).__delitem__(key)
+            self.__update()
+
+    def get(self, key, default=None):
+        """
+        获取指定键的值，如果键不存在则返回默认值
+        :param key: 键
+        :param default: 默认值
+        :return: 键对应的值或默认值
+        """
+        if key is None and default is None:
+            return {k: v for k, v in super(Cache, self).items() if not k.startswith("__")}
+        return super(Cache, self).get(key, default)
+
+    def __setitem__(self, key, value):
+        if self.get(key) != value:
+            super(Cache, self).__setitem__(key, value)
+            # 私有字段（以__开头）不触发同步
+            if not key.startswith("__"):
+                self.__update()
+
+    def __delitem__(self, key):
+        # 检查键是否存在，如果不存在则直接返回，不抛错
+        if not super(Cache, self).__contains__(key):
+            return
+        super(Cache, self).__delitem__(key)
+        # 私有字段（以__开头）不触发同步
+        if not key.startswith("__"):
+            self.__update()
+
+    def __getitem__(self, key):
+        return super(Cache, self).__getitem__(key)
+
+    def __iter__(self):
+        # 只迭代非私有字段（不以__开头的字段）
+        for key in super(Cache, self).__iter__():
+            if not key.startswith("__"):
+                yield key
+
+    def __items__(self):
+        # 只返回非私有字段（不以__开头的字段）
+        return ((key, value) for key, value in super(Cache, self).items() if not key.startswith("__"))
+
+    def __len__(self):
+        # 不计算以__开头的私有字段
+        return len([key for key in super(Cache, self).keys() if not key.startswith("__")])
+
+    def __contains__(self, key):
+        return super(Cache, self).__contains__(key)
+
+    def __str__(self):
+        return super(Cache, self).__str__()
+
+    def __del__(self):
+        self.close()
+
+    @staticmethod
+    def new(config_cache, hash, logger):
+        # type: (str|bool, str, Logger) -> Cache|None
+        """
+        new cache from a file path.
+        :param path: Path to the cache file.
+        :param logger: Optional logger for debug messages.
+        :return: Cache instance with loaded data.
+        """
+        if config_cache is False:
+            cache = None
+        elif config_cache is True:
+            cache_path = path.join(gettempdir(), "ddns.%s.cache" % hash)
+            cache = Cache(cache_path, logger)
+        else:
+            cache = Cache(config_cache, logger)
+
+        if cache is None:
+            logger.debug("Cache is disabled!")
+        elif cache.time + 72 * 3600 < time():  # 72小时有效期
+            logger.info("Cache file is outdated.")
+            cache.clear()
+        elif len(cache) == 0:
+            logger.debug("Cache is empty.")
+        else:
+            logger.debug("Cache loaded with %d entries.", len(cache))
+        return cache

ddns/ip.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python
+# -*- coding:utf-8 -*-
+from re import compile
+from os import name as os_name, popen
+from socket import socket, getaddrinfo, gethostname, AF_INET, AF_INET6, SOCK_DGRAM
+from logging import debug, error
+
+from .util.http import request
+
+# 模块级别的SSL验证配置，默认使用auto模式
+ssl_verify = "auto"
+
+# IPV4正则
+IPV4_REG = r"((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])"
+# IPV6正则
+# https://community.helpsystems.com/forums/intermapper/miscellaneous-topics/5acc4fcf-fa83-e511-80cf-0050568460e4
+IPV6_REG = r"((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))"  # noqa: E501
+
+# 公网IPv4 API列表，按优先级排序
+PUBLIC_IPV4_APIS = [
+    "https://api.ipify.cn",
+    "https://api.ipify.org",
+    "https://4.ipw.cn/",
+    "https://ipinfo.io/ip",
+    "https://api-ipv4.ip.sb/ip",
+    "http://checkip.amazonaws.com",
+]
+
+# 公网IPv6 API列表，按优先级排序
+PUBLIC_IPV6_APIS = [
+    "https://api6.ipify.org/",
+    "https://6.ipw.cn/",
+    "https://api-ipv6.ip.sb/ip",
+    "http://ipv6.icanhazip.com",
+]
+
+
+def default_v4():  # 默认连接外网的ipv4
+    s = socket(AF_INET, SOCK_DGRAM)
+    s.connect(("1.1.1.1", 53))
+    ip = s.getsockname()[0]
+    s.close()
+    return ip
+
+
+def default_v6():  # 默认连接外网的ipv6
+    s = socket(AF_INET6, SOCK_DGRAM)
+    s.connect(("1:1:1:1:1:1:1:1", 8))
+    ip = s.getsockname()[0]
+    s.close()
+    return ip
+
+
+def local_v6(i=0):  # 本地ipv6地址
+    info = getaddrinfo(gethostname(), 0, AF_INET6)
+    debug(info)
+    return info[int(i)][4][0]
+
+
+def local_v4(i=0):  # 本地ipv4地址
+    info = getaddrinfo(gethostname(), 0, AF_INET)
+    debug(info)
+    return info[int(i)][-1][0]
+
+
+def _open(url, reg):
+    try:
+        debug("open: %s", url)
+        # IP 模块重试3次
+        response = request("GET", url, verify=ssl_verify, retries=2)
+        res = response.body
+        debug("response: %s", res)
+        match = compile(reg).search(res)
+        if match:
+            return match.group()
+        error("No match found in response: %s", res)
+    except Exception as e:
+        error(e)
+
+
+def _try_multiple_apis(api_list, reg, ip_type):
+    """
+    Try multiple API endpoints until one succeeds
+    """
+    for url in api_list:
+        try:
+            debug("Trying %s API: %s", ip_type, url)
+            result = _open(url, reg)
+            if result:
+                debug("Successfully got %s from %s: %s", ip_type, url, result)
+                return result
+            else:
+                debug("No valid IP found from %s", url)
+        except Exception as e:
+            debug("Failed to get %s from %s: %s", ip_type, url, e)
+    return None
+
+
+def public_v4(url=None, reg=IPV4_REG):  # 公网IPV4地址
+    if url:
+        # 使用指定URL
+        return _open(url, reg)
+    else:
+        # 使用多个API自动重试
+        return _try_multiple_apis(PUBLIC_IPV4_APIS, reg, "IPv4")
+
+
+def public_v6(url=None, reg=IPV6_REG):  # 公网IPV6地址
+    if url:
+        # 使用指定URL
+        return _open(url, reg)
+    else:
+        # 使用多个API自动重试
+        return _try_multiple_apis(PUBLIC_IPV6_APIS, reg, "IPv6")
+
+
+def _ip_regex_match(parrent_regex, match_regex):
+    ip_pattern = compile(parrent_regex)
+    matcher = compile(match_regex)
+
+    if os_name == "nt":  # windows:
+        cmd = "ipconfig"
+    else:
+        cmd = "ip address || ifconfig 2>/dev/null"
+
+    for s in popen(cmd).readlines():
+        addr = ip_pattern.search(s)
+        if addr and matcher.match(addr.group(1)):
+            return addr.group(1)
+
+
+def regex_v4(reg):  # ipv4 正则提取
+    if os_name == "nt":  # Windows: IPv4 xxx: 192.168.1.2
+        regex_str = r"IPv4 .*: ((?:\d{1,3}\.){3}\d{1,3})\W"
+    else:
+        regex_str = r"inet (?:addr\:)?((?:\d{1,3}\.){3}\d{1,3})[\s/]"
+    return _ip_regex_match(regex_str, reg)
+
+
+def regex_v6(reg):  # ipv6 正则提取
+    if os_name == "nt":  # Windows: IPv4 xxx: ::1
+        regex_str = r"IPv6 .*: ([\:\dabcdef]*)?\W"
+    else:
+        regex_str = r"inet6 (?:addr\:\s*)?([\:\dabcdef]*)?[\s/%]"
+    return _ip_regex_match(regex_str, reg)