Référence CLI & serveur (`cms.pl`)

cms.pl est le daemon du CMS Chinaski : il sert l'interface admin et l'API, tandis que le site public est du HTML statique construit séparément. Cette page explique comment exécuter le serveur en développement, en production et hors ligne, plus les outils en ligne de commande qui l'accompagnent.

Avant de commencer

• Le serveur ne démarrera pas sans CHINASKI_SECRET. C'est la clé de signature des sessions admin et elle protège les credentials stockés pour les services tiers ; définissez-la à une longue valeur aléatoire et ne la changez jamais à la légère.
• La session admin dure 8 heures, et le cookie n'est envoyé que sur HTTPS.

Exécuter le serveur

Développement

morbo cms.pl

Morbo est le serveur de développement : il redémarre aux changements de code. Construisez le site statique séparément avec perl builder/build.pl.

Production (systemd, recommandé)

Le répertoire deploy/ livre une unité systemd templatisée, chinaski@.service, de sorte qu'un seul jeu de fichiers exécute un nombre quelconque d'instances du CMS sur le même hôte. Activez-en une avec le nom d'instance :

systemctl enable --now chinaski@1

(1 peut être 2, prod, staging : tout ce qui est alphanumérique.) Ce que l'unité fait pour vous :

• Exécute comme un utilisateur chinaski dédié avec le répertoire de travail /var/www/chinaski<instance>.
• Définit automatiquement les chemins de base de données et de sortie à partir du nom d'instance (CHINASKI_DB, CHINASKI_OUTPUT) ; vous n'avez normalement pas à les définir à la main.
• Lit un unique fichier env verrouillé en permissions, /etc/chinaski<instance>/env, que vous créez avant de démarrer. Il doit contenir CHINASKI_SECRET et LISTEN_URL.
• Redémarre automatiquement en cas de défaillance (avec backoff), attend les requêtes en vol à l'arrêt (un drain de 330 secondes ; un build en vol est annulé plutôt qu'attendu), et applique des limites mémoire/CPU et un hardening standard pour qu'un build déchaîné ne puisse pas affamer l'hôte.
• Logue vers journald : consultez avec journalctl -u chinaski@<instance>.

Liez le serveur au loopback. Dans cette configuration un reverse proxy (Caddy ou nginx) se tient devant et l'exemple de l'unité lie LISTEN_URL à http://127.0.0.1:3001. Le CMS ne fait confiance aux IP client transmises que depuis les connexions loopback : le lier à une interface publique permettrait aux visiteurs d'usurper leur IP et de défaire les rate limits et les lockouts de connexion.

Production (sans gestionnaire de services)

Les déploiements ponctuels s'exécutent pendant un deploy.sh <instance>, qui tire le code, installe les dépendances, vérifie la syntaxe, rebuild la sortie statique et redémarre le service. Si un build échoue, le deploy avorte par défaut pour que vous ne redémarriez jamais par-dessus une sortie cassée ; CHINASKI_ALLOW_BUILD_FAIL=1 outrepasse cela pour les deploys de code d'urgence uniquement.

Installation serveur en une commande

Sur un serveur Debian/Ubuntu vous pouvez dresser une nouvelle instance en une seule commande ; l'installateur gère les paquets, les dépendances, l'utilisateur chinaski, l'initialisation de la base de données, le fichier env et le service systemd :

curl -fsSL https://chinaski.net/install | sudo bash -s -- 1 --repo https://github.com/bigjohncobb/chinaski

Remplacez 1 par votre nom d'instance ; passez --port PORT pour outrepasser le port d'écoute par défaut.

Mode hors ligne / « EOTW » (hypnotoad, HTTP simple)

Pour les machines sans accès internet (pas de DNS, pas d'autorités de certification) hypnotoad peut être le seul serveur, servant du HTTP simple sur le port 8080 pour toujours.

1. Construisez ou procurez-vous un bundle hors ligne (bash install/make-bundle.sh sur une machine connectée) et suivez l'installation du bundle.
2. Copiez install/hypnotoad.conf dans le répertoire de l'application.
3. Démarrez :

export CHINASKI_SECRET=$(openssl rand -hex 32)   # once; save the value
export CHINASKI_AIRGAP=1
hypnotoad cms.pl

Gérer une instance en marche :

hypnotoad cms.pl                        # start, or hot-reload a running instance
hypnotoad -s cms.pl                     # graceful stop
kill -USR2 $(cat hypnotoad.pid)         # hot-reload without dropping connections

Deux workers sont sûrs sur une machine de 1 Go ; montez à 4 sur un hôte de 2+ Go avec plusieurs éditeurs simultanés.

Sécurité sans proxy : hors loopback, le CMS ignore les en-têtes X-Forwarded-For et utilise l'adresse réelle de la connexion TCP, de sorte que le rate limiting et le lockout de connexion fonctionnent correctement sans configuration supplémentaire. Il n'y a pas de TLS dans ce mode ; n'envoyez pas de mots de passe sur un réseau non fiable ; utilisez un VPN ou des règles de firewall pour restreindre qui peut atteindre l'admin.

Variables d'environnement

D'autres variables existent dans le code (CHINASKI_CMS_URL, CHINASKI_DOCS_DIR, CHINASKI_RELEASE_PUBKEY, CHINASKI_SMTP_INSECURE_NOVERIFY, CHINASKI_UPDATE_MANIFEST_URL, CHINASKI_URL_BASE, CHINASKI_FORCE_PROMOTE) mais leurs réglages exactement supportés ne sont pas couverts par ces docs.

Utilitaires en ligne de commande

Tous vivent dans bin/ et lisent la même base de données que le CMS.