Compatibilità

KOBServer 6.5.3: soltanto due varianti di bytes verificate.

Sono supportate una precisa variante legacy con terminatori CRLF e la stessa identica variante convertita in LF. Altre copie che dichiarano 6.5.3 possono essere incompatibili. L’installer controlla sia VERSION sia SHA256 e rifiuta sorgenti sconosciuti, modificati o versioni diverse, inclusa 6.5.7. Nessuna compatibilità universale e nessuna opzione --force.

Prerequisiti

• Accesso amministrativo e permessi per modificare il sorgente e gestire il solo relay.
• Linux/POSIX e Python 3.10 o superiore; distribuzione collaudata con Python 3.13. Sola libreria standard, nessuna dipendenza pip.
• Accesso al vero file KOBServer.py, o al sorgente equivalente effettivamente avviato.
• Conoscenza di interprete, UID/GID runtime, porta, DocumentRoot e servizio o altro meccanismo che avvia il relay.
• Possibilità di creare backup privati e verificarne il ripristino. Filesystem locale con flock, fsync e rename atomico.
• Sorgente, config, audit e backup fuori dalla webroot e da ogni alias HTTP. Il genitore della directory backup deve esistere.

Guida passo passo

Questi comandi provengono dai README e dall’interfaccia verificata di install.py nel pacchetto v1.0. Sono esempi per altri amministratori, non istruzioni con i percorsi del nostro VPS. Non vengono eseguiti dalla pagina.

1. Scarica ed estrai

   Dal browser del tuo PC scarica lo ZIP qui sotto. Estrai l’archivio con il gestore archivi del tuo sistema e trasferisci la cartella estratta sul server, in una posizione privata a tua scelta. Non estrarre nella directory pubblica del sito.

2. Verifica integrità e compatibilità

   Apri il terminale SSH sul server ed entra nella directory estratta indicata sotto ogni comando. Confronta anche la dimensione e il checksum ZIP pubblicati in questa pagina attraverso un canale attendibile. Il manifest rileva corruzione, non è una firma digitale.

   Verifica versione e SHA256 dei file distribuiti tramite MANIFEST.json.Copia comando

   python3 install.py verify-package

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   Nessun parametro del server da impostare. Usare la copia estratta del pacchetto.

   Controlla VERSION e SHA256 del sorgente scelto, senza eseguirlo.Copia comando

   python3 install.py check --server /srv/morse/CustomRelay.py

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   I percorsi /srv sono esempi: sostituirli con quelli reali. Il nome del sorgente può differire da KOBServer.py.

3. Esegui i test offline

   Le socket e i dati sono simulati: nessun pacchetto al relay, richiesta RSS o gestione di servizi. La prova con --original legge il sorgente ammesso senza importarlo sul server reale. La fixture neutra inclusa è solo per test, non è installabile.

   Esegue la suite offline sulla fixture neutra inclusa.Copia comando

   PYTHONDONTWRITEBYTECODE=1 python3 tests/test_offline.py

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   Nessun parametro del server da impostare. Usare la copia estratta del pacchetto.

   Esegue facoltativamente la suite offline su una copia originale supportata.Copia comando

   PYTHONDONTWRITEBYTECODE=1 python3 tests/test_offline.py --original /srv/morse/CustomRelay.py

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   I percorsi /srv sono esempi: sostituirli con quelli reali. Il nome del sorgente può differire da KOBServer.py.

4. Prepara la finestra e il backup

   Identifica una sola istanza, il gestore corretto e gli eventuali avvii concorrenti. Ferma soltanto il relay con la procedura già verificata del tuo server e conferma processo terminato e porta libera. Non fermare feed o HTTP. Alcuni script SysV avviano un duplicato anche con stop: non usarli alla cieca. L’installer crea e verifica automaticamente un nuovo backup privato prima di ogni modifica; conservarne il percorso stampato.

5. Installa sul disco con filtro inizialmente disabilitato

   Personalizza tutti i percorsi e gli UID/GID. La directory backup viene creata 0700 se il genitore esiste; config nuova 0640 e audit 0700 appartengono all’utente runtime. Una config enabled/disabled già presente viene preservata: --filter in conflitto viene rifiutato. --confirm-stopped è la tua dichiarazione di arresto, non una verifica automatica del PID o della porta. Lo script non riavvia nulla.

   Verifica sorgente e patch, crea backup e applica il fix sul disco.Copia comando

   sudo python3 install.py install \
     --server /srv/morse/CustomRelay.py \
     --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups \
     --runtime-uid 1001 --runtime-gid 1001 \
     --filter disabled --confirm-stopped

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   Sostituire /srv/morse/CustomRelay.py, /srv/http/morse e /srv/morse-backups; 1001/1001 sono UID/GID di esempio, non valori consigliati. --confirm-stopped solo dopo arresto verificato. Usare sudo solo se necessario e autorizzato per i permessi del proprio server.

6. Riavvio controllato del solo relay

   Usa il tuo gestore verificato e gli stessi argomenti, interprete, CWD, porta e webroot precedenti. Non esiste un comando di servizio universale nel pacchetto. Copiare Python non modifica un processo già in esecuzione: solo il nuovo processo carica il fix. Il cambio interrompe brevemente UDP e perde lo stato RAM. Non rilanciare feed o una seconda copia del relay. Verifica PID/socket unici e assenza di errori.

7. Attiva il filtro

   Dopo le verifiche abilita il filtro. La modifica alla config viene preceduta da un backup ed è atomica; il processo patched rilegge il flag circa ogni secondo. Per questa sola modifica non serve un riavvio.

   Scrive enabled in observer-visibility.conf con backup automatico.Copia comando

   sudo python3 install.py set-filter \
     --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups --filter enabled

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   I percorsi /srv sono esempi: sostituirli con quelli reali. Il nome del sorgente può differire da KOBServer.py. Usare sudo solo se necessario e autorizzato per i permessi del proprio server.

8. Verifica il funzionamento

   Osserva passivamente index.html e soltanto i nuovi eventi di log.html: gli observer conformi devono essere assenti anche con suffisso diverso dal canale. Gli operatori normali devono restare visibili. Controlla privatamente l’audit, i feed e il segnale orario del tuo server senza eseguire prove sui canali pubblici. I test del pacchetto simulano il contratto listener, non eseguono i feed reali.

9. Disabilita rapidamente, se necessario

   disabled ripristina la visibilità nel backend senza chiudere sessioni UDP; non ripristina il codice legacy esatto e non rimuove eventuali filtri della dashboard. Conserva anche i backup prodotti da set-filter.

   Scrive disabled in observer-visibility.conf con backup automatico.Copia comando

   sudo python3 install.py set-filter \
     --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups --filter disabled

   Ambiente

   Linux/POSIX · terminale SSH sul proprio server

   Da dove eseguire

   Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

   Da personalizzare

   I percorsi /srv sono esempi: sostituirli con quelli reali. Il nome del sorgente può differire da KOBServer.py. Usare sudo solo se necessario e autorizzato per i permessi del proprio server.

10. Rollback e disinstallazione

    Ferma soltanto il relay con la tua procedura e verifica porta libera. Se hai cambiato config dopo l’installazione, annulla quelle modifiche in ordine inverso usando i rispettivi backup prima del rollback dell’install. Verifica il backup scelto, poi ripristina. Il rollback crea a sua volta un backup e controlla gli hash; rifiuta corruzione o modifiche sconosciute. Riavvia una sola istanza perché il ripristino sul disco diventi attivo. Non ripristinare index.html/log.html. Audit e backup vengono conservati; eliminare la cartella ZIP estratta non disinstalla il fix.

    Verifica che i file del backup scelto coincidano con i loro SHA256.Copia comando

    sudo python3 install.py verify-backup /srv/morse-backups/BACKUP-ID

    Ambiente

    Linux/POSIX · terminale SSH sul proprio server

    Da dove eseguire

    Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

    Da personalizzare

    Sostituire BACKUP-ID con la cartella esatta stampata dall’operazione da annullare; /srv/morse-backups è un esempio. Usare sudo solo se necessario e autorizzato per i permessi del proprio server.

    Ripristina sorgente/config e metadati dal backup verificato.Copia comando

    sudo python3 install.py rollback \
      --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
      --backup-dir /srv/morse-backups \
      --from-backup /srv/morse-backups/BACKUP-ID --confirm-stopped

    Ambiente

    Linux/POSIX · terminale SSH sul proprio server

    Da dove eseguire

    Directory estratta TWI-CWcom-Server-Observer-Fix-v1.0/, nel percorso scelto sul proprio server.

    Da personalizzare

    I percorsi /srv sono esempi: sostituirli con quelli reali. Il nome del sorgente può differire da KOBServer.py. Sostituire BACKUP-ID con la cartella esatta stampata dall’operazione da annullare; /srv/morse-backups è un esempio. Usare sudo solo se necessario e autorizzato per i permessi del proprio server.

Funzionamento tecnico

Riconoscimento esatto

Solo TWI-SCOPE-[0-9]+-[0-9]+, per intero, case-sensitive e cifre ASCII. Il numero finale non è confrontato col canale corrente. Nomi simili non conformi restano pubblici.

Ricezione e protocollo

Il filtro agisce sulla presentazione, non sulle sessioni UDP. CONNECT, IDENT, DATA, ACK, heartbeat, timeout, DISCONNECT, PIN, canali e inoltro Morse restano invariati. Nessuna estensione del protocollo CWCOM.

Directory e nuovi eventi

Gli observer filtrati non compaiono in index.html né nei nuovi eventi nominativi pubblici. Lo storico resta intatto. Conn alla ricomparsa è marcato [public visibility]; Visibility registra un cambio di politica senza nominativi. Un vecchio Conn può restare senza Disc pubblico per evitare di rivelare il nome nascosto.

Flag enabled/disabled

observer-visibility.conf si trova accanto al sorgente. enabled filtra; disabled ripristina visibilità backend. Config mancante, invalida o illeggibile disabilita il filtro. I/O e scheduling possono allungare la rilettura; il flag non aggiorna un vecchio processo privo del fix.

Audit privato asincrono

Worker daemon e coda massima di 1.024 eventi. Il producer non attende disco o spazio; a coda piena scarta il nuovo evento. Audit best-effort: errori, saturazione e arresto possono perdere record; nessuna durabilità/fsync. dropped_total ed errors_total nelle righe successive; avvisi stderr generici limitati a uno/minuto. I/O pubblico e lettura config restano sincroni.

Rotazione e riservatezza

Audit in .observer-private/observer-events.jsonl fuori webroot: directory 0700, file 0600. Registra tempo, azione, nominativo, canale effettivo, endpoint e versione client; nessun PIN o contenuto DATA. Attivo più .1/.2/.3, massimo 1 MiB ciascuno per il set creato dal fix; record massimo 4.096 byte. Definire una politica privacy locale. Non ruota i log pubblici.

Identificativo non autenticato

Qualsiasi client può usare il formato tecnico per non apparire nelle pagine. Nessuna prova di autenticità, identità umana o appartenenza al software. Gli IDENT restano inoltrati e visibili ai client; nessuna garanzia hard real-time o di anonimato.

Risoluzione dei problemi

Download

Archivio originale, senza dashboard personalizzata, feed RSS, PIN, configurazioni del VPS, backup o log. Include patch, installer, test, helper JavaScript facoltativo, licenza MIT e guide italiana/inglese.

Versione

1.0

Dimensione esatta

35.554 byte

SHA256 dell’archivio ZIP

Confronta questi dati prima dell’installazione. SHA256 rileva corruzione, non sostituisce una firma digitale o una fonte attendibile.

Compatibility

KOBServer 6.5.3: only two verified byte variants.

Supported sources are one exact legacy variant with CRLF line endings and the identical variant converted to LF. Other copies reporting 6.5.3 may be incompatible. The installer checks both VERSION and SHA256 and refuses unknown or modified sources and other versions, including 6.5.7. No universal compatibility and no --force option.

Prerequisites

• Administrative access and permission to modify the source and manage only the relay.
• Linux/POSIX and Python 3.10 or later; package tested with Python 3.13. Standard library only, no pip dependencies.
• Access to the actual KOBServer.py file, or the equivalent source that is really launched.
• Knowledge of the interpreter, runtime UID/GID, port, DocumentRoot and service or other relay startup mechanism.
• Ability to create private backups and verify restoration. Local filesystem supporting flock, fsync and atomic rename.
• Source, config, audit and backups outside the webroot and every HTTP alias. The backup parent directory must exist.

Step-by-step guide

These commands come from the READMEs and verified install.py interface inside package v1.0. They are examples for other administrators, not instructions assuming our VPS paths. The page does not execute them.

1. Download and extract

   Use your PC browser to download the ZIP below. Extract it with your system’s archive manager and transfer the extracted folder to a private location of your choice on the server. Do not extract into the website’s public directory.

2. Verify integrity and compatibility

   Open an SSH terminal on the server and enter the extracted directory specified below each command. Also compare the ZIP size and checksum published on this page through a trusted channel. The manifest detects corruption; it is not a digital signature.

   Verify package version and distributed file SHA256 values through MANIFEST.json.Copy command

   python3 install.py verify-package

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   No server parameters to set. Use the extracted package.

   Check VERSION and SHA256 of the selected source without executing it.Copy command

   python3 install.py check --server /srv/morse/CustomRelay.py

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   The /srv paths are examples: replace them with your actual paths. The source filename may differ from KOBServer.py.

3. Run offline tests

   Sockets and data are simulated: no relay packets, RSS requests or service operations. The --original test reads the accepted source without importing it into the real server. The bundled neutral fixture is test-only and cannot be installed.

   Run the offline suite using the bundled neutral fixture.Copy command

   PYTHONDONTWRITEBYTECODE=1 python3 tests/test_offline.py

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   No server parameters to set. Use the extracted package.

   Optionally run the offline suite against a supported original copy.Copy command

   PYTHONDONTWRITEBYTECODE=1 python3 tests/test_offline.py --original /srv/morse/CustomRelay.py

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   The /srv paths are examples: replace them with your actual paths. The source filename may differ from KOBServer.py.

4. Prepare maintenance and backups

   Identify one instance, the correct manager and any competing startup jobs. Stop only the relay through your server’s verified procedure and confirm that the process has exited and its port is free. Leave feeds and HTTP running. Some SysV scripts launch a duplicate even with stop: do not use them blindly. The installer automatically creates and verifies a new private backup before each change; retain its printed location.

5. Install on disk with the filter initially disabled

   Customize every path and UID/GID. The backup directory is created 0700 if its parent exists; new config 0640 and audit directory 0700 belong to the runtime user. Existing enabled/disabled config is preserved: a conflicting --filter is refused. --confirm-stopped is your assertion, not an automatic PID or port check. The script never restarts anything.

   Verify source and patch, create backups and apply the fix on disk.Copy command

   sudo python3 install.py install \
     --server /srv/morse/CustomRelay.py \
     --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups \
     --runtime-uid 1001 --runtime-gid 1001 \
     --filter disabled --confirm-stopped

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   Replace /srv/morse/CustomRelay.py, /srv/http/morse and /srv/morse-backups; 1001/1001 are example UID/GID values, not recommendations. Use confirm-stopped only after confirming shutdown. Use sudo only when required and authorized for your server permissions.

6. Controlled restart of the relay only

   Use your verified manager and the previous arguments, interpreter, CWD, port and webroot. The package provides no universal service command. Copying Python does not update an existing process: only the replacement loads the fix. Replacement briefly interrupts UDP and loses RAM state. Do not relaunch feeds or a second relay. Verify a single PID/socket owner and no errors.

7. Enable the filter

   Enable after verification. The config change is backed up and atomic; the patched process rereads the flag about once per second. This config-only change does not require a restart.

   Write enabled to observer-visibility.conf with an automatic backup.Copy command

   sudo python3 install.py set-filter \
     --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups --filter enabled

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   The /srv paths are examples: replace them with your actual paths. The source filename may differ from KOBServer.py. Use sudo only when required and authorized for your server permissions.

8. Verify operation

   Passively inspect index.html and only new log.html events: matching observers should be absent even when the suffix differs from the channel. Normal operators must remain visible. Privately check audit, feeds and your time service without tests on public channels. Package tests simulate the listener contract, not real feed execution.

9. Disable quickly if needed

   disabled restores backend visibility without closing UDP sessions; it does not restore exact legacy code or remove independent dashboard filters. Retain backups produced by set-filter as well.

   Write disabled to observer-visibility.conf with an automatic backup.Copy command

   sudo python3 install.py set-filter \
     --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
     --backup-dir /srv/morse-backups --filter disabled

   Environment

   Linux/POSIX · SSH terminal on your own server

   Working directory

   Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

   Customize

   The /srv paths are examples: replace them with your actual paths. The source filename may differ from KOBServer.py. Use sudo only when required and authorized for your server permissions.

10. Rollback and uninstall

    Stop only the relay through your own procedure and confirm that its port is free. If config changed after installation, reverse those changes in order using their backups before rolling back installation. Verify the selected backup, then restore. Rollback creates another backup and checks hashes; corruption and unknown changes are refused. Start one instance again to activate the restored disk source. Do not restore index.html/log.html. Audit and backups are retained; deleting the extracted ZIP folder does not uninstall the fix.

    Verify that selected backup files match their SHA256 values.Copy command

    sudo python3 install.py verify-backup /srv/morse-backups/BACKUP-ID

    Environment

    Linux/POSIX · SSH terminal on your own server

    Working directory

    Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

    Customize

    Replace BACKUP-ID with the exact directory printed by the operation being undone; /srv/morse-backups is an example. Use sudo only when required and authorized for your server permissions.

    Restore source/config and metadata from the verified backup.Copy command

    sudo python3 install.py rollback \
      --server /srv/morse/CustomRelay.py --webroot /srv/http/morse \
      --backup-dir /srv/morse-backups \
      --from-backup /srv/morse-backups/BACKUP-ID --confirm-stopped

    Environment

    Linux/POSIX · SSH terminal on your own server

    Working directory

    Extracted TWI-CWcom-Server-Observer-Fix-v1.0/ directory, at your chosen location on your server.

    Customize

    The /srv paths are examples: replace them with your actual paths. The source filename may differ from KOBServer.py. Replace BACKUP-ID with the exact directory printed by the operation being undone; /srv/morse-backups is an example. Use sudo only when required and authorized for your server permissions.

Technical operation

Exact recognition

Only full, case-sensitive TWI-SCOPE-[0-9]+-[0-9]+ matches with ASCII digits. The final number is not compared with the current channel. Similar nonmatching names remain public.

Reception and protocol

The filter changes presentation, not UDP sessions. CONNECT, IDENT, DATA, ACK, heartbeat, timeout, DISCONNECT, PIN checks, channels and Morse forwarding remain unchanged. No CWCOM protocol extension.

Directory and new events

Filtered observers do not appear in index.html or new named public events. History is retained. Reappearing Conn is marked [public visibility]; Visibility records policy changes without names. An old Conn can remain without a public Disc to avoid revealing a hidden name.

enabled/disabled flag

observer-visibility.conf lives next to the source. enabled filters; disabled restores backend visibility. Missing, invalid or unreadable config disables hiding. I/O and scheduling can delay checks; the flag cannot update an old process without the fix.

Asynchronous private audit

Daemon worker and queue capped at 1,024 events. Producers never wait for disk or capacity; a full queue drops the newest event. Best-effort audit: errors, saturation and shutdown can lose records; no durability/fsync. dropped_total and errors_total appear in later records; generic stderr warnings limited to one/minute. Public I/O and config reads remain synchronous.

Rotation and privacy

Audit at .observer-private/observer-events.jsonl outside webroot: directory 0700, files 0600. Records time, action, identifier, actual channel, endpoint and client version, never PIN or DATA contents. Active file plus .1/.2/.3, each up to 1 MiB for the set created by the fix; records up to 4,096 bytes. Define a local privacy policy. Public logs are not rotated.

Unauthenticated identifier

Any client can adopt the technical format to disappear from pages. It proves neither authenticity, human identity nor software origin. IDENT packets are still forwarded and visible to clients; no hard real-time or anonymity guarantee.

Troubleshooting

Download

Original archive without a personalized dashboard, RSS feeds, PIN files, VPS configuration, backups or logs. Includes patch, installer, tests, optional JavaScript helper, MIT license and Italian/English guides.

Version

1.0

Exact file size

35,554 bytes

ZIP archive SHA256

Compare these values before installation. SHA256 detects corruption; it does not replace a digital signature or a trusted source.