Como instalar o FreshRSS na Saplo (leitor de RSS ao estilo do Google Reader)

Acompanhar dezenas de sites e blogs visitando cada um deles é uma perda de tempo, e serviços como o Inoreader cobram uma mensalidade por algo que o Google oferecia de graça no Google Reader, antes de o fechar. O FreshRSS é um leitor de feeds RSS e Atom de código aberto que reproduz essa experiência: pastas com feeds, tags, atalhos de teclado rápidos e uma API própria compatível com o Fever e o Google Reader para aplicações móveis como o Reeder ou o FeedMe. Abaixo, passo a passo, como instalar o FreshRSS no Saplo.

Por que usar o FreshRSS em vez de um leitor RSS pago?

Os leitores RSS pagos na cloud têm duas características que mais incomodam as pessoas que seguem muitas fontes:

• a subscrição aumenta com o tempo - o plano gratuito geralmente limita o número de canais ou a frequência de atualização, e a funcionalidade completa, incluindo o acesso a partir de uma aplicação móvel via API, geralmente está bloqueada por uma subscrição paga de cerca de vários euros por mês,
• os teus dados de leitura estão num servidor de terceiros - o histórico de artigos lidos, as marcações de estrela e a lista de canais subscritos estão nas mãos de uma empresa externa, e não contigo.

O FreshRSS funciona como um único contentor Docker na tua Box, com SQLite incorporado como base de dados, pelo que todo o conjunto de canais e histórico de leitura permanecem na tua infraestrutura, sem limite no número de canais e sem taxa mensal para além do custo da própria Box.

FreshRSS para Miniflux, ou a segunda receita de leitor de RSS no catálogo Saplo

O Miniflux já está no catálogo Saplo, então a pergunta natural é: por que duas receitas para a mesma tarefa? A resposta está na diferença de abordagem:

• O Miniflux é propositadamente minimalista, um único ficheiro binário em Go, uma lista simples de feeds sem pastas, para pessoas que querem o mínimo de configurações para clicar.
• O FreshRSS tem uma vista de pastas e tags para organizar um maior número de feeds, a sua própria API compatível com Fever e Google Reader, o que abre as portas para uma lista mais ampla de aplicações móveis, e uma base de utilizadores maior e desenvolvida há mais tempo.

Se segues alguns feeds e queres simplicidade, experimenta o Miniflux. Se tens dezenas de fontes divididas por tópicos e queres lê-las no teu telemóvel através de uma aplicação como o Reeder, o FreshRSS é mais adequado.

Requisitos

Para instalares o FreshRSS na Saplo, precisas de:

• Uma Box com Docker ativado (o motor liga-o automaticamente durante a instalação a partir do catálogo, sendo necessário o aninhamento no contentor, que a Saplo tem por predefinição),
• Um mínimo de 256 MB de RAM livre na Box e 2 GB de espaço em disco, ou seja, o plano Box S (27 € por ano) é suficiente,
• Um domínio ou subdomínio *.saploapp.pl incluído em cada plano, onde o leitor será alojado,
• NÃO precisas de uma base de dados separada, o FreshRSS armazena os feeds e o histórico de leitura no SQLite incorporado no volume do Docker.

Instalação passo a passo

1. No painel Saplo, entra em Catálogo de aplicações e seleciona FreshRSS (categoria "Negócios").
2. Indica o Box com, no mínimo, 256 MB de RAM livre onde o leitor será instalado, bem como o domínio ou subdomínio sob o qual irá operar.
3. Confirma a instalação. O motor irá criar um contentor a partir da imagem oficial freshrss/freshrss, configurar uma conta de administrador de forma autónoma (sem o assistente manual no navegador) e expô-la apenas ao loopback do Box, conectado ao nginx, que o serve sob o domínio especificado com SSL gratuito. Apenas a porta 443 é exposta externamente, não a porta bruta do contentor.
4. Após docker compose up, o motor verifica adicionalmente se a página de login do FreshRSS realmente responde via HTTP, pois o status "contentor em execução" não significa que a instalação autónoma (flags FRESHRSS_INSTALL/FRESHRSS_USER) foi realmente bem-sucedida.
5. Após a conclusão da instalação, os dados de login do administrador, incluindo uma palavra-passe separada para a API para aplicações móveis, são guardados no ficheiro FRESHRSS-SETUP.txt no Box.

Primeira configuração

A conta de administrador fica pronta imediatamente após a instalação, portanto, os primeiros passos são fazer login e adicionar feeds, em vez de passar por um assistente.

1. Acede ao endereço do domínio, por exemplo, czytnik.saploapp.pl, e faz login com os dados do ficheiro FRESHRSS-SETUP.txt.
2. Altera a palavra-passe imediatamente após o primeiro login em Parâmetros do utilizador -> Alterar palavra-passe.
3. Adiciona feeds com o botão Subscrever no painel, um por um pelo endereço do site ou em massa importando um ficheiro OPML exportado do teu leitor anterior.
4. Organiza os feeds em pastas e marca-os com etiquetas na vista de gestão de feeds, o que diferencia o FreshRSS da lista plana no Miniflux.
5. Para a aplicação móvel (Reeder, FeedMe e outras que suportam Fever ou Google Reader), faz login com o endereço do Box e uma palavra-passe de API separada, guardada no mesmo ficheiro FRESHRSS-SETUP.txt, não a palavra-passe do painel web.

FreshRSS na Saplo vs. leitor pago na cloud

Perguntas Frequentes

O FreshRSS precisa de uma base de dados separada? Não, por padrão, ele usa o SQLite integrado no volume do Docker. O motor do Saplo não configura nenhum contentor de base de dados adicional para ele.

Qual é a diferença entre FreshRSS e Miniflux, visto que ambos estão no catálogo do Saplo? O Miniflux é intencionalmente minimalista e tem uma lista de feeds simples. O FreshRSS adiciona pastas, tags e a sua própria API compatível com Fever e Google Reader, o que é importante ao usar aplicações móveis.

É possível importar feeds de outro leitor? Sim, em Parâmetros do Utilizador -> Importar/Exportar podes carregar um ficheiro OPML exportado de qualquer outro leitor de RSS.

Como me autentico a partir de uma aplicação móvel como o Reeder? Precisas de fornecer o endereço do teu Box e a palavra-passe da API separada, que está guardada no ficheiro FRESHRSS-SETUP.txt e foi gerada automaticamente durante a instalação, não a palavra-passe do painel web.

Se segues muitas fontes e procuras um leitor de RSS sem subscrição mensal e sem limite de feeds, entra em contacto connosco. Vamos ajudar-te a escolher o Box certo para o teu conjunto de fontes.