📢Apprise API web based push notification

Apprise est une librairie écrite en Python et qui vous permet d’envoyer des notifications (push) à la quasi-totalité des services existant aujourd’hui.
Pour plus d’informations sur les options de déploiement Docker et les configurations de conteneurs avancées, reportez-vous à la section Déploiement Docker. Pour une configuration système et des variables d’environnement complètes, reportez-vous à la section Configuration. Pour des exemples d’utilisation d’API et des détails sur les points de terminaison, reportez-vous à API Reference.

Apprise API

• DeepWiki caronc/apprise-api
• linuxserver/apprise-api
• Apprise doc

Démarrage rapide avec Docker

La méthode la plus rapide pour lancer l’API Apprise consiste à utiliser l’image Docker prédéfinie. Le service fonctionne sur le port 8000 et ne nécessite aucune configuration initiale.

Déploiement de base

docker run -d \
  --name apprise-api \
  -p 8000:8000 \
  caronc/apprise:latest

Utilisation de Docker Compose

Créer le dossier apprise-api

mkdir -p $HOME/apprise-api
cd $HOME/apprise-api

Pour une configuration persistante et une gestion plus facile, utilisez le docker-compose.yml

services:
  apprise:
    image: caronc/apprise:latest
    container_name: apprise
    ports:
      - "8000:8000"
    environment:
      APPRISE_STATEFUL_MODE: simple
      APPRISE_WORKER_COUNT: 1
      APPRISE_ADMIN: "y"
    volumes:
      - ../docker-data/apprise-api/config:/config
      - ../docker-data/apprise-api:/attach

git clone https://github.com/caronc/apprise-api.git
cd apprise-api
docker compose up -d

Le service sera disponible à l’adresse http://localhost:8000

Proxy nginx

Créer le fichier :

sudo nano  /etc/nginx/conf.d/apprise.rnmkcy.eu.conf

Ajouter

# Optional: redirect plain HTTP to HTTPS (if you have a server listening 80)
server {
	listen 80;
	listen [::]:80;
	server_name apprise.rnmkcy.eu;
	return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name apprise.rnmkcy.eu;

    include /etc/nginx/conf.d/ssl-modern.inc;

	# Static assets if needed (adjust path) 
	location /static/ {
	    alias /opt/apprise-api/static/;
	}
	
	# Protect all other locations with Authelia
	location / {
		 proxy_pass         http://192.168.0.222:8000;
		 proxy_redirect     off;
		 proxy_set_header   Host $host;
		 proxy_set_header   X-Real-IP $remote_addr;
		 proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
		 proxy_set_header   X-Forwarded-Proto $scheme;
		 proxy_set_header   X-Forwarded-Host $http_host;
		 proxy_http_version 1.1;
		 proxy_set_header Upgrade $http_upgrade;
		 proxy_set_header Connection "";
		 proxy_buffers 16 64k;
		 proxy_buffer_size 128k;
		 proxy_read_timeout 300s;
		 proxy_send_timeout 300s;
	}
	
	# Additional security headers (tune as desired)
	add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;
	add_header X-Content-Type-Options nosniff;
	add_header X-Frame-Options DENY;
	add_header X-XSS-Protection "1; mode=block";

}

Vérifier et recharger NGINX:

sudo nginx -t
sudo systemctl reload nginx

test

curl -s -X POST https://apprise.rnmkcy.eu/notify/ \
-H "Content-Type: application/json" \
-H "Authorization: Bearer APPRISE_KEY" \
-d '{"targets":["ntfy://:tk_xxxxxxxxxxxxxxxxxx@ntfy.rnmkcy.eu/yan_infos"],"title":"Test","body":"Essai..."}'

Configuration web

L’API inclut un gestionnaire de configuration intégré à https://apprise.rnmkcy.eu

Les configurations sont stockées sous un identifiant de configuration (ou une clé) unique. Choisir un mot clé: yankey

Entrez vos URL (format TEXT ou YAML) et enregistrez-les sur votre clé.
Ici on utilise ntfy

Lancer un test pour envoyer une notification

Vérification sur le serveur ntfy