matterbridge 3.4.7-dev-20260103-3152357 → 3.4.7-dev-20260104-6b10cee

package/CHANGELOG.md

@@ -35,10 +35,13 @@ Advantages:
 - [docker]: Released for test and development the alpine and ubuntu images on Docker Hub. They are for amd64 arm64 and based on node 24. No plugins inside.
 - [docker]: Updated [README-DOCKER.md](README-DOCKER.md) to include alpine and ubuntu images specifications.
 - [package]: Added scripts for workspaces.
+- [reflector]: [Full guide](https://matterbridge.io/docker-reflector/Docker%20reflector.html).
 
 ### Changed
 
 - [package]: Updated dependencies.
+- [dgram]: Bumbed version number to 1.0.2 and excluded Tailscale interfaces in Dgram class.
+- [network]: Bumbed version number to 1.0.2.
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
 

package/dist/dgram/dgram.js

@@ -98,6 +98,8 @@ export class Dgram extends EventEmitter {
         }
         if (!networkInterface) {
             for (const [interfaceName, interfaceDetails] of Object.entries(interfaces)) {
+                if (interfaceName.toLowerCase().includes('tailscale'))
+                    continue;
                 if (!interfaceDetails)
                     continue;
                 for (const detail of interfaceDetails) {
@@ -130,6 +132,8 @@ export class Dgram extends EventEmitter {
         }
         if (!networkInterface) {
             for (const [interfaceName, interfaceDetails] of Object.entries(interfaces)) {
+                if (interfaceName.toLowerCase().includes('tailscale'))
+                    continue;
                 if (!interfaceDetails)
                     continue;
                 for (const detail of interfaceDetails) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.4.7-dev-20260103-3152357",
+  "version": "3.4.7-dev-20260104-6b10cee",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.4.7-dev-20260103-3152357",
+      "version": "3.4.7-dev-20260104-6b10cee",
       "license": "Apache-2.0",
       "workspaces": [
         "packages/*"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.4.7-dev-20260103-3152357",
+  "version": "3.4.7-dev-20260104-6b10cee",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",

package/packages/mb-lib-test/dist/jestutils/jestHelpers.d.ts

@@ -0,0 +1,21 @@
+import type { jest } from '@jest/globals';
+import { AnsiLogger } from 'node-ansi-logger';
+export declare const originalProcessArgv: readonly string[];
+export declare const originalProcessEnv: Readonly<Record<string, string | undefined>>;
+export declare let loggerLogSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.log>;
+export declare let loggerDebugSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.debug>;
+export declare let loggerInfoSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.info>;
+export declare let loggerNoticeSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.notice>;
+export declare let loggerWarnSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.warn>;
+export declare let loggerErrorSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.error>;
+export declare let loggerFatalSpy: jest.SpiedFunction<typeof AnsiLogger.prototype.fatal>;
+export declare let consoleLogSpy: jest.SpiedFunction<typeof console.log>;
+export declare let consoleDebugSpy: jest.SpiedFunction<typeof console.log>;
+export declare let consoleInfoSpy: jest.SpiedFunction<typeof console.log>;
+export declare let consoleWarnSpy: jest.SpiedFunction<typeof console.log>;
+export declare let consoleErrorSpy: jest.SpiedFunction<typeof console.log>;
+export declare let NAME: string;
+export declare let HOMEDIR: string;
+export declare let log: AnsiLogger;
+export declare function setupTest(name: string, debug?: boolean): Promise<void>;
+export declare function setDebug(debug: boolean): Promise<void>;

package/packages/mb-lib-test/dist/module.d.ts

@@ -0,0 +1,2 @@
+export * as jestHelpers from './jestutils/jestHelpers.js';
+export * as vitestHelpers from './vitestutils/vitestHelpers.js';

package/packages/mb-lib-test/dist/vitestutils/vitestHelpers.d.ts

@@ -0,0 +1,21 @@
+import type { MockInstance } from 'vitest';
+import { AnsiLogger } from 'node-ansi-logger';
+export declare const originalProcessArgv: readonly string[];
+export declare const originalProcessEnv: Readonly<Record<string, string | undefined>>;
+export declare let loggerLogSpy: MockInstance<typeof AnsiLogger.prototype.log>;
+export declare let loggerDebugSpy: MockInstance<typeof AnsiLogger.prototype.debug>;
+export declare let loggerInfoSpy: MockInstance<typeof AnsiLogger.prototype.info>;
+export declare let loggerNoticeSpy: MockInstance<typeof AnsiLogger.prototype.notice>;
+export declare let loggerWarnSpy: MockInstance<typeof AnsiLogger.prototype.warn>;
+export declare let loggerErrorSpy: MockInstance<typeof AnsiLogger.prototype.error>;
+export declare let loggerFatalSpy: MockInstance<typeof AnsiLogger.prototype.fatal>;
+export declare let consoleLogSpy: MockInstance<typeof console.log>;
+export declare let consoleDebugSpy: MockInstance<typeof console.debug>;
+export declare let consoleInfoSpy: MockInstance<typeof console.info>;
+export declare let consoleWarnSpy: MockInstance<typeof console.warn>;
+export declare let consoleErrorSpy: MockInstance<typeof console.error>;
+export declare let NAME: string;
+export declare let HOMEDIR: string;
+export declare let log: AnsiLogger;
+export declare function setupTest(name: string, debug?: boolean): Promise<void>;
+export declare function setDebug(debug: boolean): Promise<void>;

package/packages/mb-lib-test/package.json

@@ -60,9 +60,9 @@
     "git:hardreset:edge": "git fetch origin && git checkout edge && git reset --hard origin/edge",
     "checkDependencies": "npx npm-check-updates",
     "updateDependencies": "npx npm-check-updates -u && npm run reset",
-    "automator": "node /Users/lligu/OneDrive/Code/repository/automator.mjs --monorepo",
+    "automator": "node scripts/runAutomator.mjs --monorepo-package",
     "runMeBeforePublish": "npm run lint && npm run format && npm run test && npm run build",
-    "prepublishOnly": "npm run cleanBuildProduction && npm pkg delete devDependencies scripts types && npx shx rm -rf node_modules/* node_modules/.[!.]* node_modules/..?* && npm install --omit=dev && npm shrinkwrap",
+    "prepublishOnly": "npm run cleanBuildProduction && npm pkg delete devDependencies scripts && npx shx rm -rf node_modules/* node_modules/.[!.]* node_modules/..?* && npm install --omit=dev && npm shrinkwrap",
     "npmPack": "npx shx cp package.json package.json.backup && npm run prepublishOnly && npm pack && npx shx cp package.json.backup package.json && npx shx rm -f package.json.backup && npm run reset",
     "npmPublishTagDev": "npx shx cp package.json package.json.backup && npm run prepublishOnly && npm publish --tag dev && npx shx cp package.json.backup package.json && npx shx rm -f package.json.backup && npm run reset",
     "npmPublishTagEdge": "npx shx cp package.json package.json.backup && npm run prepublishOnly && npm publish --tag edge && npx shx cp package.json.backup package.json && npx shx rm -f package.json.backup && npm run reset",

package/reflector/Reflector.md

@@ -0,0 +1,158 @@
+# Matterbridge mDNS reflector
+
+This project aims to use Matterbridge in these configurations:
+
+| Docker type    | Docker network | OS      | Ipv4 | Ipv6 | Share (3) | Home Assistant | Matter Server |
+| -------------- | -------------- | ------- | ---- | ---- | --------- | -------------- | ------------- |
+| Docker Desktop | bridge (1)     | Windows | ✅   | ✅   | ✅        | ✅             | ✅            |
+| Docker Desktop | bridge (1)     | macOS   | ✅   | ✅   | ✅        | ✅             | ✅            |
+| Docker Engine  | bridge (2)     | Linux   | ✅   | ✅   | ✅        | ✅             | ✅            |
+
+(1) - Network host in this configuration is useless cause Docker runs inside a VM.
+
+(2) - Network host in this configuration works already out of the box cause Docker runs on the host.
+
+(3) - Share mDNS between separate containers.
+
+It can also be used to run Home Assistant and Matter Server inside Docker Desktop on Windows and macOS (with network bridge) without using complex VM. You just copy paste this [docker-compose.yml](https://matterbridge.io/reflector/docker-compose.yml).
+
+Since the mDNS are shared between reflector clients, you can pair Matterbridge running with Docker Desktop to Home Assistant running with Docker Desktop. Even on the same machine.
+
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
+
+# Prerequisites
+
+- Docker Desktop
+
+## Docker Desktop requirements for Windows and macOS
+
+See Docker Desktop docs.
+
+## Dual Stack IPv4/IPv6 mDNS enabled and No filtering
+
+![alt text](DockerDesktopSetup.png)
+
+# Run Matterbridge in a Docker Desktop container
+
+We use named volumes for storage, plugins and mattercert.
+
+We publish the default matterbridge frontend port 8283.
+
+We publish the matter port range 5550-5559 to allow childbridge mode and server node devices (RVCs).
+
+macOS
+
+```zsh
+docker stop matterbridge-test
+docker rm matterbridge-test
+docker pull luligu/matterbridge:dev
+docker run -dit --restart unless-stopped --name matterbridge-test \
+  -p 8283:8283 -p 5550-5559:5550-5559/udp \
+  -v storage:/root/.matterbridge -v plugins:/root/Matterbridge -v mattercert:/root/.mattercert \
+  luligu/matterbridge:dev matterbridge --docker --frontend 8283 --port 5550
+docker logs --tail 1000 -f matterbridge-test
+```
+
+powerShell
+
+```powershell
+docker stop matterbridge-test
+docker rm matterbridge-test
+docker pull luligu/matterbridge:dev
+docker run -dit --restart unless-stopped --name matterbridge-test `
+  -p 8283:8283 -p 5550-5559:5550-5559/udp `
+  -v storage:/root/.matterbridge -v plugins:/root/Matterbridge -v mattercert:/root/.mattercert `
+  luligu/matterbridge:dev matterbridge --docker --frontend 8283 --port 5550
+docker logs --tail 1000 -f matterbridge-test
+```
+
+You will see that the frontend inside the container is listening on the conainer address
+
+```text
+[09:02:10.140] [Frontend] The frontend http server is listening on http://172.17.0.2:8283
+[09:02:10.140] [Frontend] The frontend http server is listening on http://[fd3d:8954:ffe5::2]:8283
+```
+
+But since we mapped the port 8283:
+
+- the frontend is available on the host with localhost:8283, <your_host_ip>:8283 or <your_hostname>:8283.
+
+- the frontend is available on the lan with <your_host_ip>:8283 or <your_hostname>:8283.
+
+In the same way the Matter port range 5550-5559 is mapped outside the container to allow the controllers on the lan to discover and connect Matterbridge.
+
+## Optional: if you want to see the mDNS inside the Docker Desktop container
+
+From another terminal run mb_mdns inside the container we created and run before
+
+```bash
+docker exec -it matterbridge-test mb_mdns --no-timeout
+```
+
+In a while you will see what mDNS packets are advertised inside the container
+
+![alt text](mDnsPacket.png)
+
+## Optional: if you want to see ip and routing table inside the Docker Desktop container
+
+From another terminal run ip a and ip r inside the container we created and run before
+
+```bash
+docker exec -it matterbridge-test apt-get update
+docker exec -it matterbridge-test apt-get install -y --no-install-recommends iproute2 iputils-ping net-tools dnsutils tcpdump netcat-openbsd
+docker exec -it matterbridge-test ip a
+docker exec -it matterbridge-test ip r
+```
+
+### Issues we have there
+
+1. The advertised mDNS packets cannot reach the host and the lan cause mDNS are not routed inside Docker Desktop
+
+2. The advertised mDNS packets contain wrong A and AAAA records:
+
+- the advertised address are relative to the container
+- those address are not reachable from the host and from the lan
+
+## Run the Madderbridge reflector server directly on the host (you need node.js installed on Windows or macOS)
+
+```shell
+npm install -g matterbridge@dev
+mb_mdns --reflector-server --log-reflector-messages --localhost --share-with-clients
+```
+
+In a while you will see
+
+![alt text](ReflectorServer.png)
+
+## Run the Madderbridge reflector client in container
+
+```shell
+docker stop matterbridge-reflector
+docker rm matterbridge-reflector
+docker pull luligu/reflector-client:latest
+docker run -dit --restart unless-stopped --name matterbridge-reflector luligu/reflector-client:latest
+docker logs --tail 1000 -f matterbridge-reflector
+```
+
+In a while you will see
+
+![alt text](ReflectorClient.png)
+
+# Run Home Assistant and Matter Server in Docker compose with Docker Desktop
+
+## Prerequisites
+
+You need the Matterbridge reflector server running on the host from the tutorial above.
+
+## Run Home Assitant and Matter Server in Docker Compose with Docker Desktop
+
+To test the sharing feature (it shares mDNS between all reflector clients),
+use this [docker-compose.yml](https://matterbridge.io/reflector/docker-compose.yml).
+
+With this configuration Home Assistant (with Matter Server) works inside a Docker Desktop container without network host. When asked by Home Assistant, connect to Matter Server with **ws://matterserver:5580/ws**
+
+```shell
+docker compose down
+docker compose pull
+docker compose up -d --force-recreate
+```

package/reflector/docker-compose.yml

@@ -0,0 +1,32 @@
+services:
+  homeassistant:
+    container_name: homeassistant
+    image: ghcr.io/home-assistant/home-assistant:stable
+    restart: unless-stopped
+    depends_on:
+      - matterserver
+    ports:
+      - "8123:8123"
+    volumes:
+      - ./DockerVolumes/homeassistant:/config
+    environment:
+      - TZ=Europe/Paris
+
+  matterserver:
+    container_name: matterserver
+    image: ghcr.io/home-assistant-libs/python-matter-server:stable
+    restart: unless-stopped
+    ports:
+      - "5580:5580"
+      - "5540:5540/udp"
+    volumes:
+      - ./DockerVolumes/matterserver:/data
+    environment:
+      - TZ=Europe/Paris
+
+  reflector:
+    container_name: reflector
+    image: luligu/reflector-client:latest
+    restart: unless-stopped
+    environment:
+      - TZ=Europe/Paris