{"id":16240059,"url":"https://github.com/boris1993/dnsupdater","last_synced_at":"2025-03-19T16:31:43.325Z","repository":{"id":50303423,"uuid":"152875930","full_name":"boris1993/dnsupdater","owner":"boris1993","description":"Automatically update your DNS record to match your current external IP address","archived":false,"fork":false,"pushed_at":"2024-01-24T12:04:16.000Z","size":1298,"stargazers_count":28,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-17T09:11:22.746Z","etag":null,"topics":["aliyun-ddns","aliyun-dns","cloudflare","cloudflare-api","cloudflare-ddns","cloudflare-dns","ddns","dnsupdater","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boris1993.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-13T13:41:59.000Z","updated_at":"2025-02-14T06:37:19.000Z","dependencies_parsed_at":"2023-12-06T16:28:24.158Z","dependency_job_id":"1559aefa-27fe-48a6-bac5-ad4108e14009","html_url":"https://github.com/boris1993/dnsupdater","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fdnsupdater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fdnsupdater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fdnsupdater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boris1993%2Fdnsupdater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boris1993","download_url":"https://codeload.github.com/boris1993/dnsupdater/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244463824,"owners_count":20456944,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aliyun-ddns","aliyun-dns","cloudflare","cloudflare-api","cloudflare-ddns","cloudflare-dns","ddns","dnsupdater","go","golang"],"created_at":"2024-10-10T13:46:04.023Z","updated_at":"2025-03-19T16:31:42.744Z","avatar_url":"https://github.com/boris1993.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dnsupdater\n[![Build](https://github.com/boris1993/dnsupdater/actions/workflows/build.yml/badge.svg)](https://github.com/boris1993/dnsupdater/actions/workflows/build.yml)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/boris1993/dnsupdater)](https://github.com/boris1993/dnsupdater/releases/latest)\n![Total download](https://img.shields.io/github/downloads/boris1993/dnsupdater/total.svg)\n\n[中文版](README_zh_cn.md)\n\nThis app allows you updating your DNS records with your current external IP address.\n\nIt is recommended to run this program in your home server, or in your router。\n\nYou should **NEVER** run this program behind a proxy or a VPN. \nRunning it behind a proxy is an unconsidered and untested scenario.\n\n## How-to\n\n+ Download the [latest release](https://github.com/boris1993/dnsupdater/releases/latest) for your target\n\n+ Extract the archive.\n\n+ Rename `config.yaml.template` to `config.yaml`.\n\n+ Finish your configuration in the `config.yaml`\n\n+ Upload `dnsupdater` and `config.yaml` to the device you want this app to run. \nThese 2 files must be under the same directory.\n\n+ Set up a cron job like\n\n```cron\n0 0,12 * * * /home/yourname/dnsupdater/dnsupdater \u003e /var/log/update-dns.log 2\u003e\u00261 \u0026\n```\n\n## Important notes in configuration\n\n+ The `APIKey` for your CloudFlare records should be a dedicated API token. \nYou can generate one [here](https://dash.cloudflare.com/profile/api-tokens) with template `Edit zone DNS`.\n\n+ Do not modify the property `RegionID` for your Aliyun DNS records. `cn-hangzhou` is the only accepted value for now. \n\n+ About JSON path\n\nHere's a list of operators used in JSON path:\n\n| Operator                  | Description                                                     |\n|:--------------------------|:----------------------------------------------------------------|\n| `$`                       | The root element to query. This starts all path expressions.    |\n| `@`                       | The current node being processed by a filter predicate.         |\n| `*`                       | Wildcard. Available anywhere a name or numeric are required.    |\n| `..`                      | Deep scan. Available anywhere a name is required.               |\n| `.\u003cname\u003e`                 | Dot-notated child                                               |\n| `['\u003cname\u003e' (, '\u003cname\u003e')]` | Bracket-notated child or children                               |\n| `[\u003cnumber\u003e (, \u003cnumber\u003e)]` | Array index or indexes                                          |\n| `[start:end]`             | Array slice operator                                            |\n| `[?(\u003cexpression\u003e)]`       | Filter expression. Expression must evaluate to a boolean value. |\n\nSo if you have a JSON like this:\n\n```json\n\n{\n  \"ip\": \"103.156.184.21\",\n  \"tz\": \"Asia/Taipei\"\n}\n```\n\nYou can use `$.ip` to obtain the value in the field `ip`.\n\n## Build for other platforms\n\nYou can check for all preset targets by running the scripts in the `scripts` folder.\n\nFor Windows users:\n\n```cmd\nbuild.bat /?\n```\n\nFor *NIX users:\n\n```bash\nmake help\n```\n\nOr you can specify your own `GOARCH` and `GOOS` (and maybe `GOMIPS`) with `go build` command \nto build the executable for your platform as long as Go provides support to it.  \n\n## License\n\nLicensed under [MIT](LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboris1993%2Fdnsupdater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboris1993%2Fdnsupdater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboris1993%2Fdnsupdater/lists"}