Серверные скрипты на uCoz

Содержание

• Что такое серверные скрипты и зачем они нужны
• Быстрый старт за 3 минуты
• Где находится раздел «Серверные скрипты»
• PHP — первый запуск
• По какому адресу открывается скрипт
• Базы данных (MySQL)
• FTP-доступ
• Node.js
• Python
• Встроенные функции uCoz
• Запуск по расписанию (Cron)
• Если что-то не работает
• Где смотреть журналы (логи)
• Рекомендации по безопасности
• Краткая памятка

Как включить серверные скрипты, куда загружать файлы и как запускать собственные приложения на PHP, Node.js или Python. Руководство с нуля и простыми объяснениями.

Что такое серверные скрипты и зачем они нужны

Серверные скрипты — это ваш персональный мини-сервер, работающий рядом с сайтом. Если обычный сайт uCoz предназначен для публикации страниц, то серверные скрипты позволяют запускать собственные программы на PHP, Node.js и Python, а также хранить данные в базе данных MySQL.

Эта возможность пригодится для задач, которые невозможно реализовать только средствами конструктора сайта:

• Генерация изображений;
• Telegram-боты;
• Формы с сохранением данных;
• Интеграции с внешними сервисами;
• Автоматизация различных процессов;
• API и веб-приложения.

Быстрый старт за 3 минуты

Если вам нужно быстро запустить PHP-скрипт:

1. Откройте раздел «Серверные скрипты».
2. Перейдите на вкладку PHP и выберите версию PHP.
3. Нажмите «Загрузить файлы» и загрузите скрипт.
4. Откройте его в браузере по адресу: https://<аккаунт>.usites.app/имя-файла.php

Что вы хотите запустить?

Где находится раздел «Серверные скрипты»

В панели управления сайтом откройте раздел «Серверные скрипты».

В этом разделе доступны:

• Панель управления (DirectAdmin);
• Загрузка файлов;
• PHP;
• Node.js;
• Python;
• Базы данных;
• FTP.

PHP — первый запуск

PHP — самый простой способ запустить собственный серверный код.

Шаг 1. Включите PHP

Откройте вкладку PHP и выберите любую версию PHP 8.x.

После сохранения настроек PHP-файлы начнут выполняться автоматически.

Шаг 2. Загрузите файл

Нажмите «Загрузить файлы» и выберите нужный файл.

Все файлы загружаются в каталог: public_html

Это корневая папка вашего мини-сервера.

Шаг 3. Откройте файл в браузере

Перейдите по адресу: https://<аккаунт>.usites.app/имя-файла.php

Скрипт будет выполнен автоматически.

По какому адресу открывается скрипт

Один и тот же файл может быть доступен по двум адресам.

Прямой адрес сервера

Через адрес сайта

Для большинства задач подходит любой из этих вариантов.

Базы данных (MySQL)

Если приложению требуется хранить данные, создайте базу данных MySQL.

На вкладке «Базы данных» создайте:

• Базу данных;
• Пользователя базы данных.

Например:

Указано: shop

Будет создано: <аккаунт>_shop

Это правило действует как для баз данных, так и для пользователей.

FTP-доступ

FTP удобен для загрузки большого количества файлов на сервер.

Вы можете использовать любой FTP-клиент, например:

• FileZilla;
• WinSCP;
• другие совместимые FTP-клиенты.

Во вкладке «FTP для серверных скриптов» можно создать отдельную FTP-учётную запись для работы с файлами серверных приложений.

Node.js

Node.js подходит для создания:

• Telegram-ботов;
• API-сервисов;
• обработчиков данных;
• постоянно работающих приложений;
• веб-приложений и микросервисов.

Шаг 1. Создайте приложение

Откройте вкладку Node.js и нажмите «Создать приложение».

Шаг 2. Загрузите код

Загрузите файлы приложения в каталог: app_node

Шаг 3. Установите зависимости

Если в проекте присутствует файл package.json:

1. Нажмите кнопку «Использовать package.json».
2. Убедитесь, что список зависимостей определён корректно.
3. Нажмите Run NPM Install.
4. Дождитесь завершения установки.
5. Перезапустите приложение.

Шаг 4. Перезапустите приложение

После каждого изменения кода используйте кнопку: Restart

Python

Python чаще всего используется для:

• Telegram-ботов;
• обработки данных;
• AI-инструментов;
• фоновых сервисов;
• автоматизации задач.

Шаг 1. Создайте приложение

Откройте вкладку Python и создайте новое приложение.

Шаг 2. Загрузите код

Загрузите файлы приложения в каталог: app_python

Шаг 3. Установите зависимости

Если проект содержит файл requirements.txt:

1. Нажмите кнопку «Использовать requirements.txt».
2. Проверьте сформированный список зависимостей.
3. Нажмите Run Pip Install.
4. Дождитесь завершения установки.
5. Перезапустите приложение.

Шаг 4. Перезапустите приложение

После каждого изменения кода используйте кнопку: Restart

Встроенные функции uCoz

Серверные скрипты могут получать информацию о текущем пользователе сайта uCoz. Это удобно для личных кабинетов, API, интеграций и сценариев, где нужно определить, от имени какого пользователя выполняется запрос.

PHP

$user = ucoz_user();

$email = ucoz_user('email');

Node.js

const { ucoz_user } = require('ucoz');

const user = ucoz_user(req);

const email = ucoz_user(req, 'email');

Python

from ucoz import ucoz_user

user = ucoz_user(environ)

email = ucoz_user(environ, 'email')

Пример данных пользователя

При успешном получении данных функция возвращает объект пользователя со следующими полями:

{
 "birthday": "",
 "country": 0,
 "email": "jon@ucoz.ru",
 "full_name": "John Doe",
 "gender": 1,
 "gid": 4,
 "id": 1,
 "phone": "",
 "reg_date": 1774007586,
 "user": "tester",
 "verify": 0
}

Получить отдельное значение можно по названию поля:

• email — адрес электронной почты;
• user — логин пользователя;
• full_name — имя пользователя;
• id — идентификатор пользователя;
• gid — группа пользователя;
• phone — номер телефона;
• birthday — дата рождения;
• country — код страны;
• gender — пол пользователя;
• reg_date — дата регистрации в формате Unix Timestamp;

Запуск по расписанию (Cron)

Если скрипт должен запускаться автоматически по времени, используйте Cron.

Типичные сценарии использования:

• Проверка новых записей каждый час;
• Ежедневная отправка отчётов;
• Автоматическая публикация данных по расписанию;
• Регулярный обмен данными с внешними сервисами.

Настройка выполняется через панель DirectAdmin.

Для перехода откройте:

Открыть панель → Доп. возможности → Cron задания

Нажмите «Создать Cron задачу» и заполните параметры расписания:

• Минута — от 0 до 59;
• Час — от 0 до 23;
• День месяца — от 1 до 31;
• Месяц — от 1 до 12;
• День недели — от 0 до 7 (0 и 7 обозначают воскресенье).

В поле «Команда» укажите команду запуска вашего приложения или скрипта.

Примеры команд Cron

php /home/u1111000916/domains/myapp.usites.app/public_html/script.php

curl --silent http://www.myapp.usites.app/cron.php > /dev/null

wget -O /dev/null http://www.myapp.usites.app/cron.php

Символ * означает любое значение, а конструкция */N — выполнение с интервалом в N единиц времени.

Если что-то не работает

Большинство проблем связано с настройками приложения, расположением файлов или ошибками в коде. Начните диагностику со следующей таблицы.

Где смотреть журналы (логи)

Логи помогают определить причину ошибок запуска и установки зависимостей.

Полезная информация:

• Журналы запуска Node.js и Python находятся в каталоге logs.
• Логи установки npm доступны в каталоге .npm.
• Логи установки pip доступны в каталоге .pip.
• Просматривать журналы можно через FTP или DirectAdmin.

Passenger Log

Если приложение Node.js или Python не запускается, первым делом откройте Passenger Log. В большинстве случаев причина ошибки будет указана именно там.

Наиболее распространённые причины:

• Отсутствуют необходимые зависимости;
• Ошибка в коде приложения;
• Неверно указан файл запуска;
• Недостаточно памяти для загрузки тяжёлых библиотек;
• Ошибки конфигурации приложения.

Рекомендации по безопасности

• Не храните пароли и токены в открытом коде.
• Не размещайте конфиденциальные файлы в каталоге public_html.
• Не публикуйте ссылки Cron без дополнительной защиты.
• Регулярно обновляйте зависимости приложений.

Краткая памятка

Вывод:

• Для простых задач используйте PHP.
• Для Telegram-ботов и API подойдут Node.js или Python.
• Для хранения данных используйте MySQL.
• Для автоматического выполнения задач используйте Cron.
• При возникновении ошибок первым делом проверяйте логи.