Раздача контента Garry's Mod через FastDL и Nginx
Настройте FastDL для Garry's Mod с Nginx: сжатие bzip2, sv_downloadurl, resource.AddFile, безопасная публикация, проверка, откат и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как отправлять игрокам ваш собственный контент через FastDL с отдельного сайта Nginx: подготовка файлов, сжатие, публикация, настройка сервера и откат.
HostMyServers не предлагает управляемый игровой хостинг: вы самостоятельно администрируете этот сервер на вашем VPS или выделенном сервере.
Нужен ли FastDL?
| Метод | Скорость | Когда использовать |
|---|---|---|
Workshop (resource.AddWorkshop) |
Самая быстрая | Любой контент, который можно опубликовать в Workshop, предпочтительный вариант |
FastDL (sv_downloadurl) |
Быстро, файл за файлом | Контент, который нельзя опубликовать в Workshop |
Загрузка с игрового сервера (sv_allowdownload) |
Ограничена 64 КБ/с | Следует избегать |
Файлы .lua это не касается: игра передаёт их другим механизмом.
Принцип работы
- Сервер помечает файлы для загрузки с помощью
resource.AddFile. Эти файлы должны существовать на игровом сервере - Игрок получает адрес, заданный в
sv_downloadurl - Для каждого отсутствующего файла он сначала запрашивает сжатую версию, затем обычную:
http://fastdl.ваш-домен.com/materials/my_server/logo.vmt.bz2
http://fastdl.ваш-домен.com/materials/my_server/logo.vmtПоэтому путь на веб-сайте должен совпадать с путём в garrysmod/.
Предварительные требования
- Сервер, установленный по руководству Создание сервера Garry's Mod. Это руководство продолжает его: пользователь
gmod, папка/home/gmod/gmod-serverи сервисgmod.service - SSH-доступ с
sudo - Поддомен, здесь
fastdl.ваш-домен.com, с DNS-записьюA, указывающей на IP-адрес сервера - Свободный TCP-порт 80: если на этом сервере Nginx уже обслуживает другой сайт, это руководство просто добавляет отдельный сайт
Проверьте DNS, прежде чем продолжить:
getent hosts fastdl.ваш-домен.comШаг 1: резервное копирование конфигурации
sudo -u gmod cp -p /home/gmod/gmod-server/garrysmod/cfg/server.cfg /home/gmod/server.cfg.before-fastdl
sudo -u gmod ls -l /home/gmod/server.cfg.before-fastdlШаг 2: установка Nginx и bzip2
sudo apt update
sudo apt install -y nginx bzip2Затем создайте папку сайта. Она принадлежит gmod, который публикует в ней файлы, и остаётся доступной для чтения Nginx, работающему от имени www-data в пакетах Debian и Ubuntu:
sudo install -d -o gmod -g www-data -m 2750 /var/www/gmod-fastdl /var/www/gmod-fastdl/releases
sudo ls -ld /var/www/gmod-fastdl /var/www/gmod-fastdl/releasesОтображаемые права должны быть drwxr-s---, владельцы - gmod и www-data.
Шаг 3: размещение вашего контента
Ваши файлы должны существовать на игровом сервере. Соберите их в один аддон, повторяя структуру папок игры и используя только строчные буквы:
garrysmod/addons/my_content/
├── materials/my_server/logo.vmt
├── materials/my_server/logo.vtf
├── models/my_server/crate.mdl
└── sound/my_server/announcement.mp3Если вы загрузили эти файлы в папку ~/my_content вашей административной учётной записи, скопируйте их так:
sudo mkdir -p /home/gmod/gmod-server/garrysmod/addons/my_content
sudo cp -r ~/my_content/. /home/gmod/gmod-server/garrysmod/addons/my_content/
sudo chown -R gmod:gmod /home/gmod/gmod-server/garrysmod/addons/my_contentШаг 4: создание скрипта публикации
Этот скрипт копирует разрешённые типы файлов, сжимает их и публикует всё в новой версии. Он хранит несколько последних версий, чтобы можно было откатиться.
sudo -u gmod nano /home/gmod/fastdl-sync.sh#!/bin/bash
set -euo pipefail
umask 027
GAME="/home/gmod/gmod-server/garrysmod"
WEB="/var/www/gmod-fastdl"
KEEP=3
# Папки для публикации, каждая устроена как garrysmod/
SOURCES=(
"$GAME/addons/my_content"
"$GAME/gamemodes/darkrp/content"
)
NEW="$WEB/releases/$(date +%Y-%m-%d_%H-%M-%S)"
mkdir "$NEW"
for src in "${SOURCES[@]}"; do
[ -d "$src" ] || continue
cd "$src"
for dir in maps materials models particles resource sound; do
[ -d "$dir" ] || continue
find "$dir" -type f \( \
-iname '*.bsp' -o -iname '*.vmt' -o -iname '*.vtf' -o -iname '*.png' -o -iname '*.jpg' \
-o -iname '*.mdl' -o -iname '*.vvd' -o -iname '*.vtx' -o -iname '*.phy' -o -iname '*.ani' \
-o -iname '*.pcf' -o -iname '*.ttf' -o -iname '*.otf' \
-o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.ogg' \
\) -print0 | while IFS= read -r -d '' file; do
mkdir -p "$NEW/$(dirname "$file")"
cp -- "$file" "$NEW/$file"
bzip2 -9 -k -f -- "$NEW/$file"
done
done
done
count=$(find "$NEW" -type f ! -name '*.bz2' | wc -l)
if [ "$count" -eq 0 ]; then
rm -rf "$NEW"
echo "Нет файлов для публикации: текущая версия сохранена." >&2
exit 1
fi
ln -sfn "$NEW" "$WEB/current"
# Удалить самые старые версии
ls -1dt "$WEB"/releases/* | tail -n +$((KEEP + 1)) | xargs -r rm -rf --
echo "Публикация завершена: $count файлов в $NEW"Сделайте скрипт исполняемым и запустите его:
sudo -u gmod chmod 700 /home/gmod/fastdl-sync.sh
sudo -u gmod /home/gmod/fastdl-sync.shПапка gamemodes/darkrp/content пропускается, если её нет. Она указана, потому что DarkRP помечает часть своих файлов через resource.AddFile: поэтому они тоже должны быть доступны через FastDL. Добавьте в SOURCES любой другой аддон, контент которого помечен.
Шаг 5: настройка Nginx
sudo nano /etc/nginx/sites-available/gmod-fastdlserver {
listen 80;
listen [::]:80;
server_name fastdl.ваш-домен.com;
root /var/www/gmod-fastdl/current;
autoindex off;
gzip off;
types { }
default_type application/octet-stream;
add_header X-Content-Type-Options nosniff always;
access_log /var/log/nginx/gmod-fastdl.access.log;
error_log /var/log/nginx/gmod-fastdl.error.log;
location / {
return 404;
}
location ~ ^/(maps|materials|models|particles|resource|sound)/ {
limit_except GET {
deny all;
}
try_files $uri =404;
}
}Доступны только папки с контентом. Включите сайт, проверьте конфигурацию и перезагрузите Nginx:
sudo ln -s /etc/nginx/sites-available/gmod-fastdl /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t
sudo systemctl reload nginxnginx -t должен сообщить syntax is ok и test is successful.
Шаг 6: открытие порта 80
Используйте брандмауэр, который уже работает на вашем сервере.
С UFW
sudo ufw allow 80/tcp
sudo ufw reloadС iptables
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4С nftables
sudo nft add rule inet filter input tcp dport 80 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confШаг 7: проверка сайта
Проверьте один из ваших файлов, подставив его путь. Первая команда должна ответить 200:
curl -I http://fastdl.ваш-домен.com/materials/my_server/logo.vmt.bz2
curl -fsS http://fastdl.ваш-домен.com/materials/my_server/logo.vmt.bz2 | bunzip2 | sudo -u gmod cmp - /home/gmod/gmod-server/garrysmod/addons/my_content/materials/my_server/logo.vmtКоманда cmp не должна ничего выводить: это значит, что опубликованный файл идентичен оригиналу.
Проверьте также, что остальное недоступно. Эти два запроса должны ответить 404:
curl -I http://fastdl.ваш-домен.com/
curl -I http://fastdl.ваш-домен.com/cfg/server.cfgШаг 8: пометка файлов для загрузки
Создайте серверный файл Lua:
sudo -u gmod mkdir -p /home/gmod/gmod-server/garrysmod/lua/autorun/server
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.luaresource.AddFile( "materials/my_server/logo.vmt" )
resource.AddFile( "models/my_server/crate.mdl" )
resource.AddFile( "sound/my_server/announcement.mp3" )Указывайте путь, начиная с garrysmod/, без addons/my_content/ и без .bz2. resource.AddFile добавляет и связанные файлы: .vtf для .vmt или .vvd, .vtx и .phy для .mdl. Игра ограничивает этот список 8192 файлами.
Шаг 9: включение FastDL на сервере
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/cfg/server.cfgДобавьте эти строки, без / в конце адреса:
sv_downloadurl "http://fastdl.ваш-домен.com"
sv_allowdownload 0sv_allowdownload 0 отключает прямую загрузку с игрового сервера: она медленная и подвержена злоупотреблениям. Перезапустите сервер:
sudo systemctl restart gmod.serviceШаг 10: проверка в игре
-
На сервере отслеживайте запросы:
Терминалsudo tail -f /var/log/nginx/gmod-fastdl.access.log -
На вашем компьютере удалите тестовый контент из папки
garrysmod/download/, если она существует -
Подключитесь к серверу
Запросы ваших файлов .bz2 должны появиться с кодом 200, а контент должен отобразиться в игре. Нажмите Ctrl+C, чтобы выйти из режима отслеживания.
Обновление контента
Игра не сравнивает содержимое файлов: игрок, у которого файл уже есть, не загружает его заново, даже если он изменился. Чтобы распространить новую версию, дайте файлу новое имя и измените fastdl.lua, а также все ссылки на этот файл.
Затем опубликуйте и перезапустите сервер, если fastdl.lua изменился:
sudo -u gmod /home/gmod/fastdl-sync.sh
sudo systemctl restart gmod.serviceОткат
Возврат к предыдущей публикации
sudo -u gmod ls -1t /var/www/gmod-fastdl/releases
sudo -u gmod ln -sfn /var/www/gmod-fastdl/releases/YYYY-MM-DD_HH-MM-SS /var/www/gmod-fastdl/currentИзменение применяется мгновенно, перезапускать Nginx не нужно.
Отключение FastDL
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/server.cfg.before-fastdl /home/gmod/gmod-server/garrysmod/cfg/server.cfg
sudo -u gmod rm -f /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.lua
sudo rm -f /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t && sudo systemctl reload nginx
sudo systemctl start gmod.serviceКопия server.cfg не содержит изменений, сделанных после шага 1: при необходимости перенесите их.
При возникновении проблем
HTTP ERROR 1 (Zero Length File) downloading ... или HTTP ERROR 2 (Connection closed) downloading ...
Эти сообщения появляются в консоли игрока. Проверьте, что sv_downloadurl начинается с http://, что прокси Cloudflare отключён для поддомена и что указанный файл отвечает на curl -I.
В журнале Nginx появляются ошибки 404
Файл не опубликован или его путь отличается. Выведите список неудавшихся запросов:
sudo awk '$9 == 404 {print $7}' /var/log/nginx/gmod-fastdl.access.log | sort | uniq -c | sort -rn | headПроверьте регистр в пути, при необходимости добавьте его папку в SOURCES и снова запустите скрипт. Запросы к / или другим посторонним адресам часто исходят от ботов, и их можно игнорировать.
В журнале Nginx появляются ошибки 403 или Permission denied
Проверьте права на каждом уровне:
sudo namei -l /var/www/gmod-fastdl/current/materialsПапки должны принадлежать группе www-data. Если вы публиковали от имени пользователя, отличного от gmod, исправьте права, затем снова запустите скрипт:
sudo chown -R gmod:www-data /var/www/gmod-fastdlmkdir: cannot create directory ... Permission denied
Скрипт был запущен не от имени gmod, либо папка не была создана на шаге 2. Используйте sudo -u gmod /home/gmod/fastdl-sync.sh.
Нет файлов для публикации
Папка-источник пуста, либо файлы находятся не в materials, models, sound или другой распознаваемой папке. Проверьте структуру из шага 3.
bind() to 0.0.0.0:80 failed (98: Address already in use)
Порт 80 занят другой службой. Определите её командой sudo ss -ltnp | grep ':80 '.
Игроки ничего не загружают
- Проверьте действующее значение командой
rcon sv_downloadurl - Проверьте, что файл помечен в
fastdl.luaи присутствует на игровом сервере: иначе он не добавляется в список - Возможно, игрок ограничил загрузки в настройках. Команда
cl_downloadfilterв его консоли должна иметь значениеall - Возможно, файл уже лежит в его папке
garrysmod/download/
Игроки по-прежнему видят старую версию
Это нормальное поведение игры. Переименуйте файл, как описано в разделе об обновлении.
FAQ
Нужно ли публиковать аддоны из Workshop через FastDL?
Нет. Используйте resource.AddWorkshop, описанный в руководстве по установке сервера.
Можно ли разместить FastDL на другом сервере?
Да. Установите Nginx на этой машине и скопируйте туда содержимое current с помощью rsync или scp. Файлы должны оставаться на игровом сервере, иначе resource.AddFile не добавит их в список.
Обязательны ли файлы .bz2?
Нет, но они уменьшают объём передаваемых данных. Скрипт также сохраняет обычную версию, которая используется, если сжатой версии нет.