Коротко
Браузерную игру проще всего выложить на itch.io — там zip до 1000 файлов и 500 МБ, своя страница и аудитория — или на GitHub Pages, где сайт до 1 ГБ бесплатен для публичного репозитория. Свой хостинг нужен, когда важны заголовки кэша и сжатие: в документации площадок таких настроек нет, а GitHub Pages в нашем замере 09.11.2026 отдавал все файлы с Cache-Control: max-age=600. На своём сервере index.html отдают с no-cache, а остальные файлы — с отпечатком содержимого в имени и на год.
Содержание
- Три варианта: сравнение в одной таблице
- itch.io: zip, лимиты и пути
- GitHub Pages: репозиторий, лимиты и кэш на 10 минут
- Свой хостинг: сжатие и заголовки
- Сжатие: что сжимать, а что нет
- Кэш: отпечаток в имени и index.html без кэша
- Код на JavaScript
- Практический сценарий: одна игра на трёх площадках
- Когда вам это не подойдёт
Три варианта: сравнение в одной таблице
Выбор зависит от того, что важнее: аудитория, бесплатная ссылка для портфолио или контроль над сервером. Сводка по официальной документации и нашему замеру, проверено 09.11.2026:
| itch.io | GitHub 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 684 | 1 753 | 1 464 |
| уровень 100×100 в JSON | 21 596 | 4 668 | 4 387 |
| картинка (данные, похожие на PNG) | 20 000 | 20 028 | 20 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 для портфолио и школьный сервер для кружка. Порядок работы:
- Сборка. Скрипт из кода выше переименовывает файлы с отпечатком и переписывает ссылки в
index.html. - Проверка.
itchPreflightпо списку файлов и ссылок из кода игры; ожидаемый результат —[ 'OK' ]. - itch.io. Zip-архив с
index.htmlв корне, тип проекта HTML, режим «Click to launch in fullscreen» и флажок Mobile Friendly, если игра работает на телефоне. - GitHub Pages. Те же файлы плюс файлы прошлой версии и пустой
.nojekyllв корне. Обновление доходит до игроков в течение 10 минут. - Свой сервер. Правила кэша и сжатия из примера nginx. Проверка:
curl -Iнаindex.htmlпоказываетno-cache, наgame.<отпечаток>.js—max-age=31536000, immutable, а с заголовкомAccept-Encoding: gzip—Content-Encoding: gzip. - Финальная проверка. На каждой площадке — пункты 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.
Читайте также: