Как установить Actual Budgeting Software на сервер Debian 12

Actual Budget — это программное обеспечение для управления финансами с открытым исходным кодом, ориентированное на конфиденциальность и основанное на “бюджетировании в стиле конвертов”. Actual написан на Node.js и может быть установлен локально за короткое время. Он поддерживает синхронизацию на нескольких устройствах и опциональное сквозное шифрование.

В этом руководстве мы покажем вам, как установить систему бюджетирования Actual на сервер Debian 12. Вы установите Actual с Nginx в качестве обратного прокси и защитите его с помощью HTTPS через Certbot и Letsencrypt.

Предварительные требования

Для начала этого руководства убедитесь, что у вас есть:

• Сервер Debian 12
• Непривилегированный пользователь с правами администратора
• Доменное имя, указывающее на IP-адрес сервера

Установка Node.js и Yarn

Перед установкой Actual вы должны убедиться, что Node.js, Git и менеджер пакетов Yarn установлены на вашей системе. В настоящее время Actual требует Node v18 или выше, который можно установить из официального репозитория Debian.

Сначала выполните команду ‘ apt ‘ ниже, чтобы обновить индекс пакетов Debian и установить основные пакеты, такие как Node.js, NPM и Git. Введите ‘ Y ‘, чтобы подтвердить установку.

sudo apt update  
sudo apt install nodejs npm git

После завершения установки установите менеджер пакетов Yarn с помощью команды ‘ npm ‘ ниже. В этом примере вы установите Yarn глобально или для всей системы.

npm install --global yarn

Когда закончите, проверьте версию Node.js и Yarn с помощью команды ниже.

node --version  
yarn --version

В выводе ниже вы можете увидеть, что Node.js 18 и Yarn 1.22 установлены.

Скачивание исходного кода Actual Budget

После установки зависимостей вы готовы скачать исходный код Actual, установить зависимости через Yarn, настроить Actual с помощью файла ‘config.json’, а затем запустить Actual через командную строку. Также вам нужен выделенный пользователь для установки и запуска Actual на вашей системе.

Войдите в свою учетную запись с помощью команды ниже.

su - username

Скачайте исходный код Actual Budget с помощью команды ‘ git ‘ ниже.

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

Перейдите в директорию ‘ actual-server ‘ и установите зависимости JavaScript с помощью команды ‘ yarn ‘ ниже.

cd actual-server  
yarn install

Вы можете увидеть ниже установку зависимостей JavaScript через менеджер пакетов Yarn.

После завершения установки создайте новый файл ‘ config.json ‘ с помощью редактора ‘ nano ‘.

nano config.json

Вставьте конфигурацию ниже, чтобы запустить Actual на локальном IP-адресе с портом по умолчанию 5006.

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

Сохраните файл и выйдите из редактора.

Наконец, выполните команду ‘ yarn start ‘ ниже, чтобы запустить программное обеспечение Actual. Это откроет порт 5006 на вашем локальном хосте или адресе ‘ 127.0.0.1 ‘, который будет использоваться приложением.

yarn start

Нажмите Ctrl+c, чтобы завершить процесс.

Запуск Actual в фоновом режиме как службы Systemd

Теперь, когда вы установили и настроили Actual, давайте создадим новый файл службы systemd для запуска Actual в фоновом режиме как службы systemd.

Создайте новый файл службы systemd ‘ /etc/systemd/system/actual.service ‘ с помощью редактора ‘ nano ‘.

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

Вставьте конфигурацию ниже, чтобы запустить Actual в фоновом режиме как службу systemd. Убедитесь, что вы изменили значение по умолчанию ‘ User ‘ и ‘ Group ‘ на ваше имя пользователя, затем измените ‘ WorkingDirectory ‘ на ваш правильный путь.

[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

Сохраните файл и выйдите из редактора, когда закончите.

Теперь выполните команду ‘ systemctl ‘ ниже, чтобы перезагрузить менеджер systemd и применить ваши изменения.

sudo systemctl daemon-reload

Затем запустите и включите ‘ actual.service ‘ с помощью следующей команды. Это запустит ‘ actual.service ‘ в фоновом режиме и позволит ему автоматически запускаться при загрузке системы.

sudo systemctl enable --now actual.service

Проверьте статус ‘ actual.service ‘ с помощью команды ниже. Вы должны увидеть, что ‘ actual.service ‘ работает и включен на вашей системе.

sudo systemctl status actual.service

Настройка Nginx как обратного прокси

На данный момент Actual работает в фоновом режиме как служба systemd. В этом разделе вы установите Nginx и настроите его как обратный прокси для Actual. После этого вы сгенерируете SSL-сертификаты для вашей установки Actual через Certbot и Letsencrypt.

Сначала выполните команду ‘ apt ‘ ниже, чтобы установить Nginx, Certbot и плагин Python3 Certbot Nginx. Введите ‘ Y ‘, чтобы продолжить установку.

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

После завершения установки создайте новый файл блока сервера Nginx ‘ /etc/nginx/sites-available/actual-budget ‘ с помощью редактора ‘ nano ‘.

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

Вставьте конфигурацию ниже и убедитесь, что вы изменили параметр ‘ server_name ‘ на ваше доменное имя.

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;  
}  
}

Когда закончите, сохраните файл и выйдите из редактора.

Теперь выполните команду ниже, чтобы активировать блок сервера ‘ actual-budget ‘ и проверить ваши конфигурации Nginx. Если ошибок нет, вы получите вывод, такой как ‘ синтаксис в порядке - тест успешен ‘.

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

Затем выполните команду ниже, чтобы перезапустить и проверить статус службы Nginx. Убедитесь, что веб-сервер Nginx работает.

sudo systemctl restart nginx  
sudo systemctl status nginx

Наконец, выполните команду ‘ certbot ‘ ниже, чтобы сгенерировать SSL-сертификаты и защитить вашу установку программного обеспечения Actual. Убедитесь, что вы изменили доменное имя и адрес электронной почты в следующей команде.

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

Когда процесс завершится, ваша установка Actual должна быть защищена с помощью HTTPS через Certbot и Letsencrypt. Ваши SSL-сертификаты доступны в директории ‘ /etc/letsencrypt/live/domain.com ‘, и HTTPS автоматически включен в вашем файле блока сервера.

Доступ к Actual Budget через веб-браузер

Посетите доменное имя вашей установки Actual, например https://budget.howtoforge.local. Если все прошло успешно, вы увидите приветственное сообщение от Actual и будете приглашены установить пароль.

Введите ваш новый пароль и повторите его, затем нажмите ‘ OK ‘.

После настройки пароля введите свой пароль, чтобы войти в панель управления Actual.

В первый раз вас попросят просмотреть демонстрационные данные или начать с нуля.

Если вы знакомы с Actual, вы можете нажать ‘ Начать с нуля ‘, но если вы новичок в Actual, нажмите ‘ Просмотреть демонстрацию ‘, чтобы ознакомиться с основными функциями Actual.

Ниже приведен пример демонстрационных данных из системы бюджетирования Actual.

Заключение

Поздравляем! Вы завершили установку Actual, программного обеспечения для управления финансами с акцентом на конфиденциальность, на сервере Debian 12. Вы запустили Actual как службу systemd в фоновом режиме, которая работает на основе обратного прокси Nginx. Более того, вы также защитили Actual с помощью HTTPS через Certbot и Letsencrypt.