пошаговое руководство · опыт с серверами не нужен
Если ты когда-нибудь создавал форум на Jcink или Forumotion, ты уже знаешь больше, чем думаешь. Это руководство объяснит остальное — по шагам, простым языком.
Не переживай, если что-то звучит незнакомо — каждый пункт подробно объяснён ниже.
Небольшая программа, которую ты запускаешь на своём компьютере. Она всё делает сама — как мастер установки.
Бесплатный аккаунт на GitHub, где будет храниться код твоего форума. Регистрация займёт две минуты.
Небольшой компьютер в интернете, который круглосуточно обслуживает твой форум. Платишь помесячно у хостинг-провайдера.
Адрес твоего форума — например, myforum.ru. Регистрируется у доменного регистратора и оплачивается ежегодно.
CLI расшифровывается как интерфейс командной строки — программа, которую запускают, вводя короткие команды в окне терминала. Думай о ней как о мастере установки: она задаёт вопросы и выполняет всю техническую работу в фоне. Понимать, что именно происходит, не нужно — просто отвечай на подсказки.
После скачивания открой Терминал (нажми Cmd + Пробел, введи Terminal, нажми Enter). Затем выполни три команды ниже — копируй их по одной, вставляй в Терминал и нажимай Enter после каждой.
cd (с пробелом), затем перетащи скачанный файл прямо в окно Терминала —
путь вставится автоматически. Нажми Enter, после чего повтори команды.
Скачай версию для Windows. При первом запуске Windows может показать синее предупреждение — нажми Подробнее → Выполнить в любом случае. Оно появляется для любой программы без платного сертификата издателя; Cuento CLI — это открытый исходный код, программа безопасна.
Твоему форуму нужен дом в интернете — компьютер, который работает круглосуточно и отдаёт страницы посетителям. VPS (виртуальный выделенный сервер) — это именно он: часть реального сервера, арендуемая помесячно у хостинг-провайдера.
Рекомендуем Hetzner (hetzner.com) — надёжный и доступный, от ~$4 в месяц. Другие хорошие варианты — DigitalOcean и Vultr. У всех трёх понятные панели управления и простой процесс регистрации.
При создании нового сервера (на DigitalOcean он называется «droplet», на Hetzner — «облачный сервер») выбери Ubuntu 22.04 или Debian 12 в качестве операционной системы. Самый дешёвый тариф — 1 CPU и 1 ГБ ОЗУ — полностью хватит для комфортной работы Cuento.
После создания сервера ты увидишь его IP-адрес — строку цифр вроде
12.34.56.78 — и либо получишь, либо сам установишь root-пароль.
Сохрани оба значения — CLI спросит их при установке.
GitHub — это бесплатный сайт, где хранятся и публикуются программные проекты. Аккаунт нужен потому, что Cuento CLI сохранит код твоего форума туда и будет использовать его для автоматической публикации обновлений на твой сервер при выходе новых версий.
Достаточно бесплатного личного аккаунта. Регистрация простая — только email и пароль. Всё дополнительное в процессе онбординга можно пропустить.
CLI использует «токен» — длинный пароль — чтобы действовать от твоего имени на GitHub.
Перейди в Settings → Developer settings → Personal access tokens → Tokens (classic)
и нажми Generate new token (classic). Дай ему любое название, выбери срок действия
и отметь чекбоксы: repo, workflow, admin:public_key.
Нажми Generate token, скопируй длинную строку и сохрани в надёжном месте —
она понадобится при запуске CLI.
Доменное имя — это адрес твоего форума: то, что люди вводят в браузере, чтобы попасть к тебе, например myforum.ru или nasherpg.net. Его регистрируют у регистратора доменных имён и платят небольшую годовую абонентскую плату.
Часто самые низкие цены. Простая и понятная панель управления. Хороший выбор для новичков.
Популярный и надёжный регистратор. Хорошие скидки на первый год и привычный интерфейс.
Продаёт домены по себестоимости без наценки. Добавляет бесплатную защиту и ускорение сайта.
Всё готово. Открой CLI — появится меню. Выбери Добавить новый проект и отвечай на вопросы по одному. Вот что CLI спросит и что нужно вводить:
| Что CLI спрашивает | Что вводить |
|---|---|
| GitHub token | Personal access token, созданный на шаге 3 |
| IP-адрес сервера | IP, записанный от провайдера на шаге 2 (например 12.34.56.78) |
| SSH-пользователь | Обычно root для только что созданного сервера |
| SSH-пароль | Root-пароль от хостинг-провайдера |
| Домен | Твоё доменное имя с шага 4 (например myforum.ru) |
| Пароли базы данных | Придумай надёжные пароли и запиши их в безопасном месте |
Снова открой CLI, выбери свой проект и нажми Добавить пользователя — CLI создаст аккаунт прямо в базе данных и спросит, выдать ли ему права администратора. После этого войди на форум и изучи панель управления — там тебя ждут подфорумы, шаблоны, виджеты шапки и настройки прав доступа.
Когда выходит новая версия Cuento, снова открой CLI, выбери свой проект и нажми Обновить. CLI сверит изменения и установит всё необходимое — никаких ручных действий.
На странице CLI описана каждая команда, а в документации подробно разобраны все возможности панели администратора.
