Como instalar o Misskey no Raspberry Pi

As plataformas de redes sociais e os serviços de microblogging desempenham um papel crucial na criação de uma comunidade em linha. Embora os serviços de propriedade de empresas, como o Threads e o Twitter, sejam eficazes na acumulação de um número substancial de seguidores, o Fediverse dá prioridade a conversas e ligações íntimas entre indivíduos.

A Misskey é uma plataforma online multifacetada que oferece armazenamento na nuvem e funcionalidades do Fediverse, permitindo aos utilizadores criar o seu próprio espaço personalizado na Internet centrado num interesse partilhado.

O que é a Misskey?

O Fediverso é uma rede extensa de nós interligados, composta por servidores individuais que funcionam de forma independente como plataformas de redes sociais ou que se juntam através da federação. Todos estes servidores estão em conformidade com o protocolo ActivityPub, sendo o Mastodon a variedade predominante. O processo de criação de um servidor Mastodon no seu próprio hardware de computação é relativamente simples.

A seleção de um servidor é frequentemente influenciada pelas preferências pessoais de cada um, bem como pelas inclinações de outros indivíduos que o vão utilizar juntamente com eles.

As origens de Misskey estão enraizadas no Japão, e a estética visual do seu trabalho exibe características reminiscentes da cultura anime, apresentando uma entidade felina vestida com um uniforme escolar como sua representação emblemática.

Por favor, não se deixe enganar pela sua aparência, pois o Misskey é um software de código aberto ativamente desenvolvido e totalmente compatível com o resto do Fediverso.

O editor de PDF Misskey é altamente personalizável, oferece opções de armazenamento na nuvem para utilizadores individuais e pode ser expandido através da utilização de plugins, tornando-o uma ferramenta excecionalmente versátil no que diz respeito à sua interface web.

Instalar Misskey no seu Raspberry Pi

Para começar com a tarefa em mãos, é imperativo que se adira às estipulações descritas no nosso guia abrangente, que engloba o processo de configuração do Raspberry Pi como um servidor web funcional. Embora a instalação do MariaDB, PHP e Docker Compose possa não ser imediatamente necessária, eles apresentam utilidade potencial em relação a outros empreendimentos envolvendo o Raspberry Pi.

A obtenção de um nome de domínio é um passo essencial na criação de um sítio Web. Se ainda não possui um, visite o seu fornecedor de serviços de registo e navegue até às opções avançadas de DNS. A partir daí, crie um novo registo A, especificando o anfitrião como ‘@’ e o campo de valor com o seu endereço IP. Além disso, defina o valor do Time to Live (TTL) para o número mais baixo possível e certifique-se de que as alterações são guardadas.

O Docker Compose oferece um meio fácil de configurar uma versão em contentor do Misskey no seu Raspberry Pi, sem quaisquer conflitos potenciais com outro software instalado no seu dispositivo. No entanto, a versão do Docker Compose disponível no repositório padrão do Raspberry Pi OS é obsoleta e não é adequada para esse esforço específico. Portanto, é necessário conectar-se ao Raspberry Pi através deSecure Shell (SSH)e depoisInstalar manualmente o Docker Compose seguindo as instruções fornecidas abaixo.

O processo de instalação do Misskey em um Raspberry Pi está agora à mão.

Por favor, siga estes passos para obter uma cópia do código Misskey do GitHub e transferi-lo para a sua máquina local:1. Clone o repositório Misskey copiando o seu URL ( https://github.com/trending/misskey ) usando o comando git clone no seu terminal ou prompt de comando. Isto irá criar uma cópia local de todo o projeto Misskey no seu computador. Por exemplo, poderá ver um resultado como este:bash$ git clone https://github.com/trending/misskey2 . Mude de diretório para a pasta Misskey recentemente criada utilizando o comando cd . Pode verificar que está agora dentro do diretório correto verificando o terminal ou a linha de comandos. O nome do diretório deve ser algo como /path/to/Misskey . Por exemplo:bash

 git clone -b master https://github.com/misskey-dev/misskey.git && cd misskey 

A plataforma Misskey oferece um exemplo de definição de implementação, Docker Compose, e ficheiros de configuração para conveniência dos utilizadores. Para replicar essas configurações em uma configuração ativa, é possível seguir esta sequência de instruções:

 cp .config/docker_example.yml .config/default.yml
cp .config/docker_example.env .config/docker.env
cp ./docker-compose.yml.example ./docker-compose.yml 

O Dockerfile especifica as variáveis de ambiente necessárias para se conectar a um banco de dados PostgreSQL, que pode ser modificado editando o arquivo “docker.env” usando um editor de texto de sua escolha.

 nano .config/docker.env 

Para tornar um ficheiro de configuração mais seguro, é aconselhável utilizar palavras-passe fortes que sejam difíceis de adivinhar. As instruções fornecidas sugerem a utilização de uma ferramenta chamada “bc” para gerar números aleatórios como palavras-passe, que podem ser armazenados no ficheiro de configuração de forma encriptada. Além disso, as instruções recomendam a edição de outro ficheiro denominado “default.yml” para incluir informações sensíveis, como chaves de API ou credenciais de bases de dados, mas salientam a importância de manter estes detalhes confidenciais.

 nano .config/default.yml 

Navegue até a seção referente à configuração do PostgreSQL na documentação e insira as credenciais do banco de dados que foram estabelecidas anteriormente no arquivo de ambiente do Docker. Uma vez feito isso, salve as alterações pressionando “Ctrl + O” seguido de sair do editor usando “Ctrl + X”.

A porta especificada, trinta e cem (3000), deve ser utilizada para a visualização do Misskey. Caso esta porta específica já tenha sido atribuída, é favor modificar o ficheiro docker-compose para selecionar uma porta alternativa.

O processo de construção e configuração da base de dados, bem como a execução das actualizações necessárias, podem ser realizados através de uma série de comandos conhecidos como “migrações”. Siga os seguintes passos para concluir esta tarefa:

 sudo docker-compose build
sudo docker-compose run --rm web pnpm run init 

É importante notar que este processo requer algum tempo e atenção, uma vez que deixá-lo sem supervisão pode resultar em dados incompletos ou incorrectos. Por isso, é aconselhável não realizar outras actividades, como navegar na Wikipédia, durante este período, que pode durar até oito minutos.

Para permitir o carregamento de ficheiros no Misskey, é necessário adquirir a propriedade do diretório de ficheiros utilizando o seguinte processo:

 sudo chown -hR 991.991 ./files 

Se não conseguir completar esta tarefa, irá encontrar uma mensagem de erro técnico com o código identificador 5d37dbcb-891e-41ca-a3d6-e690c97775ac ao tentar carregar qualquer conteúdo visual.

Trazer Misskey para cima com:

 docker-compose up -d 

your-pi-local-ip-address:3000 .

Para obter uma compreensão mais profunda do estado e da atividade do contentor Docker do Misskey, a instalação e utilização do LazyDocker pode ser considerada uma opção.

Expor a sua instância Misskey à Web

O processo de criação de um ficheiro de configuração para o Apache2 e o Certbot foi iniciado, uma vez que ambos os programas de software foram previamente instalados. Este é o momento oportuno para realizar esta tarefa.

 cd /etc/apache2/sites-available && sudo nano misskey.conf 

No novo ficheiro, cole o seguinte:

 <VirtualHost *:80>

    ServerName muo.lol

    ProxyPass / http://127.0.0.1:3000/
    ProxyPassReverse / http:/127.0.0.1:3000/
    ProxyPreserveHost On

</VirtualHost> 

Caso a porta no arquivo de configuração do Docker Compose seja alterada, ela também deve ser ajustada neste local. Certifique-se de que o nome de domínio personalizado especificado (muo.lol) é substituído pelo seu e evite incluir quaisquer prefixos HTTP ou HTTPS. Uma vez efectuadas as alterações, guarde o ficheiro utilizando o atalho de teclado “Ctrl + O”, seguido de “Ctrl + X”. Em seguida, active o ficheiro de configuração e reinicie o servidor Apache.

 sudo a2ensite misskey.conf
sudo service apache2 restart

A utilização do Certbot facilita a aquisição e a implementação de certificados TLS (Transport Layer Security) e das respectivas chaves criptográficas para uma instalação Misskey.Para iniciar o processo, pode começar por executar o seguinte comando:

 sudo certbot

Seleccione um nome de domínio da lista fornecida e prima a tecla Enter, seguindo-se o restauro do servidor Apache através da execução dos comandos necessários.

 sudo service apache2 restart

A sua instância Misskey foi protegida contra ataques man-in-the-middle e está agora acessível através da Web.

Criar a sua conta de administrador Misskey

Introduza o seu nome de domínio no seu browser preferido para aceder à sua instância Misskey. Em seguida, crie uma conta de administrador com uma palavra-passe forte. O nome de utilizador do administrador terá a forma de “[username]@[your-misskey-instance].tld”, e só é permitido modificar a parte inicial deste nome de utilizador.

Crie um perfil nesta plataforma definindo os detalhes da sua conta. Embora tenha a opção de adiar o processo, o assistente de registo aparecerá pouco tempo depois, causando inconvenientes durante outras tarefas. Para prosseguir com a criação do seu perfil, seleccione uma imagem de perfil, introduza as suas informações pessoais e conclua o registo clicando em “Guardar” e prosseguindo com os restantes passos.

O ecrã seguinte apresenta várias alternativas de privacidade para a sua conta de utilizador. É-lhe concedida a liberdade de determinar se a aceitação de solicitações de seguidores é obrigatória ou opcional, permitir ou proibir que os rastreadores da Web cataloguem as suas contribuições, especificar se pretende impedir que a inteligência artificial adquira conhecimentos com base nas suas publicações e até optar por ocultar a sua disponibilidade atual na Internet. Leia o resto das opções à vontade.

Como personalizar a sua instância Misskey

Os utilizadores administradores, como você, têm a capacidade de personalizar e regular os parâmetros da instância através da utilização do Painel de Controlo, que pode ser acedido através da barra de navegação localizada no lado esquerdo da página.

O painel de controlo fornece uma vasta gama de pontos de dados, incluindo informações sobre utilizadores activos, utilizadores online e outros servidores ligados. Além disso, oferece a opção de personalizar conjuntos de emojis através da utilização de pacotes especializados.

No painel de definições do painel de controlo, no separador geral, é possível fornecer informações específicas sobre a sua instância, incluindo a sua designação, um relato da mesma e os dados do seu guardião. Não é obrigatório divulgar esses dados, mas um relatório completo ajudará os utilizadores a decidirem se querem afiliar-se à instância ou procurar opções alternativas.Além disso, é possível selecionar se os documentos remotos devem ser armazenados na cache. A desativação desta funcionalidade resulta na redução da utilização do armazenamento, mas aumenta a utilização da rede.

A funcionalidade de marca do Misskey permite a personalização de vários elementos visuais, como URLs para ícones, banners, imagens de fundo, imagens de erro e definições de tema. Estas configurações contribuem para a estética geral da instância Misskey, permitindo assim aos utilizadores experimentar diferentes visuais utilizando a opção “Settings > Themes”.

A gestão adequada dos registos de contas é crucial para manter um servidor Fediverse eficaz, sendo essencial implementar medidas para regular o acesso à plataforma. A opção Ativar registo de novos utilizadores permite aos administradores determinar se devem ser permitidas ou recusadas novas contas no seu sistema. Além disso, se houver um número excessivo de utilizadores locais, o Raspberry Pi pode ficar sobrecarregado. Por conseguinte, recomenda-se a imposição de um requisito para que as contas recentemente criadas incluam um endereço de correio eletrónico válido.

É aconselhável que todos os indivíduos se familiarizem com as directrizes estabelecidas na secção “Regras do servidor”, que descreve as expectativas básicas de conduta para todos os membros da comunidade. A criação de tais regras não é obrigatória, no entanto serve como um ponto de referência útil para quaisquer acções futuras que possam necessitar do uso de medidas disciplinares. Estas regras podem ser mantidas concisas ou expandidas em maior pormenor no âmbito do acordo “Termos de Serviço”. É encorajado a adicionar contas de utilizador e a atribuir funções de acordo com o seu critério.

Misskey é um ótimo software para criar um servidor Fediverse!

O processo de integração do Misskey é simples e descomplicado, exigindo um esforço mínimo para ser estabelecido e personalizado. Além disso, caso surja alguma dificuldade durante este processo, pode ser consultada uma infinidade de pessoas de apoio para obter assistência.

Em alternativa, pode considerar-se a possibilidade de explorar várias outras opções no âmbito das instâncias do Fediverse que podem ser alojadas num Raspberry Pi, caso o Misskey não se revele a solução ideal.