akanealw/Charon
1
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

chore: clean .gitignore cache

Browse Source
This commit is contained in:
GitHub Actions
2026-01-26 19:21:33 +00:00
parent 1b1b3a70b1
commit e5f0fec5db
1483 changed files with 0 additions and 472793 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
plugins/powerdns/README.md
View File

@@ -1,35 +0,0 @@
# PowerDNS Plugin for Charon
This is an example DNS provider plugin for Charon that adds support for PowerDNS Authoritative Server.
## Building
To build this plugin, you **must** use `CGO_ENABLED=1` and the same Go version as the Charon binary:
```bash
cd plugins/powerdns
CGO_ENABLED=1 go build -buildmode=plugin -o ../powerdns.so main.go
```
## Installation
1. Build the plugin as shown above
2. Copy `powerdns.so` to `/app/plugins/` (or your configured plugin directory)
3. Restart Charon to load the plugin
4. The PowerDNS provider will appear in the DNS providers list
## Configuration
The PowerDNS plugin requires:
- **API URL**: The PowerDNS HTTP API endpoint (e.g., `https://pdns.example.com:8081`)
- **API Key**: Your PowerDNS API key (X-API-Key header value)
- **Server ID** (optional): PowerDNS server ID (default: `localhost`)
## Caddy Requirement
This plugin only handles the Charon UI/API integration. To use PowerDNS for DNS challenges, Caddy must be built with the [caddy-dns/powerdns](https://github.com/caddy-dns/powerdns) module.
## Security
Always verify the plugin source before loading it. Plugins run in the same process as Charon and have full access to system resources.