Налаштування Foundry VTT на вашому сервері Linux Ubuntu/Debian (2025)

Потрібний сервер

Необхідні технічні характеристики до сервера

Мінімальні:

• 1 vCPU
• Місце на диску: 1GB
• 2 GB RAM
• Firewall і налаштування безпеки налаштовані так, що дають змогу гравцям зайти на сервер на необхідний порт.

Рекомендовані:

• 2 vCPU
• Місце на диску: 1GB
• 4 GB RAM
• Firewall і налаштування безпеки налаштовані так, що дають змогу гравцям зайти на сервер на необхідний порт.

Об’єм пам’яті, необхідний серверним процесом, залежить від обсягу даних, включених до ігрової системи та модулів, які активні у вашому світі. Для більших систем або світів, у яких використовуються більш ресурсомісткі модулі, буде потрібно більше оперативної пам’яті.

Початкові приготування

Оновлюємо систему

sudo apt-get update

sudo apt-get upgrade

Встановлюємо Node.js

sudo apt install -y libssl-dev
curl -sL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

Встановлюємо unzip, wget

sudo apt-get install unzip wget

Перевіряємо, чи є в нас працюючий firewall.

sudo ufw status

Якщо статус inactive, добре, пропускаємо. А якщо active, то:

sudo ufw allow 30000

Перезавантажимо систему

reboot

Створюємо користувача, у цьому прикладі я буду використовувати ім’я foundry

adduser foundry

usermod -aG sudo foundry

Тепер потрібно увійти під новим користувачем

su - foundry

Встановлюємо PM2

sudo npm install pm2 -g

Встановлення Foundry

Створюємо теки:

mkdir app

mkdir data

Потім перейдем до теки app

cd app

Увійдіть у ваш обліковий запис на foundryvtt.com, перейдіть у розділ Purchased Licenses:

1. У Operating System оберіть Node.js
2. У Download Version оберіть ту версію, яку потрібна. Якщо ви не розробник модулів, то обирайти найвищу версію у розділі Recommended Version
3. Потім натисніть на кнопку Timed URL. У буфер обміну скопіюєтся посилання.

wget -O foundry.zip 'ПОСИЛАННЯ_З_БУФЕРУ_ОБМІНУ'

Розпакування

unzip foundry.zip

Додання Foundry у PM2

Налаштуємо PM2

pm2 startup

Скопіювати і виконати рядок, який видасть команда вище, має вийти щось на кшталт цього:

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u ubuntu --hp /home/ubuntu

Не копіюйте цей рядок, ваш рядок вам видасть команда вище, це лише приклад

Додамо команду запуску Foundry у PM2

pm2 start "node $HOME/app/main.js --dataPath=$HOME/data" --name foundry

Перевіряємо, чи все працює

ваш_ip:30000

наприклад 127.0.0.1:30000

СЕРВЕР ПРАЦЮЄ, ПОДАЛЬШІ НАЛАШТУВАННЯ ОПЦІОНАЛЬНІ, ЯКЩО Є СВІЙ ДОМЕН

Налаштування NGINX

У свого провайдера ви маєте налаштувати DNS. Пошукайте інформацію у свого провайдера, чи подивіться відео на моєму каналі.

Встановлюємо NGINX та firewall

sudo apt-get install nginx uwf

Налаштуємо Firewall

sudo ufw allow 'Nginx Full'

Опціонально, якщо ще не зробили цього раніше на своєму сервері:

sudo ufw allow OpenSSH

Увімкнемо Firewall

sudo ufw enable

Створюємо конфіґ для домена (змініть foundry.example.com на ваш домен.)

sudo nano /etc/nginx/sites-available/foundry.example.com

Скопіювати і вставити блок нижче (змініть foundry.example.com на ваш домен.)

server {

    # Enter your fully qualified domain name or leave blank
    server_name             foundry.example.com;

    # Listen on port 80 without SSL certificates
    listen                  80;

    # Sets the Max Upload size to 300 MB
    client_max_body_size 300M;

    # Proxy Requests to Foundry VTT
    location / {

        # Set proxy headers
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # These are important to support WebSockets
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";

        # Make sure to set your Foundry VTT port number
        proxy_pass http://localhost:30000;
    }
}

“Увімкніть” конфіґ (змініть foundry.example.com на ваш домен.)

sudo ln -s /etc/nginx/sites-available/foundry.example.com /etc/nginx/sites-enabled/

Додаткове налаштування NGINX, відкриємо файл nginx.conf

sudo nano /etc/nginx/nginx.conf

Знайдемо і розкоментуємо (прибрати ’#’) рядок:

server_names_hash_bucket_size 64;

Валідація налаштувань

sudo nginx -t

Якщо нема ніяких помилок, і все у нас ок, перезавантажимо NGINX

sudo systemctl restart nginx

Налаштування SSL

Встановлюємо certbot

sudo apt install certbot python3-certbot-nginx

Створюємо сертифікати для домена (змініть foundry.example.com на ваш домен.)

sudo certbot --nginx -d foundry.example.com

Перезавантажимо NGINX

sudo systemctl restart nginx

Готово!