---
title: "Как выложить браузерную игру: itch.io, GitHub Pages или свой хостинг — сжатие и кэш"
description: "Куда выложить браузерную 2D-игру и как её подготовить: лимиты itch.io (zip до 1000 файлов и 500 МБ, файл до 200 МБ, путь до 240 символов, регистр в именах) и GitHub Pages (сайт до 1 ГБ, мягкий лимит 100 ГБ трафика в месяц), что делать со сжатием gzip и Brotli и как настроить кэш: index.html без кэша, остальные файлы с отпечатком в имени и на год. Правила — по официальной документации на 09.11.2026, код проверен в Node.js 24."
slug: kak-vylozhit-brauzernuyu-igru-itch-io-github-pages-ili-svoj-hosting
date: 2026-11-10
updated: 2026-11-10
scheduled_at: "2026-11-10T09:00:00+03:00"
rubric: ustrojstvo-2d-igr
tags: ["hosting", "itch-io", "github-pages", "brauzernye-igry", "javascript"]
reading_time: 15
draft: false
summary: "Браузерную игру проще всего выложить на itch.io (zip до 1000 файлов и 500 МБ, своя страница и аудитория) или на GitHub Pages (сайт до 1 ГБ, бесплатно для публичного репозитория), а свой хостинг нужен, когда важны заголовки кэша и сжатие. На обеих площадках текстовые файлы сжимаются автоматически, а настроек кэша в их документации нет: GitHub Pages в нашем замере 09.11.2026 отдавал все файлы с Cache-Control: max-age=600. На своём сервере index.html отдают с no-cache, а остальные файлы — с отпечатком содержимого в имени и max-age=31536000, immutable."
---

## Коротко

Браузерную игру проще всего выложить на 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.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:

```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` совпадут, только если скопировать файл без изменений.

```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']));
```

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

```text
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 не хостит игру за вас. Публично эта функция пока недоступна, заявку можно оставить на [странице раннего доступа](/early-access?utm_source=blog&utm_medium=article&utm_campaign=kak-vylozhit-brauzernuyu-igru-itch-io-github-pages-ili-svoj-hosting) (подача заявки не гарантирует приглашение).

**Источники (проверено: 09.11.2026):** [itch.io — Uploading HTML5 games](https://itch.io/docs/creators/html5) (требования к zip, Common Pitfalls, режимы встраивания, Mobile Friendly, оплата только пожертвованиями, сжатие и типы файлов); [GitHub Docs — GitHub Pages limits](https://docs.github.com/en/pages/getting-started-with-github-pages/github-pages-limits) (1 ГБ, 10 минут, 100 ГБ в месяц, 10 сборок в час, `429`, запрет коммерческого использования); [GitHub Docs — What is GitHub Pages?](https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages) (тарифы, адреса сайтов); [GitHub Docs — Creating a GitHub Pages site](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site) (`.nojekyll`, нет серверных языков, MIME-типы из mime-db); [MDN — Cache-Control](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control) (`immutable`, схема cache busting с `max-age=31536000` и `no-cache` для `index.html`); [MDN — Content-Encoding](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Encoding); [nginx — ngx_http_gzip_static_module](https://nginx.org/en/docs/http/ngx_http_gzip_static_module.html) (модуль не собирается по умолчанию). Заголовки GitHub Pages — наш замер `curl -I` 09.11.2026 около 08:55 МСК (UTC+3); размеры сжатия и вывод кода — наш прогон в Node.js 24.

**Читайте также:**
- [Загрузка ресурсов браузерной игры: экран загрузки, честный прогресс и подгрузка уровней по требованию](/blog/zagruzka-resursov-brauzernoj-igry-ekran-zagruzki-i-progress)
- [Чек-лист проверки браузерной 2D-игры перед показом: 10 пунктов](/blog/chek-list-proverki-brauzernoj-2d-igry-pered-pokazom)
- [Ориентация экрана и полноэкранный режим в браузерной игре: Fullscreen API и Screen Orientation](/blog/orientaciya-ekrana-i-polnoekrannyj-rezhim-v-brauzernoj-igre)
