Aller au contenu
local-cert
Parcourir la documentation

Synology DSM

L'assistant de certificats de DSM ne connaît que Let's Encrypt et exige que le NAS soit joignable depuis Internet. acme.sh, installé sur le NAS, obtient le certificat auprès de local-cert et l'installe dans DSM avec son hook synology_dsm.

ValeurOù la trouverDans ce guide
Directory ACMEfixe pour chaque instancehttps://certs.example.com/acme/directory
Key ID (kid)Clés & droits → Identifiants EABeab_XXXXXXXXXXXXXXXX
Clé HMACaffichée une seule fois à la créationCLE_HMAC

1. Préparer le NAS

  1. Panneau de configuration → Terminal & SNMP → activez SSH.
  2. Connectez-vous en SSH avec un compte administrateur, puis sudo -i.
installer acme.sh hors du volume système
mkdir -p /usr/local/share/acme.sh/webroot
cd /tmp && wget -O acme.sh.tar.gz https://github.com/acmesh-official/acme.sh/archive/master.tar.gz
tar xzf acme.sh.tar.gz && cd acme.sh-master
./acme.sh --install --nocron --home /usr/local/share/acme.sh -m ops@example.com
cd /usr/local/share/acme.sh

2. Compte et émission

acme.sh
./acme.sh --register-account --server https://certs.example.com/acme/directory \
  --eab-kid eab_XXXXXXXXXXXXXXXX --eab-hmac-key CLE_HMAC

./acme.sh --issue --server https://certs.example.com/acme/directory \
  -d nas.home.example.com -w /usr/local/share/acme.sh/webroot

Le dossier webroot reste vide et n'est servi par rien : local-cert ne vient pas lire le challenge. Le NAS n'a besoin d'aucune ouverture de port.

3. Installer dans DSM

acme.sh — hook synology_dsm
export SYNO_SCHEME=http
export SYNO_HOSTNAME=localhost
export SYNO_PORT=5000
export SYNO_USERNAME='un-compte-admin'
export SYNO_PASSWORD='son-mot-de-passe'
export SYNO_CERTIFICATE='local-cert'   # description du certificat dans DSM
export SYNO_CREATE=1                    # le créer s'il n'existe pas

./acme.sh --deploy -d nas.home.example.com --deploy-hook synology_dsm

Le certificat apparaît dans Panneau de configuration → Sécurité → Certificat. Affectez-le aux services voulus avec Paramètres.

4. Renouvellement

Panneau de configuration → Planificateur de tâches → Créer → Tâche planifiée → Script défini par l'utilisateur, utilisateur root, tous les jours :

script
/usr/local/share/acme.sh/acme.sh --cron --home /usr/local/share/acme.sh

acme.sh ne renouvelle qu'à l'approche de l'échéance, puis rejoue le déploiement dans DSM avec les réglages mémorisés.