Руководство apiton
Как сделать TON-сайт и разместить его на домене .ton
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-сайтов и не открываются никогда.