Instalación en línea — Debian / Ubuntu

Requisitos previos

Un servidor Debian o Ubuntu con acceso sudo o root. El instalador se encarga de todo lo demás — Perl, SQLite, las nueve dependencias de producción — a través de apt. Compatible con Debian 11+ y Ubuntu 20.04+.

Ejecutar el instalador

Elige un nombre de instancia — una etiqueta alfanumérica corta que se usa en el nombre del servicio y la ruta de instalación. 1 es suficiente para una instalación única:

curl -fsSL https://www.chinaski.net/install.sh | sudo bash -s -- 1

Para instalar en un directorio o puerto personalizado:

curl -fsSL https://www.chinaski.net/install.sh \
  | sudo bash -s -- prod --dir /srv/chinaski --port 3001

El instalador muestra cada paso mientras se ejecuta. Si tiene éxito, muestra la ruta de instalación, el nombre del servicio y la dirección de escucha.

Qué se instala

• Código — extraído en /var/www/chinaski1/ (o el directorio --dir elegido)
• Base de datos — SQLite en /var/www/chinaski1/chinaski.db, inicializada desde schema.sql
• Archivo de entorno — /etc/chinaski1/env con un secreto generado y la URL de escucha
• Servicio — chinaski@1.service habilitado e iniciado a través de systemd
• Temporizador de copias de seguridad — chinaski-backup@1.timer se ejecuta diariamente a las 03:17
• Directorio de salida — /var/www/chinaski1/output/ donde se genera el sitio estático

Verificar el servicio

systemctl status chinaski@1
journalctl -u chinaski@1 -n 20

El daemon se enlaza a 127.0.0.1:3001 por defecto — solo loopback por diseño. Coloca un proxy inverso delante.

Configurar el servidor web

Ejemplos de configuración listos para usar están en deploy/:

• deploy/chinaski.nginx.conf.example — vhosts nginx con proxy /forms/ para bloques de formulario
• deploy/chinaski.Caddyfile.example — equivalente para Caddy

El dominio de administración redirige todas las solicitudes al daemon. Los vhosts públicos por idioma sirven archivos estáticos desde output/{lang}/ y solo hacen proxy de /forms/.

Iniciar sesión y ejecutar la primera compilación

Abre el dominio de administración en un navegador e inicia sesión. Ve a Compilar → Ejecutar compilación. Chinaski renderiza todas las páginas y entradas publicadas en /var/www/chinaski1/output/. Apunta el vhost público a output/en/ (o output/ para sitios de un solo idioma) y el sitio queda en línea.

Instalación sin conexión — cualquier Linux

Cuándo usarla

Usa la instalación sin conexión cuando la máquina de destino esté desconectada o sin internet fiable durante la configuración, cuando uses un Linux no Debian (Alpine, Arch, RHEL, etc.), o cuando quieras descargar todo en una máquina rápida y transferirlo a hardware más lento.

Requisitos previos

El paquete compila módulos XS en la máquina de destino. Necesitas: gcc o clang, make, perl 5.26+, sqlite3, openssl y los encabezados de las bibliotecas de imágenes.

# Debian / Ubuntu
apt-get install -y make gcc sqlite3 openssl libjpeg-dev libpng-dev libgif-dev

# Alpine
apk add make gcc sqlite openssl libjpeg-turbo-dev libpng-dev giflib-dev

Comando único

curl -fsSL https://www.chinaski.net/install.sh \
  | sudo bash -s -- --offline --prefix /srv/chinaski

Descargar, verificar e instalar manualmente

# Descargar el paquete y su checksum
curl -O https://www.chinaski.net/dist/chinaski-latest.tar.gz
curl -O https://www.chinaski.net/dist/chinaski-latest.tar.gz.sha256

# Verificar antes de ejecutar
sha256sum -c chinaski-latest.tar.gz.sha256

# Extraer e instalar
tar -xzf chinaski-latest.tar.gz
cd chinaski-latest
sudo bash install.sh --prefix /srv/chinaski

Configurar la URL del sitio durante la instalación

sudo bash install.sh \
  --prefix /srv/chinaski \
  --site-url https://example.com

Esto escribe el valor en la tabla de configuración de SQLite. También se puede cambiar más adelante desde Admin → Configuración.