Skip to content

心爱酱多节点智能解析平台,实现多节点智能 DDNS 分线路解析 | Cocoa-Chan Smart Muti-Node DDNS Platform, Auto Update DNS Record With Muti-ISP-Line Supported

License

Notifications You must be signed in to change notification settings

luckykeeper/CocoaSyncer

Repository files navigation

CocoaSyncer


简介

这只超·可爱的心爱酱~ 提供了多节点(目前支持双节点)的 DDNS 分线路智能解析能力(目前支持阿里 DDNS),将一个域名被不同线路访问时引导至不同 IP 的服务器上,在节点故障时能自动将服务转移到正常工作的节点,适合有多条动态公网 IP 线路的用户对访问流量做 DNS 级别的分流,提升带宽利用率,改善用户访问速度,提升访问体验

支持线路:

  • 默认(未命中其它所有规则的按照这里的值解析)
  • 中国电信
  • 中国联通
  • 中国移动
  • 中国教育网
  • 海外

使用场景

在不同地点有多个动态公网 IP 线路的用户,希望能够将同一域名的流量分摊到不同线路上,举例如下:

有动态公网 IP 线路 A=>电信B=>移动,站点访问流量较大,单条线路的上传带宽难以满足访问需求,访问体验较差。希望将访问www.example.com 的电信和海外和其它线路的访客引导至电信线路,联通、移动和教育网线路的访客引导至移动线路。以此减轻单条线路的带宽压力和单个服务器的性能消耗

通常 DDNS 软件只能做到单节点单线路的 DDNS ,访问一个域名的所有流量都会到一个 IP 上面去,而 CocoaSyncer 就可以解决这个问题,同时提供了一定的高可用,当两个节点之一故障时,程序会自动切换为单节点模式,把服务解析到正常工作的线路,如上面的例子,假如 B 移动线路所在地停电了,那么程序就会把 B 上面解析的服务全部切到 A 上,在 B 来电恢复正常之后,又会回到多节点解析模式,一定程度上防止了单点故障,所以我称之为“智能解析平台”

食用方法

下载

Release 下有打包好的各平台的二进制运行文件,请根据自己使用的平台选择下载

环境准备

  • CocoaSyncer 需要一个数据库存储数据,由于使用了 xorm 做为数据库引擎,理论上支持多种数据库,在源码中我提供了 sqlite3 、postgres 和 mysql 三种数据库的驱动支持,但是目前仅测试了 mysql 数据库,其余数据库不保证兼容,感兴趣的话欢迎测试并反馈。因此,推荐准备一个 mysql 数据库,编码推荐 utf8mb4
  • 填写目录下的 config.yaml ,参照文件内说明即可,把这个文件和 Release 放在一个文件夹里面
  • 反代 or 开放 API 端口到外网,绑定一个域名给 CocoaSyncer (如果需要嵌入 Badge 信息,很可能你需要绑定两个域名)

本体( leader )

本体和分身都是同一个二进制文件,程序不分服务端和客户端,由 config 配置决定是本体还是分身

完成配置文件填写后执行 ./cocoaSyncer r即可运行

分身( follower )

本体和分身都是同一个二进制文件,程序不分服务端和客户端,由 config 配置决定是本体还是分身

完成配置文件填写后执行 ./cocoaSyncer r即可运行

CLI

不带参数直接运行即可看到提示,命令可以用缩写执行,缩写是逗号后面那个,比如 runProd 可以简写为 r

NAME:
   CocoaSyncer - CocoaSyncer - 心爱酱多节点智能解析平台
                 Powered By Luckykeeper <[email protected] | https://luckykeeper.site>
                 ————————————————————————————————————————
                 注意:使用前需要先填写同目录下 config.yaml !

USAGE:
   CocoaSyncer [global options] command [command options] [arguments...]

VERSION:
   1.0.0_build20230918

COMMANDS:
   runProd, r                      启动 CocoaSyncer (生产环境)
   runDebug, rd                    启动 CocoaSyncer (调试)
   showStatus, status              输出当前运行状态
   updateCloudPlatformInfo, dns    更新云平台信息(更新 DNS API 账户)
   updateManagedServices, service  更新服务信息(要 DDNS 的域名)
   updateNodeInfo, node            更新节点信息(CocoaSyncer)
   help, h                         Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

COPYRIGHT:
   Luckykeeper <[email protected] | https://luckykeeper.site> | https://github.com/luckykeeper

基础配置

流程如下:启动->添加节点[node]->添加 DDNS (提供商)信息[dns]->添加服务[service]

请务必按照这个顺序执行

特别提示,所有的线路和解析需要先在域名服务商那边添加一条解析,解析的 IP 是什么不要紧,但是得有一个解析,程序只负责更新解析记录,不会创建或删除解析记录

启动

./cocoaSyncer r ,用 nohup / screen / systemd simple 服务挂在后台,做开机启动

添加节点

另起一个终端

./cocoaSyncer node 添加节点,注意这个操作只能在 leader 侧执行, follower 侧无权执行此命令

添加云服务商信息

./cocoaSyncer dns 添加云服务商信息,基本上是 AccessKey + AccessSecret 的形式,注意这个操作只能在 leader 侧执行, follower 侧无权执行此命令

添加服务

./cocoaSyner service 添加你的服务(要 DDNS 的域名),注意这个操作只能在 leader 侧执行, follower 侧无权执行此命令

展示

在终端执行 ./cocoaSyner status 可以看详细的数据,在 web /v1/status 获取非敏感运行数据

如果需要在 web 展示访客正在使用那台服务器,可以贴上 /v1/badge 的 badge ,效果类似下面这样,右边会自动显示为节点友好名称(1.0.2 版 Badge 新增了在线节点显示),推荐不要超过 11 个英文字符

监控

/metrics是监控端口,你需要使用 Prometheus + Grafana 来进行监控和展示,乃至告警,这里提供 Prometheus 的模板和,Grafana 的仪表盘 json 文件 ./grafana/CocoaSyncer.json ,仪表盘预览参考如下

仪表盘预览 点击展开/收合图片

Prometheus yaml 文件模板

- job_name: "CocoaSyncer"

    static_configs:
      - targets: ["<IP>:<API 端口>"]

接口文档

doc 目录下 ./doc/接口文档.md 下给出了所有 HTTP 接口的文档,请自行查阅

另外使用 runDebug 运行的时候可以在 /v1/swagger/index.html 查阅 Swagger 文档,当使用 runProd 时这个地址会返回 404 ,生产环境请务必使用 runProd 运行

小工具合集

优香酱小工具系列

心爱酱小工具系列

  • GitHub - luckykeeper/CocoaSyncer: 心爱酱多节点智能解析平台,实现多节点智能 DDNS 分线路解析 | Cocoa-Chan Smart Muti-Node DDNS Platform, Auto Update DNS Record With Muti-ISP-Line Supported https://github.com/luckykeeper/CocoaSyncer
  • GitHub - luckykeeper/CocoaPush: 心爱酱钉钉消息推送机器人,让可爱的心爱酱帮你照看各个设备的运行状态 | Let Kawaii Cocoa-Chan to monitor device running status https://github.com/luckykeeper/CocoaSyncer

💈就要在这里立法典!

嘿嘿 心爱酱 嘿嘿

对于拿着奶糖苹果的心爱酱,我的评价是四个字:好有感觉。我主要想注重于两点,来阐述我对于心爱酱的拙见:第一,我非常喜欢心爱酱。首先看心爱酱的立绘,心爱酱虽然看起来好好穿了学校制服,但是心爱酱好好地对制服做了一圈改造,整体都换成了心爱粉,看起来非常的搭,而且还在各个地方放上了点心做装饰,她不仅仅在裙子上系糖果,她还挂手串,手串还挂糖果,(真的好可爱),(倒吸一口凉气)我的妈呀,这已经到了仅仅是看一眼都能让人癫狂的程度,我就不多说了。第二,我非常喜欢粉毛。这是在很久很久之前,在认识心爱酱之前,完完全全的xp使然。心爱酱的粉毛长长的,软软的,香香的,吸起来非常的爽,真的好棒,好有感觉!然而心爱酱她不仅是粉毛,她还是粉长毛,她还系发带,她竟然还不好好系发带,她甚至在发带上挂巧克力。然而心爱酱的糖果只是装饰,她真的只是给你看一眼,哈哈。与其说心爱酱让我很有感觉,不如说心爱酱是为了我的xp量身定做的。抛开这一切因素,只看性格,心爱酱也是数一数二的好女孩:会做饭,会卖萌,活力十足,有时候又呆呆的,尤其是拿走她的奶糖苹果的时候,超可爱的~;心爱酱甚至还会变身和超进化,太酷辣!我好想和心爱一起养一只小心爱酱当女儿,所以想在这里问一下大家,要买怎样的枕头才能做这样的梦呢?心爱酱是越看越可爱的(流口水),不说了,我这就去做梦去!

特别鸣谢

About

心爱酱多节点智能解析平台,实现多节点智能 DDNS 分线路解析 | Cocoa-Chan Smart Muti-Node DDNS Platform, Auto Update DNS Record With Muti-ISP-Line Supported

Topics

Resources

License

Stars

Watchers

Forks