Página inicial da VPSie

Voltar para a base de conhecimento

Compreender o desempenho do seu site é fundamental para decisões informadas. Entre as diversas ferramentas de análise disponíveis, o Fathom Analytics se destaca pela simplicidade, foco em privacidade e insights poderosos. Se você opera em um sistema Debian 12 e busca um processo simplificado para integrar o Fathom Analytics ao seu site, está no lugar certo. Neste guia, mostraremos o processo de instalação passo a passo, permitindo que você aproveite as capacidades do Fathom Analytics com facilidade, mantendo a segurança e a estabilidade robustas oferecidas pelo Debian 12.

Primeiro, verifique se você já criou uma conta VPSie; caso contrário, faça isso e depois proceda a Implantar o Debian 12 servidor conforme suas necessidades específicas.

Crie sua conta agora

Antes de instalar qualquer pacote, é crucial atualizar a lista de pacotes do seu sistema para garantir acesso às versões mais recentes. Abra um terminal e execute o comando:

sudo apt-get update -y

Instalar dependências

Para configurar seu ambiente, execute o comando abaixo. Isso instalará o servidor PostgreSQL, o servidor web Nginx, o Certbot, o plugin Nginx Certbot e o UFW (Uncomplicated Firewall).

sudo apt install postgresql nginx certbot python3-certbot-nginx ufw

Confirme o status do serviço PostgreSQL executando o comando a seguir para garantir que ele esteja operacional e habilitado.

sudo systemctl is-enabled postgresql
sudo systemctl status PostgreSQL

Confirme o status do serviço nginx executando o comando fornecido abaixo.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Confirme a instalação do Certbot. O comando a seguir localizará o executável do Certbot e exibirá a versão atual instalada no seu sistema:

which certbot
certbot --version

Configurar Firewall UFW

Para abrir as portas para os protocolos SSH, HTTP e HTTPS, execute o seguinte comando:

sudo ufw allow OpenSSH
sudo ufw allow "WWW Full"

Execute o seguinte comando para iniciar e ativar o UFW no seu sistema Debian.

sudo ufw enable

Por fim, confirme o status do UFW executando o seguinte comando.

sudo ufw status

Configurar Banco de Dados PostgreSQL

Execute o seguinte comando para entrar no servidor PostgreSQL.

sudo -u postgres psql

Para criar um novo banco de dados chamado fathomdb e um usuário chamado fathom com uma senha segura no PostgreSQL, você pode usar as seguintes consultas. Lembre-se de substituir your_secure_password pela sua senha desejada.

CREATE USER fathom WITH CREATEDB CREATEROLE PASSWORD 'your_secure_password';
CREATE DATABASE fathomdb OWNER fathom;

Agora, execute as seguintes consultas para verificar a lista de bancos de dados e usuários disponíveis no servidor PostgreSQL.

\du
\l

Após criar o banco de dados e o usuário, execute o seguinte comando para entrar no PostgreSQL com o usuário fathom e o banco de dados fathomdb. Quando solicitado, insira a senha do seu usuário do banco de dados.

sudo -u postgres psql -U fathom -h 127.0.0.1 -d fathomdb

Após se conectar ao servidor PostgreSQL, execute a seguinte consulta para verificar sua conexão.

\conninfo

Baixar Fathom

Visite a página do Fathom no GitHub para encontrar a URL de download do pacote binário do Fathom. Uma vez que você tenha a URL, pode usar o comando wget para baixá-lo.

wget [URL]

Por exemplo, para baixar a versão 1.3.1 do Fathom, você pode usar o seguinte comando:

wget https://github.com/usefathom/fathom/releases/download/v1.3.1/fathom_1.3.1_linux_amd64.tar.gz

Após o download, descompacte o pacote binário do Fathom no diretório /usr/local/bin/fathom e verifique se ele possui permissões de execução.

tar -C /usr/local/bin -xzf fathom_1.3.1_linux_amd64.tar.gz
chmod +x /usr/local/bin/fathom

Execute o comando abaixo para confirmar a localização do arquivo binário fathom e a versão atualmente baixada.

which fathom
fathom --version

Integrando o Fathom com o PostgreSQL

Para criar um novo usuário de sistema chamado fathom, que gerenciará sua instalação do Fathom, insira o comando abaixo.

sudo useradd -r -d /opt/fathom fathom

Crie um novo diretório home chamado /opt/fathom e atribua a propriedade ao usuário fathom.

sudo mkdir -p /opt/fathom
sudo chown -R fathom:fathom /opt/fathom

Para gerar um segredo aleatório para o Fathom, execute o comando abaixo. Lembre-se de salvar a saída, pois você precisará dela para proteger o Fathom.

head /dev/urandom | tr -dc A-Za-z0-9 | head -c 20 ; echo ''

Navegue até /opt/fathom

cd /opt/fathom

Agora, crie um novo diretório /opt/fathom/data e um novo arquivo /opt/fathom/data/.env usando o comando a seguir.

sudo -u fathom mkdir -p /opt/fathom/data
sudo -u fathom nano /opt/fathom/data/.env

Inclua a configuração abaixo, garantindo que você modifique os detalhes do nome do banco de dados PostgreSQL, do usuário e da senha.

FATHOM_GZIP=true
FATHOM_DEBUG=true
FATHOM_DATABASE_DRIVER="postgres"
FATHOM_DATABASE_NAME="fathomdb"
FATHOM_DATABASE_USER="fathom"
FATHOM_DATABASE_PASSWORD="your_secure_password"
FATHOM_DATABASE_HOST="127.0.0.1"
FATHOM_DATABASE_SSLMODE="disable"
FATHOM_SECRET="BWTtur9A1qWtXG6656q4"

Salve e saia do arquivo.

Execute o comando a seguir para verificar se a configuração do seu Fathom foi bem-sucedida.

cd /opt/fathom/data
sudo -u fathom fathom server

Configure o Fathom como serviço Systemd

Gere um novo arquivo de serviço systemd chamado /etc/systemd/system/fathom.service executando o comando subsequente no editor nano.

sudo nano /etc/systemd/system/fathom.service

Insira a seguinte configuração:

[Unit]
Description=Starts the fathom server
Requires=network.target
After=network.target
[Service]
Type=simple
User=fathom
Restart=always
RestartSec=3
WorkingDirectory=/opt/fathom/data
ExecStart=/usr/local/bin/fathom server
[Install]
WantedBy=multi-user.target

Salve e feche o arquivo.

Execute o comando systemctl a seguir para atualizar o gerenciador systemd e aplicar as modificações realizadas.

sudo systemctl daemon-reload

Agora, execute o comando systemctl abaixo para iniciar e habilitar o serviço fathom.

sudo systemctl start fathom
sudo systemctl enable fathom

Confirme a funcionalidade do serviço fathom executando o comando fornecido abaixo.

sudo systemctl is-enabled fathom
sudo systemctl status fathom

Configurar usuário administrador do Fathom

Navegue para o diretório de trabalho atual /opt/fathom/data.

cd /opt/fathom/data

Use o comando abaixo para criar um usuário administrador para sua instalação do Fathom. Lembre-se de atualizar o endereço de e-mail e a senha com o comando fornecido.

sudo -u fathom fathom user add --email="[email protected]" --password="your_secure_password"

Configurar Nginx como proxy reverso

Usando o editor nano, crie uma nova configuração de bloco de servidor do Nginx nomeada fathom no diretório /etc/nginx/sites-available com o comando fornecido.

sudo nano /etc/nginx/sites-available/fathom

Adicione a configuração fornecida e certifique-se de atualizar o nome do domínio na opção server_name.

server {
    listen 80;
    server_name analytics.menon.fun;
    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:8080; 
    }
}

salve e saia do arquivo.

Execute o comando a seguir para ativar o arquivo de bloco de servidor localizado em /etc/nginx/sites-available/fathom e verificar a sintaxe do Nginx.

sudo ln -s /etc/nginx/sites-available/fathom /etc/nginx/sites-enabled/
sudo nginx -t

Em seguida, execute o comando a seguir para reiniciar o serviço Nginx e aplicar as alterações realizadas.

sudo systemctl restart nginx

Acessar a interface web do Fathom

Abra seu navegador web favorito e acesse o domínio onde sua instalação do Fathom está localizada, como http://analytics.menon.fun/.

Clique em Criar Site para gerar seu rastreador inicial.

Você precisará verificar o código do rastreador gerado pelo Fathom e dar uma olhada na sua página de analytics.

Em resumo, lembre-se de verificar regularmente o painel do Fathom Analytics do seu site e manter seus dados de analytics seguros e íntegros. É como monitorar o pulso do seu site e garantir que seus segredos fiquem trancados a sete chaves!

Voltar para a base de conhecimento