Различия

Показаны различия между двумя версиями страницы.

--- vji:bitrix:start [2025/07/22 12:57] – vji
+++ vji:bitrix:start [2025/07/22 14:27] (текущий) – vji
@@ Строка 8: / Строка 8: @@
 ----
->Все последующие шаги описаны для сервера с минимальной настройкой. Примеры команд в уроках даны для суперпользователя root.
+>Все последующие шаги описаны для сервера с минимальной настройкой. Примеры команд в уроках даны для суперпользователя **root**.
 ----
-В Astra Linux применяется система управления программными пакетами apt/apt-get. С ее помощью установите обновления до последней стабильной версии и перезапустите систему.
+В Astra Linux применяется система управления программными пакетами **apt/apt-get**. С ее помощью установите обновления до последней стабильной версии и перезапустите систему.
-Настройка репозиториев
+==== Настройка репозиториев ====
+<code>
 nano /etc/apt/sources.list
+</code>
 Добавьте следующие строки в конец файла:
+<code>
 deb https://dl.astralinux.ru/astra/stable/1.8_x86-64/main-repository/     1.8_x86-64 main contrib non-free
 deb https://dl.astralinux.ru/astra/stable/1.8_x86-64/extended-repository/ 1.8_x86-64 main contrib non-free
-Обновите систему.
+</code>
+==== Обновите систему ====
+<code>
 apt update && apt-get dist-upgrade -y
-Настройка портов
+</code>
+==== Настройка портов ====
 Обязательно откройте порты:
+  * 22 — ssh доступ,
-— ssh доступ,
+  * 80 / 443 — http / https web-сервер.
-/ 443 — http / https web-сервер.
 Остальные порты для ntlm, сервера мгновенных сообщений нужно открыть, если только они используются. Можно выбрать произвольные порты
-/ 8891 — http/https ntlm,
+  * 8890 / 8891 — http/https ntlm,
-/ 8894 — http/https сервер мгновенных сообщений.
+  * 8893 / 8894 — http/https сервер мгновенных сообщений.
-Установка пакетов
+===== Установка пакетов =====
 Ниже приведен список всех пакетов, необходимых для установки коробочной версии Битрикс24. Для 1С-Битрикс: Управление сайтом список аналогичен, за исключением Push-сервера.
-Apache — версия 2.4.57
+  * Apache — версия 2.4.57
+<code>
 apt install apache2 apache2-dev -y
- PHP — версия 8.2
+</code>
+  *  PHP — версия 8.2
+<code>
 apt install php php-cli php-common php-dev php-gd php-imap php-ldap php-mbstring php-mysql php-opcache php-pspell php-xml php-zip php-amqp php-apcu php-pear -y
-Nginx — версия 1.22
+</code>
+  * Nginx — версия 1.22
+<code>
 apt install nginx -y
- MariaDB-сервер — версия 10.11.6
+</code>
+   * MariaDB-сервер — версия 10.11.6
+<code>
 apt -y install mariadb-server mariadb-client
-Node и NPM (Push-сервер) — версия 18.19.0
+</code>
+  * Node и NPM (Push-сервер) — версия 18.19.0
+<code>
 apt install nodejs npm -y
-Redis — 7.0.15
+</code>
+  * Redis — 7.0.15
+<code>
 apt install redis -y
-Конфигурация Nginx
+</code>
-Настройте конфигурацию Nginx:
+===== Конфигурация Nginx =====
-рабочий каталог для сайта — /var/www/html/bx-site,
+===== Настройте конфигурацию Nginx: =====
-пользователь для web-окружения — www-data, группа — www-data.
-Чтобы скачать и распаковать на сервере файлы конфигурации, можно выполнить команды:
-Чтобы скачать и распаковать на сервере файлы конфигурации, можно выполнить команды:
+  * рабочий каталог для сайта — **/var/www/html/bx-site**,
+  * пользователь для web-окружения — **www-data**, группа — **www-data**.
+Чтобы скачать и распаковать на сервере файлы конфигурации, можно выполнить команды:
+<code>
 cd /opt
 wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip
 unzip astra.zip
-Скопируйте файлы конфигурации в папку /etc/nginx/.
+</code>
+Скопируйте файлы конфигурации в папку /etc/nginx/.
+<code>
 rsync -av /opt/astra/nginx/ /etc/nginx/
+</code>
 В сервисе используются имена для проксирования:
-httpd — проксирование запросов на Apache,
+  * httpd — проксирование запросов на Apache,
-push — проксирование запросов на Push-сервер.
+  * push — проксирование запросов на Push-сервер.
 Чтобы заработала конфигурация, пропишите имена в локальных адресах.
+<code>
 echo "127.0.0.1 push httpd" >> /etc/hosts
+</code>
 Если сервисы расположены на другом хосте, укажите правильный IP-адрес.
 По умолчанию в Astra сервер Apache использует 80 порт и поставлен на автозапуск. Поэтому перед запуском сервера Nginx на время выключите Apache (на данный момент он еще не настроен). Остановите Apache.
+<code>
 systemctl stop apache2
-Запустите Nginx.
+</code>
+Запустите Nginx.
+<code>
 systemctl --now enable nginx
-Конфигурация PHP
+</code>
-файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
-После того, как файлы конфигурации загружены на сервер , выполните команды:
+===== Конфигурация PHP =====
+----
+>файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+----
+После того, как файлы конфигурации загружены на сервер , выполните команды:
+<code>
 cd /opt/astra/php.d/
 cat opcache.ini >> /etc/php/8.2/apache2/conf.d/bitrix.ini
@@ Строка 87: / Строка 121: @@
 mkdir /var/log/php
 chown -R www-data:www-data /var/log/php
-Конфигурация Apache
+</code>
-файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
-После того, как файлы конфигурации загружены на сервер , выполните команду:
+===== Конфигурация Apache =====
+----
+>файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+----
+После того, как файлы конфигурации загружены на сервер , выполните команду:
+<code>
 rsync -av /opt/astra/apache2/ /etc/apache2/
+</code>
 В результате будут настроены следующие файлы:
-ports.conf — изменено значение порта Listen на 8090,
+  * ports.conf — изменено значение порта Listen на 8090,
-sites-available/000-default.conf — заданы настройки сайта,
+  * sites-available/000-default.conf — заданы настройки сайта,
-mods-available/php.conf — выполнена конфигурация PHP модуля,
+  * mods-available/php.conf — выполнена конфигурация PHP модуля,
-apache2/apache2.conf - выключен AstraMode.
+  * apache2/apache2.conf - выключен AstraMode.
 Отключите листинг каталогов в Apache:
+<code>
 a2dismod --force autoindex
+</code>
 Включите модуль rewrite:
+<code>
 a2enmod rewrite
+</code>
 Включите PHP модуль:
+<code>
 a2enmod php8.2
+</code>
 Запустите сервис:
+<code>
 systemctl --now enable apache2
-Конфигурация MariaDB
+</code>
-файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+===== Конфигурация MariaDB =====
-После того, как файлы конфигурации загружены на сервер , скопируйте их в папку /etc/mysql/.
+----
-su -
+>файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+----
+После того, как файлы конфигурации загружены на сервер , скопируйте их в папку /etc/mysql/.
+<code>
 rsync -av /opt/astra/mysql/ /etc/mysql/
+</code>
 В результате:
-в файле my.cnf добавлена загрузка настроек из каталога /etc/mysql/my-bx.d/,
+  * в файле my.cnf добавлена загрузка настроек из каталога /etc/mysql/my-bx.d/,
-настройки, указанные выше, прописаны в my-bx.d/zbx-custom.cnf.
+  * настройки, указанные выше, прописаны в my-bx.d/zbx-custom.cnf.
 Запустите сервис:
+<code>
 systemctl --now enable mariadb
 systemctl restart mariadb
-Настройте сервис через mysql_secure_installation.
+</code>
+Настройте сервис через //mysql_secure_installation//.
+<code>
 mysql_secure_installation
 ...
@@ Строка 142: / Строка 194: @@
 Disallow root login remotely? [Y/n] y
  ... Success!
-Конфигурация Redis
+</code>
-файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+===== Конфигурация Redis =====
-После того, как файлы конфигурации загружены на сервер , выполните команду:
+----
+>файлы конфигурации загружены при конфигурации Nginx (wget https://dev.1c-bitrix.ru/docs/chm_files/astra.zip)
+----
+После того, как файлы конфигурации загружены на сервер , выполните команду:
+<code>
 rsync -av /opt/astra/redis/redis.conf /etc/redis/redis.conf
+</code>
 Настройте права доступа:
+<code>
 usermod -g www-data redis
 chown -R redis:www-data /etc/redis /var/log/redis /var/lib/redis
@@ Строка 155: / Строка 214: @@
 echo -e '[Service]\nGroup=www-data' > /etc/systemd/system/redis-server.service.d/custom.conf
 systemctl daemon-reload
+</code>
 Запустите сервис Redis:
+<code>
 systemctl enable redis-server.service
 systemctl restart redis-server.service
-Конфигурация Push-server
+</code>
-Nginx проксирует запрос на Push-сервис выбранного типа. Запросы получения сообщений sub — публичные, проксируются со стандартных портов 80/443. Запросы публикации pub — доступны только с внутреннего адреса сервера.
+===== Конфигурация Push-server =====
-Nodejs-процессы делятся на два типа.
+Nginx проксирует запрос на Push-сервис выбранного типа. Запросы получения сообщений **sub** — публичные, проксируются со стандартных портов 80/443. Запросы публикации **pub** — доступны только с внутреннего адреса сервера.
-Процессы, отвечающие за подключение пользователя к выбранному каналу и получение им сообщений. Слушают порты 8010-8015.
+==== Nodejs-процессы делятся на два типа. ====
-Процессы, отвечающие за отправку сообщения в канал. Слушают порты 9010-9011.
+. Процессы, отвечающие за подключение пользователя к выбранному каналу и получение им сообщений. Слушают порты 8010-8015.
+. Процессы, отвечающие за отправку сообщения в канал. Слушают порты 9010-9011.
 Для запуска Push-сервера необходимы:
-nodejs & npm,
+  * nodejs & npm,
-архив сервиса и его модулей.
+  * Элемент ненумерованного спискаархив сервиса и его модулей.
-Выполните следующие действия:
-Скачайте и установите архив push-server-0.4.0.tgz:
+==== Выполните следующие действия: ====
+  * Скачайте и установите архив **push-server-0.4.0.tgz**:
+<code>
 cd /opt
 wget https://repo.bitrix24.tech/vm/push-server-0.4.0.tgz
 npm install --omit=dev ./push-server-0.4.0.tgz
+</code>
 Установка закончится строкой:
+<code>
 added 1 package in 8s
 packages are looking for funding
   run `npm fund` for details
+</code>
 Для удобства дальнейшей работы выполните команду:
+<code>
 ln -sf /opt/node_modules/push-server/etc/push-server /etc/push-server
-Скопируйте файлы сервиса и основную конфигурацию:
+</code>
+==== Скопируйте файлы сервиса и основную конфигурацию: ====
+<code>
 cd /opt/node_modules/push-server
 cp etc/init.d/push-server-multi /usr/local/bin/push-server-multi
@@ Строка 190: / Строка 264: @@
 cp etc/push-server/push-server.service  /etc/systemd/system/
 ln -sf /opt/node_modules/push-server /opt/push-server
-В конфигурационном файле /etc/sysconfig/push-server-multi исправьте (или добавьте, если их нет) следующие параметры:
+</code>
-SECURITY_KEY — секретный ключ для подписи соединения между клиентом и Push-сервером,
+В конфигурационном файле ///etc/sysconfig/push-server-multi// исправьте (или добавьте, если их нет) следующие параметры:
+  * **SECURITY_KEY** — секретный ключ для подписи соединения между клиентом и Push-сервером,
 Длина ключа не имеет значения. В ключе можно использовать только буквы латинского алфавита и цифры, спецсимволы запрещены. Рекомендуем использовать длинный ключ — простой и короткий небезопасен. Вы можете сгенерировать его в консоли с помощью команды:
+<code>
+cat /dev/urandom |tr -dc A-Za-z0-9 | head -c 128
+</code>
-cat /dev/urandom |tr -dc A-Za-z0-9 | head -c 128
+  * **RUN_DIR** — директория для хранения PID файлов процесса,
+  * **USER/GROUP** — пользователь, под которым будет запущен сервис,
+  * **REDIS_SOCK** — сокет, который использует сервис Redis.
+=== Создайте пользователя: ===
-RUN_DIR — директория для хранения PID файлов процесса,
+<code>
-USER/GROUP — пользователь, под которым будет запущен сервис,
-REDIS_SOCK — сокет, который использует сервис Redis.
-Создайте пользователя:
 useradd -g www-data bitrix
-Создайте каталог логов:
+</code>
+=== Создайте каталог логов: ===
+<code>
 [[ ! -d /var/log/push-server ]] && mkdir /var/log/push-server
 chown bitrix:www-data /var/log/push-server
+</code>
 Каждый nodejs-процесс будет запущен как отдельный процесс. Сгенерируйте конфигурационные файлы:
+<code>
 /usr/local/bin/push-server-multi configs pub
 /usr/local/bin/push-server-multi configs sub
+</code>
 Создайте каталог через tmpfiles.d.
+<code>
 echo 'd /tmp/push-server 0770 bitrix www-data -' > /etc/tmpfiles.d/push-server.conf
 systemd-tmpfiles --remove --create
-Измените пользователя и путь к скрипту запуска в конфигурационном файле сервиса /etc/systemd/system/push-server.service:
+</code>
+Измените пользователя и путь к скрипту запуска в конфигурационном файле сервиса ///etc/systemd/system/push-server.service//:
+<code>
 [Service]
 User=bitrix
@@ Строка 220: / Строка 305: @@
 ExecStop=/usr/local/bin/push-server-multi stop
 ...
+</code>
 Переконфигурируйте:
+<code>
 systemctl daemon-reload
+</code>
 Запустите сервис:
+<code>
 systemctl --now enable push-server
-Конфигурация сайта
+</code>
-Создайте рабочий каталог и загрузите скрипт BitrixSetup:
+===== Конфигурация сайта =====
+==== Создайте рабочий каталог и загрузите скрипт BitrixSetup: ====
+<code>
 mkdir /var/www/html/bx-site
 cd /var/www/html/bx-site
 wget https://www.1c-bitrix.ru/download/scripts/bitrixsetup.php
 chown www-data:www-data /var/www/html/bx-site -R
+</code>
 Аналогичным образом можно скачать нужный дистрибутив и установить его в каталог /var/www/html/bx-site.
-Получите доступ к оболочке БД. Создайте базу данных и пользователя:
+==== Получите доступ к оболочке БД. Создайте базу данных и пользователя: ====
+<code>
 mysql -u root -p
 CREATE DATABASE portal;
@@ Строка 240: / Строка 334: @@
 FLUSH PRIVILEGES;
 exit
-Примечания:
+</code>
-portal можно заменить на имя своей базы данных
+----
-Замените 'PASSWORD' на надежный пароль для пользователя bitrix
+>Примечания:
+>portal можно заменить на имя своей базы данных
+>Замените 'PASSWORD' на надежный пароль для пользователя bitrix
+>Команда FLUSH PRIVILEGES применяет изменения прав
+>Если вам нужно разрешить подключение не только с localhost, замените 'localhost' на '%' (но это менее безопасно)
+----
-Команда FLUSH PRIVILEGES применяет изменения прав
+===== Установка продукта с помощью BitrixSetup =====
-Если вам нужно разрешить подключение не только с localhost, замените 'localhost' на '%' (но это менее безопасно)
+>Загрузка **BitrixSetup** производилось при конфигурировании сайта
-Установка продукта с помощью BitrixSetup
+>**Внимание! Установка и дальнейшая корректная работа продукта возможна только в корневой папке сайта на сервере.**
-Загрузка BitrixSetup производилось при конфигурировании сайта
-Внимание! Установка и дальнейшая корректная работа продукта возможна только в корневой папке сайта на сервере.
+  * Элемент ненумерованного спискаОткройте страницу http://<ваш сайт>/bitrixsetup.php в браузере, заменив строку <ваш сайт> на реальный адрес вашего сайта. В браузере отобразится страница загрузки дистрибутива.
-Откройте страницу http://<ваш сайт>/bitrixsetup.php в браузере, заменив строку <ваш сайт> на реальный адрес вашего сайта. В браузере отобразится страница загрузки дистрибутива.
+{{:vji:bitrix:bitrix.png?400|{{:vji:bitrix:bitrix.png?400|}}}}
-Внимание! Убедитесь, что веб-сервер обладает достаточными правами для создания и записи файлов на хостинге.
+>Внимание! Убедитесь, что веб-сервер обладает достаточными правами для создания и записи файлов на хостинге.
-В поле Выбор дистрибутива выберите нужный дистрибутив и с помощью выпадающего списка укажите редакцию продукта, которую вы хотите установить.
+  * В поле **Выбор дистрибутива** выберите нужный дистрибутив и с помощью выпадающего списка укажите редакцию продукта, которую вы хотите установить.
-Укажите версию продукта, которая вам необходима: демонстрационная или коммерческая.
+  * Укажите версию продукта, которая вам необходима: **демонстрационная или коммерческая**.
-Если вы выбрали коммерческую версию, то введите лицензионный ключ в поле Лицензионный ключ.
+Если вы выбрали коммерческую версию, то введите лицензионный ключ в поле **Лицензионный ключ**.
-Нажмите кнопку Загрузить. Начнется процесс загрузки и распаковки дистрибутива на сайт.
+  * Нажмите кнопку **Загрузить**. Начнется процесс загрузки и распаковки дистрибутива на сайт.
-С помощью скрипта BitrixSetup будет установлено соединение вашего сервера непосредственно с сервером компании «1C-Битрикс». Дистрибутив выбранной редакции продукта будет скопирован в корневую директорию сайта на сервере, автоматически распакован, а затем в браузере откроется окно Мастера установки продукта (например «1C-Битрикс: Управление сайтом» или «Битрикс24 в коробке»).
+  *
+С помощью скрипта **BitrixSetup** будет установлено соединение вашего сервера непосредственно с сервером компании «1C-Битрикс». Дистрибутив выбранной редакции продукта будет скопирован в корневую директорию сайта на сервере, автоматически распакован, а затем в браузере откроется окно **Мастера установки продукта** (например «1C-Битрикс: Управление сайтом» или «Битрикс24 в коробке»).
-С помощью кнопки Назад можно вернуться в раздел Выбор дистрибутива, чтобы изменить значения параметров загрузки (например, редакцию дистрибутива).
+С помощью кнопки **Назад** можно вернуться в раздел **Выбор дистрибутива**, чтобы изменить значения параметров загрузки (например, редакцию дистрибутива).
-Важно! В целях безопасности скрипт bitrixsetup.php из корневого каталога сайта автоматически удаляется после распаковки дистрибутива.
+>**Важно! В целях безопасности скрипт bitrixsetup.php из корневого каталога сайта автоматически удаляется после распаковки дистрибутива.**