Как выложить браузерную игру: itch.io, GitHub Pages или свой хостинг — сжатие и кэш

Коротко

Браузерную игру проще всего выложить на itch.io — там zip до 1000 файлов и 500 МБ, своя страница и аудитория — или на GitHub Pages, где сайт до 1 ГБ бесплатен для публичного репозитория. Свой хостинг нужен, когда важны заголовки кэша и сжатие: в документации площадок таких настроек нет, а GitHub Pages в нашем замере 09.11.2026 отдавал все файлы с Cache-Control: max-age=600. На своём сервере index.html отдают с no-cache, а остальные файлы — с отпечатком содержимого в имени и на год.

Содержание

  1. Три варианта: сравнение в одной таблице
  2. itch.io: zip, лимиты и пути
  3. GitHub Pages: репозиторий, лимиты и кэш на 10 минут
  4. Свой хостинг: сжатие и заголовки
  5. Сжатие: что сжимать, а что нет
  6. Кэш: отпечаток в имени и index.html без кэша
  7. Код на JavaScript
  8. Практический сценарий: одна игра на трёх площадках
  9. Когда вам это не подойдёт

Три варианта: сравнение в одной таблице

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

itch.ioGitHub PagesСвой хостинг
Как загрузитьzip-архив с index.html или один .htmlфайлы в репозитории или сборка через GitHub Actionsлюбые файлы на сервер
Размердо 1000 файлов, до 500 МБ после распаковки, файл до 200 МБсайт до 1 ГБ, репозиторий — рекомендовано до 1 ГБсколько оплатите
Трафикв документации HTML5-игр не указанмягкий лимит 100 ГБ в месяцпо тарифу
Сжатие текстаавтоматически gzip; понимает заранее сжатые .gz и .brавтоматически gzip (наш замер)настраиваете сами
Кэшв документации настройки нетmax-age=600 на всё (наш замер), свои заголовки в документации не предусмотренынастраиваете сами
Где идёт играво фрейме на странице игрына своём адресе <имя>.github.ioна вашем домене
Деньгидля HTML5 — только пожертвованияне для коммерческих сайтов и магазиновбез ограничений площадки

itch.io: zip, лимиты и пути

На itch.io игра загружается zip-архивом, в корне которого лежит index.html; простую игру из одного файла можно загрузить как .html без архива. Требования к архиву по документации itch.io (проверено 09.11.2026):

  • не больше 1000 файлов после распаковки;
  • путь к файлу вместе с папками — не длиннее 240 символов;
  • всё содержимое после распаковки — не больше 500 МБ, один файл — не больше 200 МБ;
  • имена в кодировке UTF-8 и с учётом регистра;
  • только zip: .rar, .tar.gz и .7z не поддерживаются.

Три ошибки из раздела «Common Pitfalls» встречаются чаще других. Абсолютные пути: игра лежит в подпапке CDN, поэтому путь /assets/level1.json уводит за её пределы, нужны относительные. Регистр: Windows и macOS находят hero.png по ссылке на Hero.png, а сервер itch.io — нет; ошибка выглядит как net::ERR_ABORTED 403, а не 404. Запросы на другие домены — только по HTTPS.

Ещё две настройки влияют на игрока. Режим «Click to launch in fullscreen» растягивает игру на всю область окна, а с флажком Mobile Friendly на телефоне игра всегда открывается этим способом — раскладка должна выдерживать любой размер. По умолчанию включён «Click to Play»: игра стартует по нажатию. Если его отключить, игра запустится вместе со страницей, и, как предупреждает документация, в некоторых браузерах звук окажется выключен.

GitHub Pages: репозиторий, лимиты и кэш на 10 минут

GitHub Pages публикует статические файлы из репозитория по адресу <имя>.github.io/<репозиторий>. По документации GitHub (проверено 09.11.2026) он доступен для публичных репозиториев на бесплатном тарифе, а для приватных — на платных тарифах Pro, Team и Enterprise. Лимиты:

  • опубликованный сайт — не больше 1 ГБ, репозиторий-источник — рекомендовано до 1 ГБ;
  • публикация прерывается, если идёт дольше 10 минут;
  • мягкий лимит трафика — 100 ГБ в месяц, мягкий лимит сборок — 10 в час (не действует при сборке своим процессом GitHub Actions);
  • при превышении частоты запросов сайт отвечает кодом 429;
  • серверных языков (PHP, Ruby, Python) нет — только статические файлы;
  • Pages не предназначен для коммерческих сайтов, магазинов и SaaS.

Если в игре есть папки или файлы с подчёркиванием в начале имени, положите в корень пустой файл .nojekyll: так документация советует отключить сборку Jekyll для сайтов, собранных другим способом. MIME-типы GitHub Pages берёт из проекта mime-db — более 750 типов, и задать свой тип для файла нельзя.

Настройки кэша в документации GitHub Pages нет. В нашем замере 09.11.2026 страницы pages.github.com и mdn.github.io отдавали HTML, SVG и PNG с заголовком Cache-Control: max-age=600. HTML и SVG приходили сжатыми gzip, даже когда запрос разрешал Brotli, а PNG — без сжатия. Значит, после обновления часть игроков до 10 минут видит старую версию.

Свой хостинг: сжатие и заголовки

Свой сервер нужен, когда хочется управлять кэшем и сжатием файл за файлом или когда игре нужна серверная часть. Минимальная настройка для статической игры — два правила кэша и сжатие текстовых файлов. Пример для nginx:

# index.html браузер каждый раз сверяет с сервером
location = /index.html {
    add_header Cache-Control "no-cache";
}

# файлы с отпечатком в имени не меняются никогда
location ~* \.[0-9a-f]{8}\.(js|json|png|ogg|wasm)$ {
    add_header Cache-Control "public, max-age=31536000, immutable";
}

gzip on;
gzip_types application/javascript application/json application/wasm image/svg+xml;
gzip_static on;   # отдаёт заранее сжатый game.js.gz рядом с game.js

У gzip_static есть оговорка: по документации nginx модуль ngx_http_gzip_static_module не собирается по умолчанию и включается параметром --with-http_gzip_static_module, поэтому проверьте вывод nginx -V. Модуля Brotli в документации nginx.org нет — его подключают отдельным модулем.

Сжатие: что сжимать, а что нет

Сжимать стоит текст — код, JSON уровней, HTML, SVG и WebAssembly, а картинки PNG и JPEG и звук в OGG или MP3 уже сжаты своим форматом. Браузер сообщает, какие методы понимает, а сервер отвечает заголовком Content-Encoding: gzip или br.

Наш прогон в Node.js 24 на учебной сборке:

ФайлИсходно, байтgzip, байтBrotli, байт
код игры3 6841 7531 464
уровень 100×100 в JSON21 5964 6684 387
картинка (данные, похожие на PNG)20 00020 02820 004

Уровень сжался примерно в 4,6 раза, код — в 2,1 раза, а картинка после gzip стала даже на 28 байт больше. Неслучайно в списке автоматического сжатия itch.io — типы вроде html, js, css, svg, wasm, wav, а PNG там нет. В нашем прогоне Brotli сжал текст плотнее gzip; на площадках вы этим не управляете, а на своём сервере — да.

Кэш: отпечаток в имени и index.html без кэша

Надёжная схема кэша — та, что MDN описывает как «cache busting»: у каждого файла, кроме index.html, в имени отпечаток содержимого, например game.1668b330.js. Такие файлы отдают с Cache-Control: max-age=31536000, immutable — на год и без перепроверки, а index.html — с no-cache, чтобы браузер каждый раз сверял его с сервером.

При обновлении меняется содержимое — меняется и отпечаток, index.html ссылается на новые имена, а старые файлы в кэше просто перестают быть нужны. На GitHub Pages и itch.io заголовками вы не управляете, но отпечаток всё равно полезен: игрок не получит новый game.js вперемешку со старым уровнем.

Одна ловушка: на GitHub Pages index.html тоже кэшируется на 600 секунд. Если публикация удаляет файлы прошлой версии, игрок со старым index.html 10 минут получает 404 на старые имена. Оставляйте в сборке файлы предыдущей версии хотя бы на одно обновление.

Код на JavaScript

Код делает три вещи: считает размер файлов после gzip и Brotli, переименовывает файлы с отпечатком и назначает каждому заголовок кэша, а затем проверяет сборку по правилам itch.io. Он запускается в Node.js 24 как модуль .mjs; код игры здесь — сам этот файл, поэтому первая строка вывода и отпечаток game.js совпадут, только если скопировать файл без изменений.

import { createHash } from 'node:crypto';
import { gzipSync, brotliCompressSync, constants } from 'node:zlib';

import { readFileSync } from 'node:fs';

// Учебная сборка: код — этот же файл, уровень 100×100 из 16 видов тайлов, картинка — шум
let seed = 7;
const rand = () => ((seed = (seed * 1103515245 + 12345) % 2147483648) / 2147483648);
const tiles = Array.from({ length: 10000 }, () => (rand() < 0.6 ? 0 : 1 + Math.floor(rand() * 15)));
const level = JSON.stringify({ w: 100, h: 100, tiles });
const code = readFileSync(new URL(import.meta.url), 'utf8');
const png = Buffer.concat(Array.from({ length: 625 }, (_, i) => createHash('sha256').update('px' + i).digest())); // 20 000 байт, сжаты как PNG
const files = {
  'index.html': '<script src="game.js"></script><link href="assets/level1.json">',
  'game.js': code,
  'assets/level1.json': level,
  'assets/Hero.png': png,
};

// 1. Сжатие: сколько байт уйдёт по сети
for (const name of ['game.js', 'assets/level1.json', 'assets/Hero.png']) {
  const raw = Buffer.from(files[name]);
  const gz = gzipSync(raw, { level: 9 }).length;
  const br = brotliCompressSync(raw, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length;
  console.log(name.padEnd(19), raw.length, '→ gzip', gz, '| br', br);
}

// 2. Имена с отпечатком содержимого и правило кэша для каждого файла
const hash = (buf) => createHash('sha256').update(buf).digest('hex').slice(0, 8);
function fingerprint(files) {
  const out = {}; const map = {};
  for (const [name, body] of Object.entries(files)) {
    if (name === 'index.html') continue;
    const dot = name.lastIndexOf('.');
    const hashed = name.slice(0, dot) + '.' + hash(Buffer.from(body)) + name.slice(dot);
    map[name] = hashed; out[hashed] = body;
  }
  let html = files['index.html'];
  for (const [from, to] of Object.entries(map)) html = html.replaceAll('"' + from + '"', '"' + to + '"');
  out['index.html'] = html;
  return out;
}
const cacheHeader = (name) => (name.endsWith('.html') ? 'no-cache' : 'public, max-age=31536000, immutable');
const built = fingerprint(files);
for (const name of Object.keys(built)) console.log(name.padEnd(28), cacheHeader(name));
console.log(built['index.html']);

// 3. Проверка перед загрузкой на itch.io по правилам из документации
function itchPreflight(files, mentions) {
  const names = Object.keys(files);
  const sizes = names.map((n) => Buffer.byteLength(files[n]));
  const problems = [];
  if (!names.includes('index.html')) problems.push('нет index.html');
  if (names.length > 1000) problems.push('больше 1000 файлов');
  for (const n of names) if (n.length > 240) problems.push('путь длиннее 240: ' + n);
  if (sizes.reduce((a, b) => a + b, 0) > 500 * 1024 * 1024) problems.push('больше 500 МБ');
  if (Math.max(...sizes) > 200 * 1024 * 1024) problems.push('файл больше 200 МБ');
  const lower = new Map(names.map((n) => [n.toLowerCase(), n]));
  for (const m of mentions) {
    if (m.startsWith('/')) problems.push('абсолютный путь: ' + m);
    else if (!files[m] && lower.has(m.toLowerCase())) problems.push('регистр: ' + m + ' ≠ ' + lower.get(m.toLowerCase()));
    else if (!files[m]) problems.push('нет файла: ' + m);
  }
  return problems.length ? problems : ['OK'];
}
console.log(itchPreflight(files, ['game.js', '/assets/level1.json', 'assets/hero.png']));
console.log(itchPreflight(files, ['game.js', 'assets/level1.json', 'assets/Hero.png']));

Ожидаемый вывод программы:

game.js             3684 → gzip 1753 | br 1464
assets/level1.json  21596 → gzip 4668 | br 4387
assets/Hero.png     20000 → gzip 20028 | br 20004
game.1668b330.js             public, max-age=31536000, immutable
assets/level1.7f2d696c.json  public, max-age=31536000, immutable
assets/Hero.01c0dc0c.png     public, max-age=31536000, immutable
index.html                   no-cache
<script src="game.1668b330.js"></script><link href="assets/level1.7f2d696c.json">
[
  'абсолютный путь: /assets/level1.json',
  'регистр: assets/hero.png ≠ assets/Hero.png'
]
[ 'OK' ]

Проверка нашла обе ошибки из раздела «Common Pitfalls»: абсолютный путь и несовпадение регистра. На диске Windows или macOS обе прошли бы незаметно.

Практический сценарий: одна игра на трёх площадках

Возьмём аркаду на 8 МБ: страница на itch.io для аудитории, GitHub Pages для портфолио и школьный сервер для кружка. Порядок работы:

  1. Сборка. Скрипт из кода выше переименовывает файлы с отпечатком и переписывает ссылки в index.html.
  2. Проверка. itchPreflight по списку файлов и ссылок из кода игры; ожидаемый результат — [ 'OK' ].
  3. itch.io. Zip-архив с index.html в корне, тип проекта HTML, режим «Click to launch in fullscreen» и флажок Mobile Friendly, если игра работает на телефоне.
  4. GitHub Pages. Те же файлы плюс файлы прошлой версии и пустой .nojekyll в корне. Обновление доходит до игроков в течение 10 минут.
  5. Свой сервер. Правила кэша и сжатия из примера nginx. Проверка: curl -I на index.html показывает no-cache, на game.<отпечаток>.js — max-age=31536000, immutable, а с заголовком Accept-Encoding: gzip — Content-Encoding: gzip.
  6. Финальная проверка. На каждой площадке — пункты 1–3 чек-листа перед показом: чистая загрузка без ошибок, звук, экраны.

Когда вам это не подойдёт

Статический хостинг подходит не всем браузерным играм:

  • Игре нужен сервер. Таблица рекордов без подделки, мультиплеер и аккаунты требуют серверной части; GitHub Pages серверных языков не поддерживает, а itch.io хранит только файлы игры.
  • Игра больше лимитов. Больше 500 МБ или 1000 файлов на itch.io и больше 1 ГБ на GitHub Pages — повод уменьшить ресурсы или выпустить скачиваемую версию.
  • Хотите продавать доступ к HTML5-версии на itch.io. По документации там сейчас только пожертвования.
  • Приватный репозиторий на бесплатном тарифе GitHub. Pages для него недоступен — нужен публичный репозиторий или платный тариф.
  • Коммерческий сайт или магазин. Правила GitHub Pages это запрещают; нужен обычный хостинг.

Мы разрабатываем J2DRU — браузерный 2D игровой движок. Studio умеет собирать готовую игру в zip-архив, а где её разместить, решаете вы сами: J2DRU не хостит игру за вас. Публично эта функция пока недоступна, заявку можно оставить на странице раннего доступа (подача заявки не гарантирует приглашение).

Источники (проверено: 09.11.2026): itch.io — Uploading HTML5 games (требования к zip, Common Pitfalls, режимы встраивания, Mobile Friendly, оплата только пожертвованиями, сжатие и типы файлов); GitHub Docs — GitHub Pages limits (1 ГБ, 10 минут, 100 ГБ в месяц, 10 сборок в час, 429, запрет коммерческого использования); GitHub Docs — What is GitHub Pages? (тарифы, адреса сайтов); GitHub Docs — Creating a GitHub Pages site (.nojekyll, нет серверных языков, MIME-типы из mime-db); MDN — Cache-Control (immutable, схема cache busting с max-age=31536000 и no-cache для index.html); MDN — Content-Encoding; nginx — ngx_http_gzip_static_module (модуль не собирается по умолчанию). Заголовки GitHub Pages — наш замер curl -I 09.11.2026 около 08:55 МСК (UTC+3); размеры сжатия и вывод кода — наш прогон в Node.js 24.

Читайте также:

Частые вопросы

Какие ограничения у HTML5-игры на itch.io?

По документации itch.io на 09.11.2026: игра загружается zip-архивом с index.html, в архиве не больше 1000 файлов, общий размер после распаковки до 500 МБ, один файл до 200 МБ, путь к файлу до 240 символов, имена в UTF-8 и с учётом регистра. Другие архивы (rar, 7z, tar.gz) не поддерживаются.

Можно ли продавать браузерную игру на itch.io?

По документации itch.io HTML5-игры сейчас принимают оплату только как пожертвования. Чтобы продавать доступ, игру выкладывают как скачиваемую.

Почему после обновления игры игроки видят старую версию?

Браузер берёт файлы из кэша, пока не истёк срок из заголовка Cache-Control. На GitHub Pages в нашем замере это 600 секунд, то есть до 10 минут. На своём сервере index.html отдают с no-cache, а остальные файлы получают новое имя при каждом изменении.

Нужно ли самому сжимать файлы игры в gzip или Brotli?

Для itch.io и GitHub Pages — нет: обе площадки сжимают текстовые файлы сами. Заранее сжатые файлы .br itch.io понимает по расширению. На своём сервере сжатие включают в настройках, а картинки PNG и звук в OGG или MP3 не сжимают — они уже сжаты.