RU

Игровые серверы

Раздача контента Garry's Mod через FastDL и Nginx

Настройте FastDL для Garry's Mod с Nginx: сжатие bzip2, sv_downloadurl, resource.AddFile, безопасная публикация, проверка, откат и устранение неполадок.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как отправлять игрокам ваш собственный контент через FastDL с отдельного сайта Nginx: подготовка файлов, сжатие, публикация, настройка сервера и откат.

HostMyServers не предлагает управляемый игровой хостинг: вы самостоятельно администрируете этот сервер на вашем VPS или выделенном сервере.

Нужен ли FastDL?

Метод Скорость Когда использовать
Workshop (resource.AddWorkshop) Самая быстрая Любой контент, который можно опубликовать в Workshop, предпочтительный вариант
FastDL (sv_downloadurl) Быстро, файл за файлом Контент, который нельзя опубликовать в Workshop
Загрузка с игрового сервера (sv_allowdownload) Ограничена 64 КБ/с Следует избегать

Файлы .lua это не касается: игра передаёт их другим механизмом.

Принцип работы

  1. Сервер помечает файлы для загрузки с помощью resource.AddFile. Эти файлы должны существовать на игровом сервере
  2. Игрок получает адрес, заданный в sv_downloadurl
  3. Для каждого отсутствующего файла он сначала запрашивает сжатую версию, затем обычную:
Текст
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-fastdl
Nginx
server {
    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 nginx

nginx -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.lua
lua
resource.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 0

sv_allowdownload 0 отключает прямую загрузку с игрового сервера: она медленная и подвержена злоупотреблениям. Перезапустите сервер:

Терминал
sudo systemctl restart gmod.service

Шаг 10: проверка в игре

  1. На сервере отслеживайте запросы:

    Терминал
    sudo tail -f /var/log/nginx/gmod-fastdl.access.log
  2. На вашем компьютере удалите тестовый контент из папки garrysmod/download/, если она существует

  3. Подключитесь к серверу

Запросы ваших файлов .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-fastdl

mkdir: 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?

Нет, но они уменьшают объём передаваемых данных. Скрипт также сохраняет обычную версию, которая используется, если сжатой версии нет.