Como Instalar o Software de Orçamento Atual no Servidor Debian 12

O Actual Budget é um software de gerenciamento financeiro de código aberto focado na privacidade e construído sobre o “Orçamento Estilo Envelope”. O Actual é escrito em Node.js e pode ser instalado localmente em pouco tempo. Ele suporta sincronização em múltiplos dispositivos e criptografia de ponta a ponta opcional.

Neste tutorial, vamos mostrar como instalar o Sistema de Orçamento Actual no servidor Debian 12. Você instalará o Actual com o Nginx como um proxy reverso e o protegerá com HTTPS através do Certbot e Letsencrypt.

Pré-requisitos

Para começar este tutorial, certifique-se de que você tem:

• Um servidor Debian 12
• Um usuário não-root com privilégios de administrador
• Um nome de domínio apontado para o endereço IP do servidor

Instalando Node.js e Yarn

Antes de instalar o Actual, você deve garantir que o Node.js, Git e o gerenciador de pacotes Yarn estejam instalados em seu sistema. Neste momento, o Actual requer Node v18 ou superior, que pode ser instalado a partir do repositório oficial do Debian.

Primeiro, execute o comando ‘ apt ‘ abaixo para atualizar o índice de pacotes do Debian e instalar pacotes básicos como Node.js, NPM e Git. Digite ‘ Y ‘ para confirmar a instalação.

sudo apt update  
sudo apt install nodejs npm git

Após a instalação ser concluída, instale o gerenciador de pacotes Yarn usando o comando ‘ npm ‘ abaixo. Neste exemplo, você instalará o Yarn globalmente ou em todo o sistema.

npm install --global yarn

Quando terminar, verifique a versão do Node.js e do Yarn com o comando abaixo.

node --version  
yarn --version

Na saída abaixo, você pode ver que o Node.js 18 e o Yarn 1.22 estão instalados.

Baixando o Código Fonte do Actual Budget

Após as dependências serem instaladas, você está pronto para baixar o código fonte do Actual, instalar dependências via Yarn, configurar o Actual com o arquivo ‘config.json’ e, em seguida, executar o Actual via linha de comando. Além disso, você precisa de um usuário dedicado para instalar e executar o Actual em seu sistema.

Faça login no seu usuário com o comando abaixo.

su - username

Baixe o código fonte do Actual Budget com o comando ‘ git ‘ abaixo.

git clone https://github.com/actualbudget/actual-server.git

Vá para o diretório ‘ actual-server ‘ e instale as dependências do JavaScript com o comando ‘ yarn ‘ abaixo.

cd actual-server  
yarn install

Você pode ver abaixo a instalação das dependências do JavaScript via gerenciador de pacotes Yarn.

Após a instalação ser concluída, crie um novo arquivo ‘ config.json ‘ usando o editor ‘ nano ‘.

nano config.json

Insira a configuração abaixo para executar o Actual no endereço IP local com a porta padrão 5006.

{  
 "hostname": "127.0.0.1",  
 "port": 5006  
}

Salve o arquivo e saia do editor.

Por fim, execute o comando ‘ yarn start ‘ abaixo para iniciar o software actual. Isso abrirá a porta 5006 em seu localhost ou endereço ‘ 127.0.0.1 ‘ que será usado pela aplicação.

yarn start

Pressione Ctrl+c para terminar o processo.

Executando o Actual em Segundo Plano como um Serviço Systemd

Agora que você instalou e configurou o Actual, vamos criar um novo arquivo de serviço systemd para executar o Actual em segundo plano como um serviço systemd.

Crie um novo arquivo de serviço systemd ‘ /etc/systemd/system/actual.service ‘ com o seguinte editor ‘ nano ‘.

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

Insira a configuração abaixo para executar o Actual em segundo plano como um serviço systemd. Certifique-se de alterar o ‘ User ‘ e ‘ Group ‘ padrão com seu nome de usuário, e depois mude o ‘ WorkingDirectory ‘ para o seu caminho correto.

[Unit]  
Description=Actual-Server (https://actualbudget.org)  
After=network.target  
  
[Service]  
User=flash  
Group=flash  
WorkingDirectory=/home/flash/actual-server/  
ExecStart=/usr/local/bin/yarn start  
Restart=on-watchdog  
  
[Install]  
WantedBy=multi-user.target

Salve o arquivo e saia do editor quando terminar.

Agora execute o comando ‘ systemctl ‘ abaixo para recarregar o gerenciador systemd e aplicar suas alterações.

sudo systemctl daemon-reload

E então, inicie e habilite o ‘ actual.service ‘ usando o seguinte comando. Isso iniciará o ‘ actual.service ‘ em segundo plano e habilitará para ser executado automaticamente na inicialização do sistema.

sudo systemctl enable --now actual.service

Verifique o status do ‘ actual.service ‘ com o comando abaixo. Você deve ver que o ‘ actual.service ‘ está em execução e habilitado em seu sistema.

sudo systemctl status actual.service

Configurando o Nginx como um Proxy Reverso

Neste ponto, o Actual está em execução em segundo plano como um serviço systemd. Nesta seção, você instalará o Nginx e o configurará como um proxy reverso para o Actual. Depois disso, você gerará certificados SSL para sua implantação do Actual via Certbot e Letsencrypt.

Primeiro, execute o comando ‘ apt ‘ abaixo para instalar o Nginx, Certbot e o plugin Python3 Certbot Nginx. Digite ‘ Y ‘ para prosseguir com a instalação.

sudo apt install nginx certbot python3-certbot-nginx -y

Após a instalação ser concluída, crie um novo arquivo de bloco de servidor Nginx ‘ /etc/nginx/sites-available/actual-budget ‘ com o editor ‘ nano ‘.

sudo nano /etc/nginx/sites-available/actual-budget

Insira a configuração abaixo e certifique-se de alterar o parâmetro ‘ server_name ‘ com seu nome de domínio.

server {  
listen 80;  
server_name budget.howtoforge.local;  
  
location / {  
include /config/nginx/proxy.conf;  
include /config/nginx/resolver.conf;  
  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header Host $host;  
  
set $upstream_app 127.0.0.1;  
set $upstream_port 5006;  
set $upstream_proto http;  
proxy_pass $upstream_proto://$upstream_app:$upstream_port;  
}  
}

Quando terminar, salve o arquivo e saia do editor.

Agora execute o comando abaixo para ativar o bloco de servidor ‘ actual-budget ‘ e verificar suas configurações do Nginx. Se não houver erro, você receberá uma saída como ‘ syntax is ok - test is successful ‘.

sudo ln -s /etc/nginx/sites-available/actual-budget /etc/nginx/sites-enabled/  
sudo nginx -t

Em seguida, execute o comando abaixo para reiniciar e verificar o status do serviço Nginx. Certifique-se de que o servidor web Nginx está em execução.

sudo systemctl restart nginx  
sudo systemctl status nginx

Por fim, execute o comando ‘ certbot ‘ abaixo para gerar certificados SSL e proteger sua instalação do software Actual. Certifique-se de alterar o nome de domínio e o endereço de e-mail no seguinte comando.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email <[email protected]> -d budget.howtoforge.local

Quando o processo for concluído, sua instalação do Actual deve estar protegida com HTTPS via Certbot e Letsencrypt. Seus certificados SSL estão disponíveis no diretório ‘ /etc/letsencrypt/live/domain.com ‘ e o HTTPS é automaticamente habilitado em seu arquivo de bloco de servidor.

Acessando o Actual Budget via Navegador Web

Visite o nome de domínio da sua instalação do Actual, como https://budget.howtoforge.local. Se for bem-sucedido, você verá a mensagem de boas-vindas ao Actual e será solicitado a configurar uma senha.

Digite sua nova senha e repita, em seguida, clique em ‘ OK ‘.

Uma vez que a senha esteja configurada, insira sua senha para fazer login no Painel do Actual.

Pela primeira vez, você será solicitado a ver dados de demonstração ou começar do zero.

Se você está familiarizado com o Actual, pode clicar em ‘ Começar do zero ‘, mas se você é novo no Actual, clique em ‘ Ver demonstração ‘ para entender o uso básico do Actual.

Abaixo está um exemplo de dados de demonstração do Sistema de Orçamento Actual.

Conclusão

Parabéns! Você completou a instalação do Actual, um software financeiro focado na privacidade, em um servidor Debian 12. Você tem o Actual em funcionamento como um serviço systemd em segundo plano, que está rodando em cima do proxy reverso Nginx. Além disso, você também protegeu o Actual com HTTPS através do Certbot e Letsencrypt.