Открыть в Telegram

Руководство apiton

Как сделать TON-сайт и разместить его на домене .ton

Обновлено

Открыть в @apitonBotпроверить любой юзернейм, номер или домен в Telegram

TON-сайт — обычный сайт (страницы, стили, картинки), который отдаётся не из интернета, а внутри сети TON: запись site домена .ton указывает на ADNL-сервер, до которого идут по RLDP, или на bag TON Storage. Разместить так можно любой сайт, но не любой после этого работает: посетители приходят через прокси или шлюз, по http:// и часто без доступа к остальному интернету. В руководстве две части: как сделать сайт, который работает как TON-сайт, и три способа поставить его на имя .ton. Правила взяты из того, что apiton держит сам: серверы apiton.ton и сайтов клиентов, шлюз ton.direct и проверку, по которой строится список работающих TON-сайтов.

Как посетители попадают на TON-сайт

Один и тот же сайт открывают по трём видам адресов (подробнее — в руководстве Как открыть TON Site):

  • http://shop.ton/ — с TON-прокси на компьютере или в кошельке с TON-браузером. Прокси находит сервер через DHT и забирает страницу по RLDP.
  • https://shop-dton.magic.org/ — в Telegram: он открывает адреса .ton через шлюз magic.org, на котором работает эталонный rldp-http-proxy от TON.
  • https://shop.ton.direct/ — шлюз apiton за кнопкой «Открыть» в списке работающих TON-сайтов, в любом браузере.

Для браузера это три разных сайта, путь к каждому идёт через программы, которые вы не контролируете, и у каждой свои правила. Страница, которая работает на всех трёх адресах, — это страница, которой всё равно, на каком из них её открыли.

Часть 1. Как сделать сайт, который работает как TON-сайт

Ссылки на свои страницы пишите путями: /about/, about.html, /css/site.css. Они работают на всех адресах выше. Абсолютная ссылка на свой адрес где-нибудь да сломается: https://shop.example.com/about/ уводит посетителя в обычный интернет, а http://shop.ton/about/ открывается только с TON-прокси. ton.direct переделывает ссылки на хосты .ton в свои адреса, но ссылки, которые собирает JavaScript во время работы страницы, не переделывает никто. <base href> не ставьте или делайте относительным.

На другие TON-сайты ссылайтесь как на http://имя.ton/: именно такие ссылки переписывает ton.direct, и именно их apiton учитывает как ссылки между сайтами, когда считает рейтинг работающих TON-сайтов.

Редиректы: в пределах того же хоста

Редирект на другую страницу своего сайта — это нормально, если в Location стоит путь: Location: /en/. Редирект на абсолютный адрес — нет:

  • шлюз Telegram передаёт Location как есть, поэтому Location: http://shop.ton/en/ там не откроется, а https://shop.example.com/en/ уведёт посетителя с TON-сайта;
  • проверка apiton помечает главную, которая отвечает HTTP-редиректом на другой хост, как парковку, а не работающий сайт. Небольшая страница или заглушка, которая уходит из TON через <meta http-equiv="refresh"> или скриптом, — тоже парковка, а у страницы, которая уходит из TON, не бывает скриншота.

Узлы apiton сами превращают редирект на веб-адрес сайта в путь; другой сервер может этого не делать.

Ресурсы с других хостов

Шрифты со шрифтового сервиса, скрипт или стили с CDN, счётчик посещений, карта, встроенное видео, API на другом домене — всё это загрузится, только если у TON-браузера посетителя есть выход в обычный интернет, а кто-то приходит в TON как раз потому, что выхода нет. Держите свои копии шрифтов, скриптов и стилей на своём сайте, и пусть страница читается и без остального. Страница, которая целиком состоит из <iframe> обычного сайта, без интернета показывает пустую рамку; apiton встречал такие TON-сайты.

http://, cookie и заголовки

Внутри TON адрес сайта — http://shop.ton/, и браузер считает его обычным http-сайтом:

  • cookie с флагом Secure и cookie с именами __Secure-… и __Host-… не принимаются;
  • Content-Security-Policy с upgrade-insecure-requests отправляет все картинки и скрипты на https://shop.ton/, которого не существует;
  • CSP или CORS, где назван ваш веб-домен, и сервис-воркеры могут сломать страницу;
  • Strict-Transport-Security там ничего не значит (узлы apiton его убирают).

Через ton.direct сайт вообще не получает cookie: шлюз выбрасывает Set-Cookie и не передаёт сайту cookie посетителя. В Telegram сайт открывается на адресе magic.org. Так что не стройте ничего на cookie: ни входа, ни сессии, ни корзины на сервере.

Только чтение: без форм, которые отправляют данные

Узлы apiton и ton.direct пропускают только GET и HEAD, на всё остальное отвечают 405. Форма, которая отправляет данные, — обратная связь, вход, оформление заказа, комментарий — там не работает. Форма поиска с method="get" — обычный запрос GET с параметрами, она работает. Для связи дайте ссылку на Telegram или адрес почты.

Лёгкие страницы

Каждый файл — отдельный запрос через прокси посетителя или шлюз, по UDP. По замерам apiton в сентябре 2026 года первый запрос к сайту на ADNL-сервере занимал 0,7–1,1 с, следующие — 0,16–0,25 с; сайт в bag TON Storage в первый раз отвечал от 2 до 17 с. Один просмотр страницы сайта на Next.js — разметка, 32 файла и предзагрузка ссылок меню — это 50–100 запросов за 1–2 секунды. Поэтому:

  • меньше файлов: соберите CSS и JavaScript в несколько файлов, мелкие значки рисуйте встроенным SVG;
  • сжатые картинки с width и height;
  • без предзагрузки всех ссылок страницы;
  • сжимайте страницы, стили и скрипты в gzip, если запрос это допускает: узлы apiton передают сжатый ответ как есть, и gzip проходит, переписывают они ссылки или нет;
  • правильный Content-Type у каждого файла: ton.direct пропускает HTML, CSS, JavaScript, JSON, XML, текст, картинки, шрифты, аудио, видео, WebAssembly и PDF, а на всё остальное, включая архивы и application/octet-stream, отвечает 415.

Ограничения, которые встречает страница по пути:

Где Один ответ Время Ещё
ton.direct 10 МБ; HTML и CSS — 2 МБ 30 с до 8 запросов к одному сайту одновременно
узел apiton, «Свой сайт на .ton» 16 МиБ ваш сайт отвечает за 15 с 5 ГБ за 30 дней; остальные лимиты — на странице сервиса
проверка apiton первые 256 КБ главной 15 с (30 с для bag TON Storage) GET /, редиректы в пределах хоста

Статичный сайт — лучший

TON-сайт, который работает везде, — статичный: страницы-файлы, собранные заранее генератором статических сайтов или написанные вручную. Ему не нужны ни cookie, ни формы, он проходит через любой прокси и шлюз и может жить даже в bag TON Storage. Одностраничное приложение (React, Vue и подобные), которое рисует страницу на JavaScript, работает, но с двумя оговорками:

  • обращения к своему API по абсолютному адресу https:// на имени .ton не пройдут: браузер не пускает такие запросы с другого адреса; относительные пути (/api/…) работают;
  • проверка apiton видит пустую оболочку и может судить о сайте только по скриншоту. Страницы, собранные заранее, сразу дают текст и проверке, и скриншоту, и посетителю.

Заголовок, описание, значок и своё содержимое

Проверка apiton запрашивает главную с Host: shop.ton и User-Agent apiton-tonsite-probe/1 (+https://apiton.org) — у работающего сайта раз в 6 часов. Из первых 256 КБ она берёт:

  • <title> — название сайта в списке работающих TON-сайтов и на странице домена;
  • <meta name="description"> — текст карточки сайта;
  • og:image и <link rel="icon"> — картинку карточки, пока нет скриншота.

Так что ставьте заголовок и описание в начало <head> и добавьте значок. В рейтинге списка учитываются аптайм (0,35), ссылки с других работающих TON-сайтов (0,20), скорость (0,15), содержимое (0,10), возраст (0,10) и открытия через шлюз apiton (0,10). Содержимое считается по тому, что видит человек: слова основного текста (не меню и не подвал), ссылки на другие ваши страницы, заголовки <h1>–<h3> и картинки. Текст-заглушка (lorem ipsum, coming soon) и шаблон, слово в слово совпадающий с другими сайтами, оценку снижают.

Когда главная считается «парковкой»

Проверка помечает сайт как парковку, а не работающий сайт, если его главная:

  • отвечает редиректом на другой хост или, будучи небольшой страницей или заглушкой, уходит из TON через refresh или скриптом (см. выше);
  • это страница продажи домена или страница кошелька Transfer to имя.ton;
  • это проверка на робота — Just a moment…, Checking your browser, проверка Cloudflare;
  • в заголовке только имя домена, а сама страница меньше 4 КБ и текста в ней меньше 80 символов, или в заголовке заглушка вроде Coming soon, Under construction, Welcome to nginx! или It works! на небольшой странице;
  • совпадает со страницей, которую отдают 20 и больше доменов.

Страница ошибки, отданная со статусом 200 (заголовок вроде 404 - Page Not Found), считается ошибкой, а не работающим сайтом. Так что дайте главной настоящий собственный текст и уберите с неё проверки на робота.

В Telegram

Telegram открывает адреса .ton через шлюз magic.org, поэтому сайту, который должен открываться из чата, нужны:

  • относительные ссылки и редиректы (см. выше);
  • сервер, который говорит на RLDP2: с июня 2026 года эталонный rldp-http-proxy не отправляет запрос серверу, который не сообщил, что поддерживает RLDP2 (серверы apiton поддерживают его со 2 ноября 2026 года);
  • ответы либо с Content-Length, либо с Transfer-Encoding: chunked, но не с обоими сразу: такой ответ этот прокси отвергает;
  • сервер, который держит ADNL-соединение шлюза открытым: шлюз возвращается к нему через минуты и часы, и если сервер его уже закрыл, первое открытие не удаётся, а после перезагрузки страница открывается. Серверы apiton держат такие соединения 24 часа с 15 ноября 2026 года.

Мини-приложение Telegram, открытое как TON-сайт, ничего не рисует: оно ждёт данных запуска, которые даёт только Telegram.

Проверьте себя

  • ссылки и редиректы на свои страницы — пути;
  • шрифты, скрипты и стили — ваши собственные файлы, и страница читается без обычного интернета;
  • нет форм, которые отправляют данные, нет входа, ничего не требует cookie;
  • в CSP нет upgrade-insecure-requests;
  • у главной есть <title>, описание, значок и свой текст;
  • на главной нет проверки на робота, баннера о продаже или заголовка-заглушки;
  • HTML и CSS меньше 2 МБ, каждый файл меньше 10 МБ, на страницу — не больше нескольких десятков запросов.

Часть 2. Как разместить сайт в TON

Каким бы способом вы ни пошли, запись site домена в итоге указывает на ADNL id — адрес сервера, который отвечает за имя, — или на bag TON Storage. Владелец меняет запись одной транзакцией с кошелька, на котором лежит домен; около 0,05 💎 из неё остаются на домене и продлевают его на год.

1. Свой узел

Вы запускаете обратный прокси, который говорит на ADNL и RLDP через публичный UDP-порт и передаёт каждый запрос вашему веб-серверу обычным HTTP. Такой режим есть у эталонного rldp-http-proxy от TON на C++, на Go есть Tonutils Reverse Proxy; собственный сервер apiton для apiton.ton написан на Go по тому же образцу. Чему научила работа apiton.ton с 7 октября 2026 года:

  • Публичный IP-адрес и открытый UDP-порт. Узел публикует свой адрес в DHT, поэтому это должен быть адрес, который видит весь мир, а не догадка.
  • Ключ — это и есть сайт. ADNL id в записи site выводится из закрытого ключа узла. Храните копию: потерянный ключ — это новый id и новая транзакция.
  • Узел должен работать постоянно. Узел, который лежит дольше, чем живёт его запись в DHT, для всех клиентов выглядит как «нет в DHT», хотя запись домена верна.
  • Заголовок Host. Запросы приходят с Host: shop.ton. Веб-сервер должен отвечать на это имя, или прокси должен подставлять ваше веб-имя. Один ADNL id может обслуживать много доменов, их различают по Host.
  • Без петли на https. Если веб-сервер отправляет каждый http-запрос на свой https-адрес, направьте прокси на https-порт: иначе каждая страница окажется редиректом на саму себя (сервер apiton отвечает на такую петлю ошибкой 502).
  • Telegram требует RLDP2 и всего, что перечислено выше.

Затем укажите в записи site домена ADNL id узла, например на dns.ton.org.

Плюсы: свой сервер, свои заголовки и лимиты, никого посередине, никаких платежей, кроме сервера и записи. Минусы: UDP-сервис нужно запускать, обновлять и наблюдать за ним; когда он останавливается, сайт пропадает для всех.

2. apiton отдаёт ваш существующий сайт на вашем домене .ton

Есть обычный сайт на https и домен .ton. На странице Свой сайт на .ton вы подключаете кошелёк, на котором лежит домен, указываете сайт и платите с этого кошелька: одна транзакция оплачивает заказ и ставит запись site домена на узел apiton для клиентов, который дальше берёт каждую страницу с вашего сайта. Цена — 1 GRAM (1 💎) за 30 дней, до 12 периодов одним платежом; перевести заказ на другой сайт потом стоит 0,15 💎. Шаги, проверка сайта и что делать, если сайт за Cloudflare, — в руководстве Как разместить свой сайт на домене .ton.

Плюсы: не нужен сервер в TON; сайт остаётся в обычном интернете, где его индексируют поисковики; apiton проверяет его каждый день и, если вы следите за заказом в @apitonBot, сообщит о неудачной проверке; когда сайт заработает, он появится в списке работающих TON-сайтов и откроется на ton.direct. Скрипты хранятся на узле 10 минут, так что просмотр страницы не забирает их каждый раз с вашего сайта, — но и изменённый скрипт может дойти до посетителей только через 10 минут: добавляйте хэш в имя файла.

Минусы:

  • только GET и HEAD, лимиты — в таблице выше;
  • узел apiton не переписывает страницы: абсолютная ссылка на ваш сайт ведёт в обычный интернет;
  • один домен второго уровня (shop.ton), без поддоменов; доступность не гарантируется;
  • никаких наркотиков, оружия, азартных игр, контента для взрослых, мошенничества, фишинга и всего остального, что запрещают условия.

3. Имя на apiton.ton

Нет домена .ton? Пока на странице сервиса указана цена такого имени, возьмите имя вроде shop.apiton.ton за 0,3 💎 за 30 дней. Ни NFT, ни записи не нужно: каждое имя на apiton.ton уже указывает на узел apiton для клиентов. Платить может любой кошелёк, и первый платёж закрепляет имя за вашим заказом, пока он оплачен. Имя — одна метка из 4–63 символов (a–z, 0–9 и -, но не первым и не последним); имена, которые apiton оставляет за собой, — www, api, wallet и подобные — не принимаются. Сайт проверяется и отдаётся так же, как во втором способе.

Плюсы: самый дешёвый старт, покупать домен не нужно. Минусы: пока такое имя открывается только через TON-прокси или TON-браузер — не на ton.direct — и не попадает в список работающих TON-сайтов; всё остальное — как во втором способе.

TON Storage

Запись site может указывать и на bag TON Storage: это сами файлы сайта, которые раздают узлы, держащие этот bag, без отдельного сервера. Проверка apiton и ton.direct такие сайты открывают, но bag, который никто не раздаёт, не откроется вовсе, а «холодный» bag в первый раз отвечал 17 секунд. Это подходит только полностью статичному сайту; apiton не размещает bag, и как его собрать, здесь не описано.

Какой способ выбрать

Свой узел Ваш сайт через apiton Имя на apiton.ton
Что нужно сервер с UDP, домен .ton сайт на https, домен .ton сайт на https
Цена сервер, около 0,05 💎 за запись 1 💎 за 30 дней, около 0,05 💎 за запись 0,3 💎 за 30 дней
Запросы то, что пропускает ваша программа GET, HEAD GET, HEAD
ton.direct и список работающих TON-сайтов да, когда сайт заработает да, когда сайт заработает пока нет

Когда сайт заработал

  • Каталог apiton прочитает новую запись site через некоторое время после транзакции; затем проверка откроет сайт, и работающий сайт появится в списках работающих TON-сайтов и новых TON-сайтов с кнопкой «Открыть», которая ведёт на ton.direct.
  • На странице домена видна последняя проверка — статус, заголовок, аптайм и время ответа; например, у foundation.ton. Проверить домен в Telegram можно, отправив его имя боту @apitonBot.
  • Поисковики не индексируют TON-сайты через ton.direct: он отвечает на robots.txt строкой Disallow: / и помечает каждую страницу noindex. Если нужен поисковый трафик, держите версию сайта в обычном интернете — второй способ делает это сам.
  • TON-сайты о наркотиках, оружии, азартных играх, порнографии, мошенничестве и другом незаконном содержимом перечислены только по имени в списке ограниченных TON-сайтов и не открываются никогда.
Попробовать в @apitonBotбесплатно: поиск, отслеживание и уведомления в Telegram

Подробнее в блоге (на английском)

Другие руководства

Каталог apiton

Поиск

Открыть в @apitonBot