{"id":31645662,"url":"https://github.com/maxking/proxmox-dns-server","last_synced_at":"2025-10-07T05:15:42.921Z","repository":{"id":307824809,"uuid":"1030809383","full_name":"maxking/proxmox-dns-server","owner":"maxking","description":"DNS server for all VMs and Container running based on their name and id.","archived":false,"fork":false,"pushed_at":"2025-08-31T12:25:49.000Z","size":5994,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-31T12:25:58.592Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxking.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-08-02T11:20:59.000Z","updated_at":"2025-08-31T12:25:52.000Z","dependencies_parsed_at":"2025-08-02T13:24:25.272Z","dependency_job_id":"3f0f1d4c-e24e-4439-b7a4-6434ee95199b","html_url":"https://github.com/maxking/proxmox-dns-server","commit_stats":null,"previous_names":["maxking/proxmox-dns-server"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/maxking/proxmox-dns-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxking%2Fproxmox-dns-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxking%2Fproxmox-dns-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxking%2Fproxmox-dns-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxking%2Fproxmox-dns-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxking","download_url":"https://codeload.github.com/maxking/proxmox-dns-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxking%2Fproxmox-dns-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278722757,"owners_count":26034463,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-10-07T05:15:21.900Z","updated_at":"2025-10-07T05:15:42.914Z","avatar_url":"https://github.com/maxking.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Proxmox DNS Server\n\nAn authoritative DNS server for Proxmox VE that resolves DNS names based on VM and LXC container names and IDs.\n\nI use it to give DNS names to my containers/VMs to set CNAME records for my services, when the IP address changes, it is automatically reflected without having to manually change my service's DNS records.\n\n## Features\n\n- Resolves DNS queries for Proxmox VMs and LXC containers\n- Supports both ID-based and name-based resolution\n- Filters to IPv4 addresses starting with 192.168.x.x\n- Runs as an authoritative DNS server for a specified zone\n- Automatic refresh of instance information every 30 seconds\n\n## Installation\n\n```\nwget https://git.araj.me/maxking/proxmox-dns-server/raw/branch/master/install.sh\nchmod +x install.sh\n./install.sh -p 5353 -z p01.araj.me\n```\n\nUse the right zone `p01.araj.me` or whatever prefix you want.\n\n## Usage\n\n```bash\n# Build the application\ngo build -o proxmox-dns-server\n\n# Run with zone specification\n./proxmox-dns-server -zone p01.araj.me\n\n# Run on custom port\n./proxmox-dns-server -zone p01.araj.me -port 5353\n```\n\n\n## DNS Resolution Examples\n\nFor zone `p01.araj.me`:\n\n- `102.p01.araj.me` → IP address of container/VM with ID 102\n- `mycontainer.p01.araj.me` → IP address of container/VM named \"mycontainer\"\n\n## Requirements\n\n- Must run on the Proxmox VE node. This can be relaxed at some\n  point if we can figure out how to get the IP addresses of\n  containers. VMs IPs are available over API but from what I can\n  find, I couldn't easily get a container's IP.\n- Requires permission to execute `pct` and `qm` commands so we\n  can get the IP address.\n- Only resolves IPv4 addresses starting with 192.168.x.x. This currently because\n  that's how I use it. If you feel like using this and would like a configuration\n  for this, open a issue or even better, a PR. We might be also able to support\n  like a configuration of sorts to define the interface.\n\n## Permissions\n\nThe application needs to run with sufficient privileges to execute Proxmox commands:\n- `pct list` and `pct exec` for LXC containers\n- `qm list` and `qm guest cmd` for VMs","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxking%2Fproxmox-dns-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxking%2Fproxmox-dns-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxking%2Fproxmox-dns-server/lists"}