Configurazione Synology DS1817 come QDevice per il quorum

Obiettivo

Configurare un NAS Synology DS1817 come voto esterno per il quorum di un cluster Proxmox VE a 2 nodi, usando corosync-qnetd.

Schema finale:

proxmox01      1 voto
proxmox02      1 voto
Synology NAS   1 voto esterno QDevice

Totale voti:   3
Quorum:        2

Il Synology non diventa un nodo Proxmox. Serve solo come server corosync-qnetd.

Scenario di esempio

Host	IP
`proxmox01`	`192.168.0.10`
`proxmox02`	`192.168.0.11`
`Synology DS1817`	`192.168.0.50`

Cluster Proxmox già esistente:

proxmox01 + proxmox02

Nota importante

Questa guida è pensata per Synology DS1817 non Plus, quindi modello ARM.

Non useremo:

VM Debian
Docker
Raspberry
Debian chroot

La soluzione funzionante è:

Synology DS1817
└── Entware
    ├── corosync
    ├── corosync-qdevice
    ├── nss-utils
    └── openssh-sftp-server

1. Abilitare SSH sul Synology

Da DSM:

Pannello di controllo
→ Terminale e SNMP
→ Abilita servizio SSH

Poi collegarsi al NAS:

ssh tuo_utente@192.168.0.50
sudo -i

2. Installare Entware sul Synology

Creare la directory persistente:

mkdir -p /volume1/@Entware/opt
rm -rf /opt
mkdir -p /opt
mount -o bind /volume1/@Entware/opt /opt

Installare Entware per ARMv7:

wget -O - https://bin.entware.net/armv7sf-k3.2/installer/generic.sh | /bin/sh

Aggiornare opkg:

/opt/bin/opkg update

Installare alcuni strumenti base:

/opt/bin/opkg install bash wget tar gzip xz binutils

Verificare che opkg funzioni:

/opt/bin/opkg update

3. Installare i pacchetti necessari

Sul Synology:

/opt/bin/opkg update
/opt/bin/opkg install corosync corosync-qdevice nss-utils openssh-sftp-server

Verificare i binari:

find /opt -type f | grep -E 'corosync-qnetd|qnetd|qdevice|certutil|sftp-server'

Output atteso simile:

/opt/bin/corosync-qnetd
/opt/bin/corosync-qnetd-tool
/opt/bin/corosync-qnetd-certutil
/opt/bin/certutil
/opt/lib/sftp-server

4. Creare i wrapper per Proxmox

Proxmox, durante il comando pvecm qdevice setup, si aspetta alcuni binari in percorsi standard come /usr/bin e /usr/sbin.

Creare i wrapper:

cat > /usr/sbin/corosync-qnetd <<'EOF'
#!/bin/sh
exec /opt/bin/corosync-qnetd "$@"
EOF

cat > /usr/bin/corosync-qnetd-tool <<'EOF'
#!/bin/sh
exec /opt/bin/corosync-qnetd-tool "$@"
EOF

cat > /usr/bin/corosync-qnetd-certutil <<'EOF'
#!/bin/sh
exec /opt/bin/corosync-qnetd-certutil "$@"
EOF

cat > /usr/bin/certutil <<'EOF'
#!/bin/sh
exec /opt/bin/certutil "$@"
EOF

chmod +x /usr/sbin/corosync-qnetd
chmod +x /usr/bin/corosync-qnetd-tool
chmod +x /usr/bin/corosync-qnetd-certutil
chmod +x /usr/bin/certutil

Verificare:

which corosync-qnetd
which corosync-qnetd-tool
which corosync-qnetd-certutil
which certutil

5. Sistemare le directory di Corosync

Creare la directory di configurazione:

mkdir -p /etc/corosync/qnetd
chmod 700 /etc/corosync
chmod 700 /etc/corosync/qnetd

Sul Synology, Entware usa /opt/etc/corosync, mentre Proxmox cerca /etc/corosync.

La struttura funzionante è:

/etc/corosync = directory reale
/opt/etc/corosync -> /etc/corosync

Creare il symlink:

rm -rf /opt/etc/corosync
ln -s /etc/corosync /opt/etc/corosync

Verificare:

ls -ld /etc/corosync /opt/etc/corosync

Output atteso:

drwx------ ... /etc/corosync
lrwxrwxrwx ... /opt/etc/corosync -> /etc/corosync

6. Sistemare SFTP/SCP sul Synology

pvecm qdevice setup usa scp per copiare certificati e file necessari.

Sul DS1817 può comparire questo errore:

subsystem request failed on channel 0
scp: Connection closed

Per risolvere, usare il server SFTP installato tramite Entware.

Modificare il file SSH:

vi /etc/ssh/sshd_config

Cercare la riga Subsystem sftp.

Commentare eventuali righe esistenti, per esempio:

#Subsystem       sftp    internal-sftp -f DAEMON -u 000

Aggiungere questa riga:

Subsystem       sftp    /opt/lib/sftp-server

Verificare che ci sia una sola riga attiva:

grep -n "^[^#].*Subsystem.*sftp" /etc/ssh/sshd_config

Riavviare SSH:

synosystemctl restart sshd

Se non funziona, disabilitare e riabilitare SSH da DSM:

Pannello di controllo
→ Terminale e SNMP
→ Disabilita SSH
→ Applica
→ Abilita SSH
→ Applica

7. Abilitare accesso root SSH via chiave

Da proxmox01, controllare se esiste già la chiave SSH root:

ls -l /root/.ssh/id_rsa.pub

Se non esiste, crearla:

ssh-keygen -t rsa -b 4096 -f /root/.ssh/id_rsa

Mostrare la chiave pubblica:

cat /root/.ssh/id_rsa.pub

Sul Synology, da root:

mkdir -p /root/.ssh
chmod 700 /root/.ssh
vi /root/.ssh/authorized_keys

Incollare dentro authorized_keys la chiave pubblica di proxmox01.

Poi sistemare i permessi:

chmod 600 /root/.ssh/authorized_keys
chown -R root:root /root/.ssh

Nel file SSH:

vi /etc/ssh/sshd_config

assicurarsi che siano presenti:

PermitRootLogin prohibit-password
PubkeyAuthentication yes

Riavviare SSH:

synosystemctl restart sshd

Test da proxmox01:

ssh root@192.168.0.50 'hostname'

Output atteso:

synology

Test SCP:

scp root@192.168.0.50:/etc/hosts /tmp/synology-hosts-test

Se questo comando funziona, si può proseguire.

8. Rimuovere eventuale vecchio QDevice

Se era già presente un QDevice precedente, ad esempio un Raspberry Pi, rimuoverlo da Proxmox.

Su proxmox01:

pvecm qdevice remove

Verificare:

pvecm status

Output temporaneo atteso:

Expected votes: 2
Total votes:    2
Quorum:         2
Quorate:        Yes

9. Pulire eventuale database qnetd precedente

Sul Synology:

rm -rf /etc/corosync/qnetd/nssdb
rm -rf /opt/etc/corosync/qnetd/nssdb

10. Configurare il Synology come QDevice

Da proxmox01:

pvecm qdevice setup 192.168.0.50

Al termine, verificare:

pvecm status

Output atteso:

Expected votes:   3
Total votes:      3
Quorum:           2
Flags:            Quorate Qdevice

Membership attesa:

Nodeid      Votes    Qdevice Name
0x00000001      1    A,V,NMW 192.168.0.10
0x00000002      1    A,V,NMW 192.168.0.11
0x00000000      1            Qdevice

11. Avviare qnetd sul Synology

Sul Synology:

nohup /opt/bin/corosync-qnetd -f > /var/log/corosync-qnetd.log 2>&1 &

Verificare:

ps | grep '[c]orosync-qnetd'
netstat -tlnp | grep 5403

Output atteso:

tcp6  0  0 :::5403  :::*  LISTEN  .../corosync-qnetd

Controllare lo stato:

/opt/bin/corosync-qnetd-tool -l

Output atteso simile:

Cluster "casa":
    Algorithm: Fifty-Fifty split (KAP Tie-breaker)
    Tie-breaker: Node with lowest node ID
    Node ID 1:
        Vote: ACK
    Node ID 2:
        Vote: No change (ACK)

12. Creare avvio automatico al boot del Synology

Creare lo script:

cat > /usr/local/bin/start-qnetd.sh <<'EOF'
#!/bin/sh

mkdir -p /opt

if ! mountpoint -q /opt; then
    mount -o bind /volume1/@Entware/opt /opt
fi

if ! ps | grep '[c]orosync-qnetd' >/dev/null 2>&1; then
    nohup /opt/bin/corosync-qnetd -f > /var/log/corosync-qnetd.log 2>&1 &
fi
EOF

chmod +x /usr/local/bin/start-qnetd.sh

Testare lo script:

pkill corosync-qnetd
/usr/local/bin/start-qnetd.sh
ps | grep '[c]orosync-qnetd'
netstat -tlnp | grep 5403

Poi da DSM:

Pannello di controllo
→ Utilità di pianificazione
→ Crea
→ Attività attivata

Impostare:

Utente: root
Evento: Avvio

Script:

/usr/local/bin/start-qnetd.sh

13. Verifiche finali

Su Proxmox:

pvecm status

Output corretto:

Expected votes: 3
Total votes:    3
Quorum:         2
Flags:          Quorate Qdevice

Su Synology:

ps | grep '[c]orosync-qnetd'
netstat -tlnp | grep 5403
/opt/bin/corosync-qnetd-tool -l

Errori comuni e soluzioni

Errore: `certutil: command not found`

Errore tipico:

/opt/bin/corosync-qnetd-certutil: line 143: certutil: command not found

Soluzione:

/opt/bin/opkg install nss-utils

Poi creare il wrapper:

cat > /usr/bin/certutil <<'EOF'
#!/bin/sh
exec /opt/bin/certutil "$@"
EOF

chmod +x /usr/bin/certutil

Errore: `subsystem request failed on channel 0`

Errore tipico durante scp:

subsystem request failed on channel 0
scp: Connection closed

Soluzione:

/opt/bin/opkg install openssh-sftp-server

Poi in /etc/ssh/sshd_config:

Subsystem       sftp    /opt/lib/sftp-server

Riavviare SSH:

synosystemctl restart sshd

Errore: QDevice configurato ma voto non attivo

Su Proxmox può apparire:

Qdevice (votes 1)
Total votes: 2

E sul Synology:

/opt/bin/corosync-qnetd-tool -l

può dare:

Can't connect to qnetd socket

Significa che qnetd non è avviato.

Avviarlo:

nohup /opt/bin/corosync-qnetd -f > /var/log/corosync-qnetd.log 2>&1 &

Poi verificare:

pvecm status

Risultato finale

La configurazione corretta lato Proxmox deve essere:

Expected votes: 3
Total votes:    3
Quorum:         2
Flags:          Quorate Qdevice

La configurazione corretta lato Synology deve mostrare:

ps | grep '[c]orosync-qnetd'
netstat -tlnp | grep 5403
/opt/bin/corosync-qnetd-tool -l

Con qnetd attivo e i due nodi Proxmox collegati, il Synology DS1817 sta facendo correttamente da voto esterno quorum per Proxmox HA.

Revision #2
Created 2026-05-16 12:31:00 UTC by Enrico Orlando
Updated 2026-05-16 12:44:47 UTC by Enrico Orlando

Configurazione Synology DS1817 come QDevice per il quorum

Obiettivo

Scenario di esempio

Nota importante

1. Abilitare SSH sul Synology

2. Installare Entware sul Synology

3. Installare i pacchetti necessari

4. Creare i wrapper per Proxmox

5. Sistemare le directory di Corosync

6. Sistemare SFTP/SCP sul Synology

7. Abilitare accesso root SSH via chiave

8. Rimuovere eventuale vecchio QDevice

9. Pulire eventuale database qnetd precedente

10. Configurare il Synology come QDevice

11. Avviare qnetd sul Synology

12. Creare avvio automatico al boot del Synology

13. Verifiche finali

Errori comuni e soluzioni

Errore: certutil: command not found

Errore: subsystem request failed on channel 0

Errore: QDevice configurato ma voto non attivo

Risultato finale

Errore: `certutil: command not found`

Errore: `subsystem request failed on channel 0`