Scripts и установка
На этой странице
Выбрать скрипт
В Scripts находятся встроенные приложения и ваши шаблоны установки. Встроенные шаблоны доступны только для чтения; собственные можно создавать и редактировать в этом разделе.
- Откройте Servers → Scripts. Кнопка Code показывает код выбранного скрипта, не запуская его.
- Для нового сервера нажмите Create server у нужного шаблона. Выберите тариф, SSH-ключ и Ubuntu; другие системы доступны только при подключённом совместимом образе.
- В поле Setup scripts найдите и выберите скрипты из библиотеки, затем заполните их настройки. Можно выбрать до 12 разных шагов либо оставить список пустым. Порядок установки виден в списке шагов; его можно изменить перетаскиванием или через меню порядка.
- Создайте сервер и дождитесь установки. Каждый шаг показывает свой статус; команда SSH появится на странице сервера.
При создании сервера используются уже доступные скрипты. Для нового шаблона сначала перейдите в Scripts. Исправление шаблона не меняет ранее созданные серверы: у каждого сохранён свой снимок установки.
Если шаблон изменился после выбора, обновите его настройки перед повторной отправкой формы. Ошибка сохранения или конфликт версий не требуют стирать набранный скрипт.
Скрипты выполняются последовательно. При ошибке дальнейшие шаги останавливаются; уже установленное не удаляется. Выполненные шаги не запускаются повторно, а неизвестный результат требует проверки, не слепого повтора. Вопросы работающего скрипта открывают ту же форму настроек и продолжают тот же процесс.
JWS agent включён по умолчанию: это автономный клиент для Secrets и Mail, его обновления и инструкция для OpenClaw. Если отключить его при создании, эти компоненты не устанавливаются. Статистика сервера продолжает собираться независимо.
Запустить на существующем сервере
- В библиотеке нажмите Code, чтобы проверить скрипт, затем Run on server.
- Выберите сервер и заполните настройки скрипта. Подходят только ваши работающие Ubuntu-серверы с достаточным объёмом RAM. Сервер должен быть готов, без другой незавершённой операции.
- Нажмите Run script: это подтверждение запуска, который изменит программы на выбранном сервере.
- Следите за той же операцией в окне запуска или через Open server. Если скрипт запросит настройки во время работы, заполните форму и нажмите Continue.
При запуске сохраняется снимок версии скрипта и его настроек. Последующее редактирование библиотеки не меняет уже принятую операцию. Если версия успела измениться до отправки, JWS предложит загрузить её заново вместо запуска другого кода.
Если соединение прервалось, используйте Check execution для той же попытки, не создавайте новый запуск. Неизвестный результат требует проверки: частично выполненный скрипт не перезапускается вслепую. Запуск не заменяет удостоверение или исходные настройки созданной VM.
Готовые приложения
OpenClaw устанавливается для пользователя ubuntu. Готовность сервера означает, что программа установлена, а не что провайдер ИИ и каналы уже настроены. После подключения по SSH завершите настройку:
openclaw onboard --install-daemon
Недоступные шаблоны помечаются в каталоге и не могут быть развёрнуты. Minecraft поддерживает подключение из локальной сети хоста. После установки и проверки игрового сервиса отдельный адрес появляется в разделе подключения на странице сервера. Введите этот адрес в Minecraft Java Edition с компьютера в той же локальной сети. SSH-шлюз не является игровым адресом; SSH-туннель для игры не требуется.
Локальный игровой адрес не доступен из интернета. Выделенный публичный IPv4 подключается только по вашему выбору за отдельную плату. Адрес Minecraft показывается только для работающего сервера с проверенным подключением; остановка или удаление сервера отзывает игровой доступ.
Office
Шаблон Office · Horizon, Vertical, Ideas, Vault устанавливает все четыре приложения на Ubuntu с 8 ГБ RAM или больше. В форме укажите отдельные HTTPS-адреса Office и Vault, логин и имя первого администратора. Пароль и GitHub-ключ не нужны: JWS доставляет проверенный частный пакет.
После установки прочитайте по SSH файл ~/JWS-OFFICE-SETUP.txt. В нём указаны путь к закрытому приглашению администратора, команда его обновления и настройка доступа. Откройте приглашение на своём Office и задайте пароль. Повторный запуск шаблона обновляет приложения, сохраняя аккаунты, настройки и данные.
DNS и HTTPS на выбранных адресах настраиваются отдельно; установка не покупает публичный IP и не делает сайт доступным автоматически. Для OpenClaw добавляется инструкция jws-office с адресами этой установки. Она не переносит чужие учётные записи, ключи или подключение к ИИ.
Пример: локальная страница
Создайте собственный шаблон с этим Bash-скриптом. Он запускает простую страницу как сервис Ubuntu. Это учебный пример, не промышленный веб-сервер; страница слушает только локальный адрес VM. Модуль http.server описан в документации Python.
#!/bin/bash
set -euo pipefail
apt-get update
apt-get install -y python3
install -d -m 755 /opt/jws-example/site
cat > /opt/jws-example/site/index.html <<'HTML'
<!doctype html><html lang="ru"><meta charset="utf-8"><title>Мой сервер</title><h1>Приложение работает</h1></html>
HTML
cat > /etc/systemd/system/jws-example.service <<'UNIT'
[Unit]
Description=JWS example local website
After=network.target
[Service]
User=ubuntu
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /opt/jws-example/site
Restart=on-failure
[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now jws-example.service
Скачать site.sh. После создания сервера добавьте -L 8080:127.0.0.1:8080 в команду SSH из его страницы. Замените PORT и HOST данными этой команды:
ssh -L 8080:127.0.0.1:8080 -p PORT ubuntu@HOST
Оставьте SSH открытым и перейдите на http://127.0.0.1:8080 на своём компьютере. Если локальный порт занят, используйте -L 8081:127.0.0.1:8080 и откройте порт 8081. Публичное размещение сайта этим примером не настраивается.
Настройки до установки
Конструктор полей в Scripts использует одну схему для любых приложений. Доступны текст, целое число, выбор и переключатель. До 16 полей; значения проверяются сервером. Пример схемы:
{
"version": 1,
"title": "Настройки примера",
"fields": [
{"id":"name","type":"text","label":"Название приложения","default":"Моё приложение","required":true,"max":64},
{"id":"port","type":"number","label":"Порт","default":8080,"required":true,"min":1024,"max":65535},
{"id":"mode","type":"select","label":"Режим","default":"private","required":true,"options":[{"value":"private","label":"Личный"},{"value":"shared","label":"Совместный"}]},
{"id":"notifications","type":"boolean","label":"Уведомления","default":false}
]
}
Скачать схему. Поле «Режим» в этом примере лишь сохраняет выбранное значение, а не выдаёт доступ другим аккаунтам.
JWS передаёт ответы в JSON-файле. Его путь доступен скрипту через JWS_SETTINGS_FILE. Этот скрипт сохраняет ответы в отдельный файл:
#!/bin/bash
set -euo pipefail
umask 077
python3 - <<'PY'
import json, os
from pathlib import Path
settings = json.loads(Path(os.environ['JWS_SETTINGS_FILE']).read_text())
Path('/home/ubuntu/example-settings.json').write_text(json.dumps(settings, ensure_ascii=False, indent=2))
PY
chown ubuntu:ubuntu /home/ubuntu/example-settings.json
chmod 600 /home/ubuntu/example-settings.json
Скачать settings.sh. Читайте JSON как данные: не используйте source, eval или вставку ответов в текст команды. Поля настроек не предназначены для паролей и API-ключей; для них есть Secrets.
Вопрос во время установки
Если значение становится известно только во время установки, скрипт может вызвать jws-setup. JWS покажет владельцу сервера форму и продолжит тот же скрипт после ответа:
#!/bin/bash
set -euo pipefail
umask 077
cat > /var/lib/jws/example-form.json <<'JSON'
{"version":1,"title":"Настройки во время установки","fields":[{"id":"name","type":"text","label":"Название приложения","default":"Моё приложение","required":true,"max":64}]}
JSON
jws-setup request /var/lib/jws/example-form.json > /var/lib/jws/example-answers.json
python3 - <<'PY'
import json
from pathlib import Path
settings = json.loads(Path('/var/lib/jws/example-answers.json').read_text())
Path('/home/ubuntu/example-settings.json').write_text(json.dumps(settings, ensure_ascii=False, indent=2))
PY
chown ubuntu:ubuntu /home/ubuntu/example-settings.json
chmod 600 /home/ubuntu/example-settings.json
Скачать interactive.sh. jws-setup запрашивает обычные настройки приложения; jws работает с секретами. Это разные инструменты.
Ожидание ответа не расходует лимит активного исполнения скрипта в 15 минут. Допускается до 16 последовательных форм. После сбоя или перезагрузки частично выполненный скрипт не запускается заново автоматически: его состояние нужно проверить, чтобы не повторить действия.
Ограничения
Библиотека личная для аккаунта, не общий магазин. До 50 шаблонов, имя до 64 символов, тело до 24 KiB. Итоговый скрипт вместе с настройками должен помещаться в 32 KiB. Сохранение шаблона не запускает его; периодические задания нужно настраивать отдельно внутри своего сервера.