apertodns 1.2.5 → 2.0.0

package/README.md

@@ -11,16 +11,19 @@ ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your
 
 ## Why ApertoDNS?
 
-| Feature | ApertoDNS | No-IP | DuckDNS | Dynu |
-|---------|-----------|-------|---------|------|
-| Free subdomains | Unlimited | 1 (free) | 5 | 4 |
-| API Keys with scopes | Yes | No | No | Limited |
+| Feature | ApertoDNS | Dyn (Oracle) | No-IP | DuckDNS |
+|---------|-----------|--------------|-------|---------|
+| Free plan | Yes | No ($55/yr) | Yes | Yes |
+| Free subdomains | Unlimited | 0 | 1 | 5 |
+| API Keys with scopes | Yes | No | No | No |
 | CLI tool | Yes | No | No | No |
-| IPv6 support | Yes | Paid | Yes | Yes |
-| No forced renewal | Yes | 30 days | Yes | Yes |
-| DynDNS2 compatible | Yes | Yes | No | Yes |
+| Docker images | Yes | No | No | No |
+| IPv6 support | Yes | Paid | Paid | Yes |
+| No forced renewal | Yes | N/A | 30 days | Yes |
+| DynDNS2 compatible | Yes | Yes | Yes | No |
 | Webhooks | Yes | No | No | No |
 | Team sharing | Yes | No | No | No |
+| Open Source | Yes | No | No | No |
 
 ## Features
 
@@ -33,6 +36,7 @@ ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your
 - **IPv4 & IPv6** - Full dual-stack support
 - **Real-time Stats** - View usage statistics and logs
 - **Router/NAS Compatible** - Works with Synology, QNAP, and DynDNS2-compatible routers
+- **Docker Images** - Official [apertodns/cli](https://hub.docker.com/r/apertodns/cli) and [apertodns/updater](https://hub.docker.com/r/apertodns/updater) images
 
 ## Requirements
 
@@ -123,7 +127,15 @@ apertodns --force
 | `--config` | Edit configuration |
 | `--logout` | Remove local configuration |
 | `--force` | Force DNS update now |
-| `--update` | Standalone DynDNS2 update (with `--domain` and `--token`) |
+
+### Standalone Update (DynDNS2)
+
+| Command | Description |
+|---------|-------------|
+| `--update` | Standalone DynDNS2 update (no config required) |
+| `--domain <fqdn>` | Domain to update (with --update) |
+| `--token <token>` | Token for authentication (with --update) |
+| `--ip <address>` | Custom IP address (optional, auto-detected if omitted) |
 
 ### Daemon Mode
 
@@ -185,6 +197,49 @@ apertodns --daemon
 apertodns --daemon --interval 60
 ```
 
+## Standalone Update
+
+Update DNS without any saved configuration - perfect for scripts and one-off updates:
+
+```bash
+# Auto-detect IP and update
+apertodns --update --domain myserver.apertodns.com --token YOUR_TOKEN
+
+# Specify custom IP
+apertodns --update --domain myserver.apertodns.com --token YOUR_TOKEN --ip 203.0.113.42
+```
+
+## Docker
+
+Run without installing Node.js:
+
+```bash
+# Run CLI via Docker
+docker run --rm apertodns/cli --help
+
+# Interactive setup (persisted config)
+docker run -it -v apertodns_config:/root/.config/apertodns apertodns/cli --setup
+
+# List domains
+docker run -v apertodns_config:/root/.config/apertodns apertodns/cli --domains
+
+# Standalone update (no config needed)
+docker run --rm apertodns/cli --update --domain myhost.apertodns.com --token YOUR_TOKEN
+```
+
+For continuous updates, use the dedicated updater image:
+
+```bash
+docker run -d \
+  --name apertodns-updater \
+  --restart unless-stopped \
+  -e TOKEN=your_token \
+  -e DOMAINS=myhost.apertodns.com \
+  apertodns/updater
+```
+
+See [Docker Hub](https://hub.docker.com/r/apertodns/cli) for more options.
+
 ## Automatic Updates (Cron)
 
 Set up automatic IP updates with cron:

package/index.js

@@ -173,14 +173,6 @@ const daemonInterval = args.includes("--interval") ? parseInt(args[args.indexOf(
 const showMyIp = args.includes("--my-ip") || args.includes("--ip");
 const logout = args.includes("--logout");
 
-// Standalone update command (like docker updater)
-const standaloneUpdate = args.includes("--update");
-const updateDomain = args.includes("--domain") ? args[args.indexOf("--domain") + 1] : null;
-const updateToken = args.includes("--token") ? args[args.indexOf("--token") + 1] : null;
-const updateIp = args.includes("--ip") && args.indexOf("--ip") !== args.indexOf("--my-ip")
-  ? args[args.indexOf("--ip") + 1]
-  : null;
-
 // JSON output helper
 const jsonOutput = (data) => {
   if (showJson) {
@@ -234,12 +226,6 @@ ${chalk.bold("CONFIGURAZIONE:")}
   ${cyan("--logout")}             Rimuovi configurazione locale
   ${cyan("--force")}              Forza aggiornamento DNS
 
-${chalk.bold("AGGIORNAMENTO STANDALONE:")}
-  ${cyan("--update")}             Aggiorna DNS via DynDNS2 (richiede --domain e --token)
-  ${cyan("--domain")} <name>      Dominio da aggiornare (es: myhost.apertodns.com)
-  ${cyan("--token")} <token>      Token DDNS per l'autenticazione
-  ${cyan("--ip")} <ip>            IP da impostare (opzionale, auto-detect se omesso)
-
 ${chalk.bold("DAEMON MODE:")}
   ${cyan("--daemon")}             Avvia in modalità daemon (aggiornamento continuo)
   ${cyan("--interval")} <sec>     Intervallo aggiornamento daemon (default: 300s)
@@ -267,8 +253,6 @@ ${gray("Esempi:")}
   ${gray("$")} apertodns --test mioserver.apertodns.com
   ${gray("$")} apertodns --daemon --interval 60
   ${gray("$")} apertodns --api-key ak_xxx... --domains --json
-  ${gray("$")} apertodns --update --domain myhost.apertodns.com --token abc123
-  ${gray("$")} apertodns --update --domain myhost.apertodns.com --token abc123 --ip 1.2.3.4
 
 ${gray("Docs: https://apertodns.com/docs")}
 `);
@@ -318,8 +302,8 @@ const spinner = (text) => ora({ text, spinner: "dots", color: "yellow" });
 
 // Helper: get auth headers (supports both JWT and API Key)
 const getAuthHeaders = (token) => {
-  // API Keys start with "ak_"
-  if (token && token.startsWith('ak_')) {
+  // API Keys start with "ak_" or "apertodns_live_" or "apertodns_test_"
+  if (token && (token.startsWith('ak_') || token.startsWith('apertodns_live_') || token.startsWith('apertodns_test_'))) {
     return { 'X-API-Key': token };
   }
   return { Authorization: `Bearer ${token}` };
@@ -1602,96 +1586,6 @@ const runDaemonMode = async () => {
   setInterval(update, daemonInterval * 1000);
 };
 
-// ==================== STANDALONE UPDATE (DynDNS2) ====================
-
-const runStandaloneUpdate = async (domain, token, customIp) => {
-  // Validate required parameters
-  if (!domain || !token) {
-    if (showJson) {
-      console.log(JSON.stringify({
-        error: "Parametri mancanti. Usa: --update --domain <domain> --token <token> [--ip <ip>]"
-      }));
-    } else {
-      console.log(red("\n❌ Parametri mancanti."));
-      console.log(gray("   Uso: apertodns --update --domain <domain> --token <token> [--ip <ip>]\n"));
-    }
-    process.exit(1);
-  }
-
-  const spin = !showJson ? spinner("Aggiornamento DNS via DynDNS2...").start() : null;
-
-  try {
-    // Get current IP if not provided
-    let ipToUse = customIp;
-    if (!ipToUse) {
-      if (spin) spin.text = "Rilevamento IP pubblico...";
-      ipToUse = await getCurrentIP('https://api.ipify.org');
-      if (!ipToUse) {
-        throw new Error("Impossibile rilevare IP pubblico");
-      }
-      ipToUse = ipToUse.trim();
-    }
-
-    if (spin) spin.text = `Aggiornamento ${domain} → ${ipToUse}...`;
-
-    // Build DynDNS2 URL
-    const updateUrl = `https://api.apertodns.com/nic/update?hostname=${encodeURIComponent(domain)}&myip=${encodeURIComponent(ipToUse)}`;
-
-    // Make request with Basic Auth (DynDNS2 protocol)
-    const authHeader = 'Basic ' + Buffer.from(`${domain}:${token}`).toString('base64');
-
-    const res = await fetch(updateUrl, {
-      method: 'GET',
-      headers: {
-        'Authorization': authHeader,
-        'User-Agent': `ApertoDNS-CLI/${CURRENT_VERSION}`
-      }
-    });
-
-    const responseText = await res.text();
-
-    // Parse DynDNS2 response
-    const isSuccess = responseText.startsWith('good') || responseText.startsWith('nochg');
-
-    if (isSuccess) {
-      spin?.succeed(`DNS aggiornato! ${domain} → ${ipToUse}`);
-
-      if (showJson) {
-        console.log(JSON.stringify({
-          success: true,
-          domain,
-          ip: ipToUse,
-          response: responseText.trim(),
-          timestamp: new Date().toISOString()
-        }, null, 2));
-      } else if (!isCron) {
-        console.log(`   ${gray('Risposta:')} ${green(responseText.trim())}`);
-        console.log();
-      }
-    } else {
-      spin?.fail(`Errore aggiornamento: ${responseText.trim()}`);
-
-      if (showJson) {
-        console.log(JSON.stringify({
-          success: false,
-          domain,
-          ip: ipToUse,
-          error: responseText.trim(),
-          timestamp: new Date().toISOString()
-        }, null, 2));
-      }
-      process.exit(1);
-    }
-  } catch (err) {
-    spin?.fail(`Errore: ${err.message}`);
-
-    if (showJson) {
-      console.log(JSON.stringify({ error: err.message }));
-    }
-    process.exit(1);
-  }
-};
-
 // ==================== LOGOUT ====================
 
 const runLogout = async () => {
@@ -1804,7 +1698,6 @@ const interactiveMode = async () => {
 const main = async () => {
   try {
     if (logout) await runLogout();
-    else if (standaloneUpdate) await runStandaloneUpdate(updateDomain, updateToken, updateIp);
     else if (showMyIp) await showMyIpCommand();
     else if (runDaemon) await runDaemonMode();
     else if (enableTokenId) await updateTokenState(enableTokenId, true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apertodns",
-  "version": "1.2.5",
+  "version": "2.0.0",
   "description": "ApertoDNS CLI - Dynamic DNS management from your terminal. Manage domains, tokens, API keys and DNS updates with style.",
   "main": "index.js",
   "type": "module",