Differences

This shows you the differences between two versions of the page.

--- omv8:omv8_plugins:wireguard [2025/12/31 08:34] – [Update DuckDNS IP, receive notifications only when it changes, and restart the tunnel if needed] chente
+++ omv8:omv8_plugins:wireguard [2025/12/31 08:57] (current) – [Update DuckDNS IP, receive notifications only when it changes, and restart the tunnel if needed] chente
@@ Line 564: / Line 564: @@
 Useful for securing persistent connections between servers, e.g., for backups.
-WireGuard tunnel naming in OMV-extras plugin
+**WireGuard tunnel naming in OMV-extras plugin**
   * Standard tunnels:
-    * Tunnel 1 → ''wgnet1''
+    * Tunnel number 1 → ''wgnet1''
-    * Tunnel 2 → ''wgnet2''
+    * Tunnel number 2 → ''wgnet2'' …
-    * Tunnel 3 → ''wgnet3'' …
   * Custom tunnels:
     * The plugin automatically prefixes the name with ''wgnet_''.
-      * Example: if you name your custom tunnel pp, its internal name will be ''wgnet_pp''.
+      * Example: if you name your custom tunnel ''pp'', its internal name will be ''wgnet_pp''.
-      * Example: if you name it backup, its internal name will be ''wgnet_backup''.
+      * Example: if you name it ''backup'', its internal name will be ''wgnet_backup''.
 Summary:
-  * Standard: wgnet1, wgnet2, wgnet3 …
+  * Standard: ''wgnet1'', ''wgnet2'' …
-  * Custom: wgnet_<your_custom_name>
+  * Custom: ''wgnet_<your_custom_name>''
 Important: The TUNNELS variable in the scheduled task script must use these internal names to correctly check and reactivate the interfaces.
+**Script example:**
 <html><body><pre><code>
 DOMAIN="[MY_DOMAIN]"
 TOKEN="[MY_TOKEN]"
-TUNNELS="wgnet1 wgnet2 wgnet_custom"
+TUNNELS="wgnet1 wgnet2 wgnet_backup"
 UPDATED=0
+# Update IP address in DuckDNS
 curl -s -k "https://www.duckdns.org/update?domains=${DOMAIN}&token=${TOKEN}&ip=&verbose=true" | grep -q UPDATED && {
     echo "IP updated in DuckDNS"
@@ Line 592: / Line 594: @@
 }
+# Check tunnel status and reactivate if needed
 for TUNNEL in $TUNNELS; do
     ip link show "$TUNNEL" >/dev/null 2>&1 || {
@@ Line 603: / Line 606: @@
 </code></pre></body></html>
-Replace the following placeholders:
+**How to use:**
-  * [MY_DOMAIN] = Your DuckDNS domain (without ''.duckdns.org'')
+  * Replace placeholders with your real values:
-  * [MY_TOKEN] = Your DuckDNS token
+    * [MY_DOMAIN] = Your DuckDNS domain (without .duckdns.org)
-  * [MY_TUNNEL_NUMBER_1]=For standard tunnel number 1, write: ''wgnet1''
+    * [MY_TOKEN] = Your DuckDNS token
-  * [MY_TUNNEL_NUMBER_2]=For standard tunnel number 2, write: ''wgnet2''
+    * [MY_TUNNEL_NUMBER_1], [MY_TUNNEL_NUMBER_2], etc. = Internal tunnel names as described above
-  * [MY_CUSTOM_TUNNEL]=For custom tunnel abcd write: ''wgnet_abcd''
+  * Single-line version for OMV Scheduled Tasks:
+    * <html><body><pre><code>DOMAIN="[MY_DOMAIN]"; TOKEN="[MY_TOKEN]"; TUNNELS="wgnet1 wgnet_backup"; UPDATED=0; curl -s -k "https://www.duckdns.org/update?domains=${DOMAIN}&token=${TOKEN}&ip=&verbose=true" | grep -q UPDATED && { echo "IP updated in DuckDNS"; UPDATED=1; }; for TUNNEL in $TUNNELS; do ip link show "$TUNNEL" >/dev/null 2>&1 || { echo "WireGuard $TUNNEL down, reactivating..."; systemctl start wg-quick@"$TUNNEL" || exit 1; UPDATED=1; }; done; [ "$UPDATED" -eq 1 ] && echo "CHANGES APPLIED" || true</code></pre></body></html>
-Single-line example for OMV Scheduled Tasks:
+  * Enable OMV notifications to receive alerts when the public IP changes or a tunnel is reactivated.
+  * Add a descriptive label to your scheduled task.
-  * Example command:
-<html><body><pre><code>
-DOMAIN="[MY_DOMAIN]"; TOKEN="[MY_TOKEN]"; TUNNELS="wgnet1 wgnet_abcd"; UPDATED=0; curl -s -k "https://www.duckdns.org/update?domains=${DOMAIN}&token=${TOKEN}&ip=&verbose=true" | grep -q UPDATED && { echo "IP updated in DuckDNS"; UPDATED=1; }; for TUNNEL in $TUNNELS; do ip link show "$TUNNEL" >/dev/null 2>&1 || { echo "WireGuard $TUNNEL down, reactivating..."; systemctl start wg-quick@"$TUNNEL" || exit 1; UPDATED=1; }; done; [ "$UPDATED" -eq 1 ] && echo "CHANGES APPLIED" || true
-</code></pre></body></html>
-Notes:
-  * Enable OMV notifications to receive alerts when the public IP changes.
-  * Give a descriptive label to the scheduled task.
   * Make sure **curl** is installed before running the task.