Раздел: Эксплуатация ShariX Open.
NGINX_ENABLED=0: нет требований к nginx binary, worker account/group или
системному site config, нет вопроса/установки nginx. WhiteNoise остаётся fallback
при DEBUG=False. Deploy собирает единый staticfiles из assets модулей;
runtime startup не делает collectstatic и не меняет source/config permissions.
DEBUG=True не является исправлением production статики.
В conf-real/bin/install.cfg указать реальные значения. Для стандартного TCP BIND
рекомендуется NGINX_UPSTREAM=«auto»; origin вычисляется из конфигурации приложения.
NGINX_ENABLED=1 NGINX_USER="_nginx" NGINX_GROUP="_nginx" NGINX_SERVER_NAMES="service.example.org service.example.net" NGINX_UPSTREAM="auto" NGINX_SITE_CONFIG_PATH="/etc/nginx/sites-enabled.d/opensharix.conf" NGINX_SERVICE_NAME="nginx"
Домен — явный placeholder, не адрес Testopen. Пользователь/группа должны совпадать
с реальными workers пакета ОС. Не создавать фиктивного nginx-пользователя ради
прохождения проверки и не менять global worker policy всех сайтов.
Site path ниже /etc/nginx обязан попадать в настоящий include, показанный
nginx -T. Нельзя предполагать, что выбранный conf.d/sites-enabled уже читается.
Upstream — один HTTP(S) origin, без завершающего /, пути, credentials/query.
Сверить с BIND своей установки, не брать порт другого сервиса по аналогии.
Root bootstrap/activate при nginx=1 до Unix accounts/ownership/ACL предлагает
Установить nginx? [y/N]. y/да разрешает установку; Enter/n/EOF останавливают
проход без package-команд. В non-interactive или без терминала согласия нет:
администратор заранее ставит пакет либо запускает интерактивный root bootstrap.
Существующий nginx не переустанавливается. На ALT/Debian сначала apt-get update,
затем targeted install nginx; есть dnf/yum/zypper. Ошибка остаётся видимой.
Это не полный upgrade ОС. Пакет может создать штатный account и выполнить
post-install действия; helper сам не вызывает start/enable и не настраивает TLS.
При первом включении nginx в уже имеющейся установке нужен разовый repair, поскольку меняется группа существующей статики. Root:
cd /opt/sharix-open-webapp-base && ./bin/install.sh bootstrap --strict --use-current-checkouts --permissions=repair && ./bin/install.sh activate --strict --use-current-checkouts --permissions=check
Если assets ещё не собраны — сначала пройти deploy из основного руководства, затем activate. При отказе пакета/account/nginx -t остановиться и исправить причину, не продолжать следующую фазу. После успешного activate сайт должен быть реально включён в nginx -T, nginx должен быть persistently enabled и active: installer сам выполняет enable при необходимости и start/reload. Синтаксически корректный файл, который не входит в http include, активацию не завершает; новая ссылка при ошибке откатывается. Дополнительный ручной enable/start не является обычным шагом. Новый deploy login нужен для изменённого членства в группе. Затем под deploy:
cd /opt/sharix-open-webapp-base && ./bin/install.sh restart --strict --use-current-checkouts --permissions=check
Этот restart проверит actual backend и локальный HTTP nginx. Он не создаёт системный site config вместо root activate. В сообщении «run root bootstrap» слова описывают роль/фазу: выполнять полный bin/install.sh bootstrap с флагами выше. После разового repair дальнейшие обновления используют check.
conf/nginx/open.conf.example — tracked рекомендованный шаблон;
conf-real/nginx/open.conf — реальная редактируемая конфигурация.
Working/system paths — ссылки на conf-real. Local правки сохраняются, не
затираются новым example; foreign link/неоднозначное владение останавливает
материализацию. Перед reload проверяется nginx -t; неудачная новая ссылка
откатывается. Рендер существующего local файла не повторяется вслепую:
при смене server_name/upstream править фактический файл и проверять diff.
Внутренний vhost слушает HTTP:80, location ^~ /static/ использует
alias /opt/sharix-open-webapp-base/staticfiles/; с завершающим slash.
Остальные запросы проксируются в фактический Gunicorn origin. ^~ не исправляет
права: он запрещает перехват подходящим regex location. Один STATIC_ROOT
сборки не превращается в много nginx alias из-за количества модулей.
Внешний HTTPS proxy должен ходить на внутренний nginx:80, а не обходить его
через порт приложения. Host и корректный X-Forwarded-Proto должны сохраняться;
доверять forwarded headers можно только от доверенного proxy. TLS/firewall и
global nginx policy остаются задачей администратора. Private media публичным
alias не открывается.
Collectstatic делает self-contained файлы (не symlink) с read-доступом runtime/ nginx: каталоги 2750 и файлы 0640. Nginx не получает доступ к secrets или /root. Не применять chmod 777 или рекурсивный доступ nginx ко всему проекту/conf-real.
Подставить фактический домен и origin; пример для localhost:
curl -I -H 'Host: service.example.org' http://127.0.0.1:8000/ curl -I -H 'Host: service.example.org' http://127.0.0.1/ curl -I -H 'Host: service.example.org' \ http://127.0.0.1/static/sharix_admin/css/base.css
Затем проверить внешний HTTPS URL в браузере с DEBUG=False. HTML может дать штатный redirect; CSS должен дать 200 и text/css, не HTML. Картинка гигантского размера или оформленная страница 404 по asset URL не доказывают выдачу файла. 403: путь/traversal/ACL и применимый MAC; 404: collectstatic/alias/include; 502: backend/upstream/listening port и journal. Успешная статика не доказывает запуск приложения.
Auto читает единственное корректное TCP значение BIND из корневой .env без загрузки Django. Конкретный bind IP используется как connect address, wildcard 0.0.0.0/:: переводится в соответствующий loopback; поддерживается IPv6 в скобках. Unix socket, несколько bind или неоднозначный файл требуют явного поддержанного origin. Сохранённый proxy_pass обязан совпадать с разрешённым upstream; при расхождении файл сохраняется и активация останавливается для явного решения.
Примерные SERVER_NAMES/SITE_CONFIG_PATH из install.cfg.example — подсказки при первом добавлении ключей. Уже заданные обычные и export assignments, пустые значения и последняя строка без newline не перекрываются defaults. Имя добавленного ключа выводится в CLI, значение не печатается. Исправление не угадывает старые правильные значения из уже конфликтующих дублей: сравнить private backups и оставить по одному нужному активному назначению. Перезапись всей конфигурации старой копией не является восстановлением трёх nginx-параметров.
Изменение .env применяется после restart приложения. DEBUG=True не исправляет неверный proxy_pass, недоступный порт или отсутствие локального nginx. Если backend даёт 200, а внешний HTTPS даёт 502, проверить отдельно локальный HTTP:80 и затем внешний proxy/error.log. При nginx=0 локальный порт 80 может не слушаться; успешная source-приёмка не означает создание этого listener. Не заменять точную диагностику повторным полным installer.
Порядок сверён с опубликованным ShariX Open root
4e1fe4c: install.sh,
relocate,
nginx lifecycle,
проверка sudo,
сохранение install.cfg
и config 84597d4. Проверены тела функций и порядок вызовов,
а не только help или сообщения коммитов. Обычные команды не меняют release tags.
Код реализован; результат конкретного хоста подтверждают отдельно по runtime,
HTTP/XMPP и пользовательскому сценарию. Наличие source-check или status=review
не является приёмкой произвольной установки или внешнего HTTPS.
Сверено 2026-10-27 по опубликованному ShariX Open root
ec9bf2a
и ShariX Open config
84597d4.
Проверены исполняемые пути install.sh, install_roles.sh, install_permissions.py,
deploy_control.sh, install_nginx.sh и env/state helpers; не только сообщения Git.
Владелец подтвердил успешный запуск ShariX Open после исправлений. Установка nginx
с новым вопросом и повторная независимая проверка Testopen ещё требуют
отдельной host-приёмки. Это не объявление релиза и не подтверждение production.
Редакционный status=review относится к статье, не к наличию реализации.