Instalação online — Debian / Ubuntu

Pré-requisitos

Um servidor Debian ou Ubuntu com acesso sudo ou root. O instalador cuida de tudo o mais — Perl, SQLite, as nove dependências de produção — via apt. Compatível com Debian 11+ e Ubuntu 20.04+.

Executar o instalador

Escolha um nome de instância — uma etiqueta alfanumérica curta usada no nome do serviço e no caminho de instalação. 1 é suficiente para uma instalação única:

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

Para instalar em um diretório ou porta personalizados:

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

O instalador exibe cada etapa à medida que executa. Em caso de sucesso, exibe o caminho de instalação, o nome do serviço e o endereço de escuta.

O que é instalado

• Código — extraído em /var/www/chinaski1/ (ou o diretório --dir escolhido)
• Banco de dados — SQLite em /var/www/chinaski1/chinaski.db, inicializado a partir de schema.sql
• Arquivo de ambiente — /etc/chinaski1/env com um segredo gerado e a URL de escuta
• Serviço — chinaski@1.service habilitado e iniciado via systemd
• Temporizador de backup — chinaski-backup@1.timer executado diariamente às 03:17
• Diretório de saída — /var/www/chinaski1/output/ onde o site estático gerado é armazenado

Verificar o serviço

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

O daemon se vincula a 127.0.0.1:3001 por padrão — apenas loopback por design. Coloque um proxy reverso na frente.

Configurar o servidor web

Exemplos de configuração prontos para uso estão em deploy/:

• deploy/chinaski.nginx.conf.example — vhosts nginx com proxy /forms/ para blocos de formulário
• deploy/chinaski.Caddyfile.example — equivalente para Caddy

O domínio de administração encaminha todas as requisições ao daemon. Os vhosts públicos por idioma servem arquivos estáticos de output/{lang}/ e fazem proxy apenas de /forms/.

Entrar e executar a primeira compilação

Abra o domínio de administração no navegador e faça login. Vá em Compilar → Executar compilação. O Chinaski renderiza todas as páginas e posts publicados em /var/www/chinaski1/output/. Aponte o vhost público para output/en/ (ou output/ para sites de um único idioma) e o site ficará no ar.

Instalação offline — qualquer Linux

Quando usar

Use a instalação offline quando a máquina de destino estiver air-gapped ou sem acesso confiável à internet durante a configuração, quando estiver em um Linux não Debian (Alpine, Arch, RHEL, etc.), ou quando quiser pré-baixar tudo em uma máquina rápida e transferir para hardware mais lento.

Pré-requisitos

O pacote compila módulos XS na máquina de destino. Você precisa de: gcc ou clang, make, perl 5.26+, sqlite3, openssl e cabeçalhos de bibliotecas de imagem.

# 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

Baixar, verificar e executar manualmente

# Baixar o pacote e seu 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 executar
sha256sum -c chinaski-latest.tar.gz.sha256

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

Configurar a URL do site durante a instalação

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

Isso grava o valor na tabela de configurações do SQLite. Também pode ser alterado posteriormente em Admin → Configurações.