Self-hosted house planner: true-scale 2D floor plan, 3D, satellite map overlay, sewer, electrical, water and underfloor heating with calculations, priced bill of materials. React + PHP, no database. By the team behind homedesignsai.pro
Заливка на виртуальный хостинг
English | Русский
Подойдёт любой хостинг с PHP 8.1+ (с curl) и Apache или LiteSpeed с mod_rewrite. Сайт — папка статики плюс api/*.php; план живёт в папке storage/, которую создаёт мастер установки. Про Docker — в install.md.
1. Сборка
npm ci
npm run build
Результат — dist/: index.html, assets/, api/ (PHP), data/ (каталог и страница участка), plans/demo.json (засев), models/, textures/. Пути относительные, сайт работает и в корне домена, и в подпапке.
2. Заливка
Скриптом scripts/deploy.sh
Скопируйте .env.deploy.example в .env.deploy и заполните. По SSH (rsync):
DEPLOY_URL=https://plan.example.com
DEPLOY_METHOD=ssh
[email protected]
DEPLOY_PATH=www/plan.example.com
# DEPLOY_SSH_OPTS="-p 2222 -i ~/.ssh/id_ed25519"
По FTP (нужен lftp):
DEPLOY_METHOD=ftp
FTP_HOST=ftp.example.com
FTP_USER=...
FTP_PASSWORD=...
FTP_PATH=www/plan.example.com
Дальше:
scripts/deploy.sh # сборка, заливка, сверка
scripts/deploy.sh --no-build # залить готовый dist/
Скрипт собирает проект, зеркалит dist/ в корень сайта с удалением лишних файлов и сверяет каждый файл с сервером: по SSH — контрольные суммы, по FTP — размеры. storage/, data/.htaccess и plans/.htaccess на сервере он не трогает никогда. Замок не даёт запустить две заливки одновременно.
Вручную
Залейте содержимое dist/ в корень сайта любым FTP-клиентом. При обновлениях не удаляйте и не перезаписывайте storage/ (если оно внутри корня сайта), data/.htaccess и plans/.htaccess: там хеш пароля и токен куки.
3. Установка
Откройте https://plan.example.com/api/setup.php:
- Выберите место хранилища. Предпочтительно вне корня сайта (
../storage); внутри корня оно закрыто.htaccess. - Задайте пароль не короче 8 символов.
- Готово: мастер пишет
storage/config.php, закрываетdata/иplans/кукой входа и дальше отвечает403.
Чтобы между заливкой и первым заходом мастер не запустил кто-то другой, задайте в панели хостинга переменную окружения HOUSE_SETUP_KEY — мастер спросит этот ключ.
4. HTTPS
Включите сертификат в панели хостинга (Let's Encrypt обычно выдаётся одной кнопкой) и там же переадресацию HTTP → HTTPS. Кука входа получает Secure автоматически при запросе по HTTPS. Без HTTPS пароль идёт открытым текстом — для сайта в интернете этот шаг обязателен.
Что где лежит на сервере
| Путь | Что | При заливке |
|---|---|---|
storage/config.php |
хеш пароля, токен куки, засев, часовой пояс | не трогается |
storage/current.json |
текущий план | не трогается |
storage/versions/, versions.jsonl |
все ревизии и их индекс | не трогается |
storage/snapshots/, snapshots.jsonl |
именованные снимки | не трогается |
storage/site-fixed.json |
необязательные неизменяемые данные участка (граница, привязка, улица, закреплённые зоны) | не трогается |
data/.htaccess, plans/.htaccess |
проверка куки для файлов данных, пишет мастер | не трогается |
data/catalog.json |
каталог цен | заменяется из public/data/ |
data/house.json |
страница «Участок и дом» | заменяется из public/data/ |
data/parcel.geojson |
необязательные смежные участки для карты | заменяется из public/data/, удаляется, если его там нет |
plans/demo.json |
засев пустого хранилища | заменяется |
Свои house.json, catalog.json и parcel.geojson держите локально в public/data/, иначе следующая заливка перезапишет или удалит серверные копии. Если в них личные данные, не добавляйте их в git (например, через .git/info/exclude).
nginx
На nginx .htaccess не работает. Вынесите хранилище за корень сайта и закройте папки с данными сами, пропуская только запросы с кукой входа:
location ^~ /storage/ { deny all; }
location ~ ^/api/_ { deny all; }
location ~ ^/(data|plans)/ {
if ($cookie_hauth != "<токен из storage/config.php>") { return 401; }
}
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php-fpm.sock; }
Обновление
git pull
npm ci
scripts/deploy.sh
План, версии и пароль сохраняются. Если менялся формат плана, новые клиент и сервер вместе поднимают минимальную версию клиента; старые открытые вкладки сами перезагружаются, а не затирают новые поля. Перед обновлением загляните в CHANGELOG.md.
Резервные копии
Всё ценное — папка хранилища. Копируйте её целиком, например:
ssh [email protected] 'tar -C www -czf - storage' > house-backup-$(date +%F).tar.gz
Быстрая копия одного плана — «⋯» → «Экспорт JSON» или scripts/plan-pull.sh. Восстановление — вернуть папку на место или импортировать JSON новой ревизией.
Смена пароля
Удалите config.php в хранилище и снова откройте /api/setup.php. План и история остаются; прежние входы перестают действовать, потому что создаётся новый токен куки.