add raw query to skip query building

Author: CodeShellDev

.github/templates/README.template.md

@@ -91,16 +91,17 @@ The `hosts` section defines all machines, VMs, containers, or Docker services th
 | `mac`          | string  | Required for PHYSICAL    | MAC address for Wake-on-LAN. Only needed for physical hosts.                                            |
 | `addr`         | string  | Optional, PHYSICAL only  | The network address used to send WoL packets, if different from `ip`.                                   |
 | `id`           | string  | Required for VIRTUAL     | Identifier for virtual machines or LXCs.                                                                |
-| `virtIP`       | string  | Optional                 | IP of the VM/LXC. Defaults to `ip`.                                                                     |
+| `virtIP`       | string  | Optional                 | IP of the VM/LXC, used for pings. Defaults to `ip`.                                                     |
 | `startupTime`  | number  | Optional                 | Seconds to wait after starting before pinging IP.                                                       |
 | `url`          | string  | Optional                 | Override the default helper URL for this host.                                                          |
 | `docker: true` | boolean | Optional                 | Can be set to `true` to mark a host as DOCKER type without additional settings.                         |
 | `docker`       | object  | Required for DOCKER type | Docker-specific settings. See below.                                                                    |
 
-### Docker Sub-Object
+### Docker Sub-Object (`docker`)
 
 | Field          | Type   | Required | Description                                                                                |
 | -------------- | ------ | -------- | ------------------------------------------------------------------------------------------ |
+| `query`        | string | Optional | Raw query used for WoL Dockerized. Skips building query with `queryPattern`.               |
 | `queryPattern` | string | Optional | Template used to build the query for WoL Dockerized. Falls back to `ENV.woldQueryPattern`. |
 | `url`          | string | Optional | Override URL for Docker wake API. Defaults to `http://${host.ip}:${ENV.woldPort}/wake`.    |
 
@@ -110,14 +111,6 @@ The `hosts` section defines all machines, VMs, containers, or Docker services th
 - **VIRTUAL** → has `id`
 - **DOCKER** → has `docker` object or `docker: true`
 
-### Notes on Optional Overrides
-
-- `addr` allows sending WoL packets to a different network address than `ip`, useful for hosts behind different subnets or NAT.
-- `url` can override default helper URLs for PHYSICAL, VIRTUAL, or DOCKER hosts.
-- `virtIP` can override the IP used for pings.
-- `docker.queryPattern` can override the global `ENV.woldQueryPattern`.
-- The execution order of hosts in a route determines the startup sequence.
-
 ## Advanced Setups
 
 WoL Redirect supports two main scenarios depending on how your services are hosted.

src/wol.js

@@ -158,16 +158,22 @@ function getDataFromHost(host, serviceUrl) {
 				return null
 			}
 
-			const queryPattern = host.docker.queryPattern || ENV.woldQueryPattern
-			const context = {
-				HOST: serviceURL.host,
-				HOSTNAME: serviceURL.hostname,
-				PORT: serviceURL.port || "",
-				PROTOCOL: serviceURL.protocol,
-				PATH: serviceURL.pathname,
-			}
+			let query = ""
+
+			if (host.docker?.query) {
+				query = host.docker.query
+			} else {
+				const queryPattern = host.docker.queryPattern || ENV.woldQueryPattern
+				const context = {
+					HOST: serviceURL.host,
+					HOSTNAME: serviceURL.hostname,
+					PORT: serviceURL.port || "",
+					PROTOCOL: serviceURL.protocol,
+					PATH: serviceURL.pathname,
+				}
 
-			const query = buildQuery(queryPattern, context)
+				query = buildQuery(queryPattern, context)
+			}
 
 			return {
 				url: woldUrl,