Alojar Ghost® num VPS gerido: a sua publicação, no seu servidor

O que faz o Ghost

O Ghost é uma plataforma de publicação profissional e livre, escrita para Node.js. Reúne no mesmo lugar o que uma publicação independente costuma montar a partir de várias ferramentas.

• A publicação: artigos, páginas, temas personalizáveis, funcionalidades de referenciamento integradas e domínio em seu nome.
• Os membros: inscrição e início de sessão por ligação enviada por e-mail, sem palavra-passe, e conteúdos reservados consoante o nível de cada membro.
• As subscrições pagas: uma conta Stripe ligada ao seu site para vender os seus planos.
• As newsletters: cada artigo pode seguir por e-mail para os seus membros gratuitos ou pagos, ou para um segmento, com um ou vários boletins.
• As API: uma API REST nativa, para ligar um site à medida ou as suas próprias ferramentas.

Segundo a documentação, o produto tem as mesmas funcionalidades em autoalojamento. O que o rodeia fica por sua conta: o envio das newsletters, a análise web, uma CDN e as cópias de segurança completas do site.

A licença MIT e a marca

O Ghost é publicado sob a licença MIT. Autoriza a utilizar, copiar, modificar, fundir, publicar, distribuir, sublicenciar e vender o software, com uma condição: manter a menção de direitos de autor e o texto da licença em qualquer cópia. Pode, portanto, fazer correr o Ghost numa empresa, adaptá-lo e publicar nele para os seus clientes, sem licença para comprar.

A licença cobre o código. O nome e o logótipo pertencem à Ghost Foundation e dependem da sua política de marcas: leia-a se construir uma oferta em torno do software. Ghost é uma marca registada da Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Em português: esta publicação é independente da Ghost Foundation e não é afiliada, autorizada, patrocinada nem aprovada por ela.

Ghost-CLI ou Docker Compose: dois métodos oficiais

O projeto documenta dois caminhos para a produção. O Ghost-CLI é a instalação que recomenda oficialmente, e o Docker Compose é uma «preview», que diz ser muito recente. Indica também avançar para essas ferramentas Docker em vez de fazer evoluir o Ghost-CLI, e fornece um assistente para passar de um ao outro.

Antes de começar: o domínio e o servidor

Faça o domínio apontar para o servidor antes da instalação: o certificado instala-se durante a configuração. Num VPS Simafri, os visitantes chegam pelas portas 80 e 443, sob o nome de domínio do servidor, com registos A e AAAA. O endereço do site escreve-se por inteiro, com o seu protocolo, como https://example.com: um endereço IP provoca erros.

Para lá da memória indicada acima, o projeto não quantifica nem o disco nem a carga: o tamanho depende do seu tráfego, das suas imagens e dos seus multimédia. Num VPS gerido, descreva-nos a sua publicação e recomendamos-lhe o tamanho adequado.

Instalar o Ghost com o Ghost-CLI no Ubuntu

O Ghost-CLI utiliza-se com um utilizador que não seja root e cujo nome não seja ghost, porque esse nome entra em conflito com a ferramenta. Crie-o a partir da conta root, substituindo user pelo nome escolhido:

adduser <user>
usermod -aG sudo <user>
su - <user>

Nginx e MySQL

Atualize o sistema, instale o Nginx (1.9.5 no mínimo para SSL) e o MySQL. A linha ufw abre o HTTP e o HTTPS se esta firewall estiver ativa:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install nginx
sudo ufw allow 'Nginx Full'
sudo apt-get install mysql-server

Nas versões recentes do Ubuntu, a conta root do MySQL autentica-se por socket, o que o Ghost não suporta. Dê-lhe uma palavra-passe:

sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED WITH 'caching_sha2_password' BY '<your-new-root-password>';
FLUSH PRIVILEGES;
exit

Node.js e Ghost-CLI

O Ghost pede o Node.js 22: as versões 20, 21, 23 e seguintes não são suportadas. O projeto pede para o instalar para todo o sistema, desta forma:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
NODE_MAJOR=22
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt-get update
sudo apt-get install nodejs -y
sudo npm install ghost-cli@latest -g

Lançar a instalação

O Ghost instala-se na sua própria pasta, com um proprietário e direitos precisos. Substitua sitename pelo nome da sua escolha:

sudo mkdir -p /var/www/sitename
sudo chown <user>:<user> /var/www/sitename
sudo chmod 775 /var/www/sitename
cd /var/www/sitename
ghost install

O comando faz então as suas perguntas, e o projeto recomenda responder sim a cada passo proposto:

• Blog URL: o endereço exato do site, com https://.
• MySQL: localhost para o anfitrião, root e a palavra-passe definida acima, depois o nome da base de dados, que o Ghost-CLI cria.
• Set up a ghost MySQL user: uma conta MySQL limitada à base de dados do Ghost.
• Set up NGINX e Set up SSL: a configuração do Nginx e o certificado Let’s Encrypt, que pede um endereço de e-mail.
• Set up systemd e Start Ghost: o serviço que mantém o Ghost em funcionamento, e depois o seu arranque.

O site responde então, e https://example.com/ghost convida-o a criar a conta do proprietário. Se a instalação for interrompida, ghost setup retoma a configuração; se falhar, ghost uninstall limpa melhor do que a eliminação da pasta. ghost doctor verifica o sistema a qualquer momento.

Instalar o Ghost com o Docker Compose (preview)

O projeto apresenta este método como uma «preview»: é muito recente para ele. É ele que permite autoalojar a análise web e o ActivityPub.

Num servidor com o Docker instalado, obtenha as ferramentas oficiais em /opt/ghost e copie os seus dois ficheiros de exemplo:

git clone https://github.com/TryGhost/ghost-docker.git /opt/ghost && cd /opt/ghost
cp .env.example .env
cp caddy/Caddyfile.example caddy/Caddyfile

No ficheiro .env, preencha estes valores:

• DOMAIN: o domínio do site, por exemplo example.com.
• ADMIN_DOMAIN: um domínio separado para a administração, se assim o desejar.
• DATABASE_ROOT_PASSWORD e DATABASE_PASSWORD: duas palavras-passe geradas com openssl rand -hex 32. Fixam-se de uma vez por todas: depois de a base de dados inicializada, mudá-las quebra a ligação.
• A secção SMTP Email: a sua retransmissão, detalhada mais abaixo.

Em caddy/Caddyfile, descomente o bloco que corresponde ao seu caso: redirecionamento de www para o domínio sem prefixo, ou o contrário, ou domínio de administração separado. Lance depois o Ghost e termine a configuração em /ghost:

docker compose pull
docker compose up -d

• As portas: só o Caddy publica portas, 80 e 443, modificáveis por HTTP_PORT e HTTPS_PORT se o Ghost passar para trás de outro proxy inverso. O MySQL fica na rede interna dos contentores.
• Os dados: os ficheiros enviados vivem em data/ghost e a base de dados em data/mysql, duas localizações ajustáveis no .env.
• IPv6: o repositório ativa-o por opção, porque exige versões mais recentes do Docker e do Compose. Acrescente então -f compose.yml -f compose.ipv6.yml aos seus comandos docker compose up.

A análise web e o ActivityPub

A análise exige uma conta Tinybird, serviço externo. A partir de /opt/ghost, inicie sessão, implemente a sua configuração e obtenha os tokens a colar no .env, secção «Tinybird configuration»:

docker compose run --rm tinybird-login
docker compose run --rm tinybird-sync
docker compose run --rm tinybird-deploy
docker compose run --rm tinybird-login get-tokens

O ActivityPub funciona logo com o serviço alojado pelo projeto, gratuito dentro de limites de utilização que a sua documentação publica. Para autoalojar o seu, descomente ACTIVITYPUB_TARGET=activitypub:8080. Ative depois no .env o ou os perfis pretendidos e reinicie os contentores:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Para o ActivityPub, o projeto pede para recriar também o Ghost e o Caddy, com docker compose up -d --force-recreate ghost caddy.

Passar do Ghost-CLI ao Docker Compose

Depois da clonagem e da configuração, bash scripts/migrate.sh copia a pasta content, importa a base de dados para o contentor MySQL e arranca o Caddy no lugar do Nginx. Propõe parar o Nginx, o que coloca o site fora de linha: responda não se houver outros sites a correr no servidor. Não elimina nenhum dado. bash recovery_instructions.sh restabelece o site de origem se interromper a migração.

HTTPS e domínio de administração

A administração do Ghost deve passar por HTTPS, e o projeto recomenda o HTTPS para todo o site: sem ele, credenciais e palavras-passe circulam em claro. Com o Docker Compose, o Caddy trata disso. Com o Ghost-CLI, a instalação instala o certificado, e um comando fá-lo depois:

ghost setup ssl

Para mudar o endereço de um site instalado com o Ghost-CLI, ghost config url https://example.com atualiza a configuração, e ghost restart aplica-a.

O projeto aconselha também um domínio de administração separado, que reduz a superfície de ataque. O caminho continua a ser /ghost/. Do lado do Ghost-CLI, declara-se em config.production.json:

"admin": {
  "url": "https://admin.example.com"
}

Do lado do Docker Compose, preencha ADMIN_DOMAIN, descomente o seu bloco no Caddyfile e execute docker compose up -d --force-recreate ghost caddy. Este domínio precisa também dos seus registos A e AAAA.

MySQL 8, a base de dados de produção

O MySQL 8 é a única base de dados que o projeto suporta em produção. O Ghost-CLI instala-se com o MySQL 8.0 ou 8.4, e o ficheiro Compose fornece uma imagem MySQL 8.0.

• A partir do SQLite: o projeto recomenda uma reinstalação completa no MySQL 8.
• A partir do MariaDB: recomenda vivamente a migração para o MySQL 8.
• Para verificar: ghost config database.client, na pasta do site, indica a base de dados utilizada.

Os e-mails e as newsletters

O Ghost distingue dois envios, que não passam pelo mesmo caminho. É o ponto mais importante a acertar depois da instalação.

A retransmissão SMTP, para os e-mails transacionais

A documentação classifica esta configuração como requerida em produção. O Ghost envia também um código por e-mail quando deteta um início de sessão a partir de um novo dispositivo: configure esta retransmissão antes de convidar a sua equipa.

Num VPS Simafri, o envio passa por uma retransmissão SMTP autenticada, na porta 587: o endereço de uma conta de correio que já tenha, ou o Simafri Suite.

"mail": {
  "transport": "SMTP",
  "from": "'Acme Support' <support@example.com>",
  "options": {
    "host": "smtp.example.com",
    "port": 587,
    "secure": false,
    "requireTLS": true,
    "auth": {
      "user": "support@example.com",
      "pass": "1234567890"
    }
  }
}

mail__transport=SMTP
mail__options__host=smtp.example.com
mail__options__port=587
mail__options__secure=false
mail__options__requireTLS=true
mail__options__auth__user=support@example.com
mail__options__auth__pass=1234567890
mail__from="'Acme Support' <support@example.com>"

docker compose up -d --force-recreate ghost

• secure e requireTLS: o Ghost envia pelo Nodemailer, cuja documentação pede secure a false na porta 587, passando a ligação depois a STARTTLS. requireTLS recusa o envio se essa passagem falhar. O ficheiro de exemplo do repositório indica a porta 465 e secure=true: substitua estas duas linhas.
• O endereço de expedição: from contém um endereço real e lido, o que melhora a entregabilidade segundo o projeto, e os registos SPF, DKIM e DMARC do domínio de envio completam a configuração.
• O teste: convide um membro da equipa a partir da administração e verifique a receção.

Mailgun, para as newsletters

A retransmissão SMTP não cobre as newsletters. Segundo a documentação, o envio em massa não se faz em SMTP e o Mailgun é, atualmente, o único serviço de envio em massa que o Ghost suporta. Crie a sua conta Mailgun e introduza as respetivas chaves de API nas definições do Ghost.

Se não enviar os seus artigos por e-mail, não precisa de nenhuma conta Mailgun: estas definições ignoram-se. Se preferir outra ferramenta de newsletter, o projeto propõe sincronizar os seus membros com ela, por exemplo com o Zapier ou com os seus guias de integração.

Copiar e restaurar o Ghost

O Ghost propõe três níveis de cópia, e não contêm a mesma coisa. Para reconstruir um site de forma idêntica, o projeto pede para copiar diretamente a base de dados e a pasta content.

A exportação encontra-se em «Settings», «Advanced», «Import/Export», separador «Export», botão «All data». Para a cópia completa, com o Ghost-CLI, a conta MySQL e o nome da base de dados a indicar estão em config.production.json:

mkdir -p ~/ghost-backups
mysqldump -u ghost_user -p ghost_production > ~/ghost-backups/ghost_backup.sql
cd /var/www/sitename
tar czf ~/ghost-backups/ghost_content_backup.tar.gz content/

Com o Docker Compose, as ferramentas oficiais guardam o conteúdo em data/ghost. O dump retoma a forma dada pela imagem MySQL, e a palavra-passe root já está no contentor. Guarde também uma cópia do .env e do Caddyfile.

cd /opt/ghost
mkdir -p ~/ghost-backups
docker compose exec -T db sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' > ~/ghost-backups/ghost_backup.sql
tar czf ~/ghost-backups/ghost_content_backup.tar.gz data/ghost

Restaurar

cd /var/www/sitename
ghost stop
mysql -u ghost_user -p ghost_production < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
sudo chown -R ghost:ghost content
ghost restart

cd /opt/ghost
docker compose stop ghost
docker compose exec -T db sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
docker compose start ghost

Copie estes ficheiros para fora do servidor, com rsync ou scp, e faça um teste de restauro numa máquina de ensaio. Se recomeçar a partir de uma exportação com membros pagos, ligue a mesma conta Stripe antes de importar os seus membros.

Atualizar o Ghost

O projeto publica atualizações todas as semanas e lembra que um servidor web público deve manter-se atualizado. Leia as notas de versão e execute depois o comando do seu método.

Com o Ghost-CLI

ghost check-update
ghost backup
ghost update

• O regresso ao estado anterior: ghost update --rollback volta à versão anterior se uma atualização correr mal.
• A pasta content mantém-se no lugar durante as atualizações.
• As versões principais chegam a cada 12 a 18 meses e quebram a compatibilidade: a documentação pede cópias de segurança, a leitura das alterações e a verificação da compatibilidade do tema.
• Node.js: mude-o separadamente do Ghost e execute depois ghost update [version] --force com a sua versão atual, porque as suas dependências binárias são compiladas para uma versão precisa do Node.js.

Com o Docker Compose

cd /opt/ghost
git pull
docker compose pull
docker compose up -d
docker image prune

A última linha, facultativa, retira as imagens antigas. Deixe GHOST_VERSION em comentário no .env: fixar uma versão bloqueia estes comandos de atualização.

Reforçar e fazer crescer a sua instância

A documentação dá várias definições para um servidor em produção:

• MySQL: execute mysql_secure_installation depois de uma instalação Ghost-CLI bem-sucedida.
• A firewall: regras UFW para SSH, Nginx, HTTP e HTTPS, sem outra firewall ao lado.
• SSH: início de sessão apenas por chave, sem palavra-passe, e sem conta root.
• A equipa: a autenticação de dois fatores torna-se obrigatória para todos os inícios de sessão em «Settings», «Staff».

Para a carga, o projeto coloca uma CDN e uma camada de cache à frente do Ghost. Esclarece que o clustering e o sharding não são suportados: uma única instância serve o site, e a cache absorve o tráfego.

Quem faz o quê num VPS gerido

O autoalojamento exige cuidar do servidor para além da aplicação. Num VPS gerido, as nossas equipas assumem o servidor e acompanham a sua instância de forma proativa; o Ghost continua a ser o seu software, com as suas definições e os seus dados.

Se preferir que as nossas equipas intervenham na própria aplicação, este serviço é faturado à hora ou por pacote, com um orçamento comunicado antes da intervenção.