User Tools

Site Tools


ru:self_hosted_region

Собственный регион

Запустите свой регион OpenSim, подключённый к сетке Caprica. Подойдёт VPS или домашний сервер со статическим IP — доменное имя не требуется.

Или откройте тикет в поддержку: https://caprica.xyz/support/


Требования

Полный список: REQUIREMENTS.md в репозитории региона.

Программное обеспечение (Linux):

  • mono-complete — запускает OpenSim
  • screen или tmux — держит регион запущенным
  • git — для клонирования репозитория
  • python3 — для веб-инсталлера
  • mysql-server — опционально, только если нужны оффлайн-сообщения

Железо: регион 256×256 требует ~1 vCPU, ~1 ГБ ОЗУ, ~1 ГБ диска.

Сеть:

  • Входящие TCP + UDP на порт региона (нужны оба — UDP это протокол симулятора; правило только для TCP заставит телепорты зависать)
  • Исходящие на g.caprica.xyz:9000 (только HTTPS — публичные сервисы Caprica работают по TLS с ноября 2026) и g.caprica.xyz:8003 (HTTP)

Быстрый старт (рекомендуется)

Склонируйте репозиторий и запустите веб-инсталлер:

git clone https://github.com/capricagrid/capricaregion.git /opt/capricaregion
cd /opt/capricaregion
sudo python3 websetup.py --port 8080

Он выведет одноразовый URL с ключом доступа — откройте его в браузере. Форма покрывает все настройки (имя региона, UUID генерируется автоматически, координаты, размер, порт, внешний IP/hostname, протокол сервисов, хранилище SQLite/MySQL, файрвол). После установки регион запускается автоматически; на странице есть лог, кнопки старт/стоп и заметная кнопка FINISH для закрытия инсталлера.

Предпочитаете консоль? Интерактивный мастер делает то же самое:

cd /opt/capricaregion && ./setup.sh

База данных

  • SQLite (по умолчанию): ноль настройки — файлы *.db создаются внутри bin/. Внимание: оффлайн IM отключается автоматически (в поставляемом SQLite-провайдере нет backend'а OfflineIM).
  • MySQL (опционально): нужен для оффлайн-сообщений. Установите mysql-server, создайте базу и пользователя — OpenSim создаст таблицы при первом запуске. Оба установщика настраивают это за вас.

Первый запуск

При первом старте OpenSim спросит в консоли screen имя эстейта и имя и фамилию вашего аватара (зарегистрированного в Caprica):

screen -r <region-name>    # подключитесь один раз, ответьте на вопросы
# отключиться: Ctrl+A затем D

Дождитесь сообщения Login enabled в консоли/логе.


Ручная настройка

Установщики записывают эти файлы за вас; правьте вручную только при необходимости.

1. Идентичность региона — bin/Regions/Regions.ini: имя региона, UUID (подойдёт любой UUIDv4 — установщики генерируют его сами), Location X,Y (сначала выберите свободные координаты на карте Caprica), SizeX/SizeY (256/512/1024), MaxPrims, InternalPort = порт региона, ExternalHostName = ваш IP или hostname.

2. Порт прослушивания — bin/OpenSim.ini: http_listener_port должен совпадать с InternalPort.

3. Протокол сервисов — константы в bin/OpenSim.ini (уже выставлены установщиками): BaseScheme = “https” для публичных сервисов Caprica (:9000), PrivScheme = “http” для приватных сервисов (:8003). Не меняйте их, если поддержка Caprica не скажет иначе.

4. Хранилище — bin/config-include/GridCommon.ini секция [DatabaseService] (по умолчанию активен SQLite-инклуд; для MySQL раскомментируйте строки StorageProvider/ConnectionString MySQL).


Файрвол

Откройте оба протокола для порта региона:

sudo ufw allow 9000,8003,8002
sudo ufw allow <region_port>/tcp
sudo ufw allow <region_port>/udp

Запуск в сеть

  • Убедитесь, что /etc/hosts отображает ваш внешний IP на localhost (нужно для схемы только с IP): строки 127.0.0.1 localhost и ВАШ_IP localhost
  • Запустите регион: cd bin && screen -S myregion, затем mono OpenSim.exe (установщики делают это автоматически).
  • Добавьте Caprica в список сеток вашего вьюера: инструкция по добавлению сетки
  • Войдите, найдите регион на карте по имени, телепортируйтесь — в обе стороны.

Управление регионом: отключиться от screen — Ctrl+A затем D, подключиться снова — screen -d -r плюс имя региона, логи — bin/OpenSim.log и консоль screen.


Устранение неполадок

  • Телепорт зависает ~30 с и падает — порт региона открыт только для TCP. Откройте и UDP (см. Файрвол). В логе: “Did not find presence before timeout”, нет строки “Adding new child scene presence”.
  • Падение при старте: “Could not find a storage interface in OpenSim.Data.SQLite.dll” — у SQLite нет backend'а OfflineIM; либо отключите OfflineMessageModule в OpenSim.ini [Messaging], либо настройте MySQL.
  • Регион не виден на карте — проверьте доступность ExternalHostName и что TCP-порт открыт.
ru/self_hosted_region.txt · Last modified: 2026/11/07 21:04 (external edit)

Page Tools