Версия: 7.0

Astra Linux

к сведению

Инструкция по установке Пассворка на ОС:

Astra Linux SE 1.7
Astra Linux SE 1.8

осторожно

В инструкции используются переключаемые блоки кода для разделения команд согласно версиям операционной системы.

1. Минимальные системные требования

Пассворк не требователен к системным ресурсам, а необходимое количество серверов зависит от числа активных пользователей, объема хранимых данных и требований к отказоустойчивости системы.

Ознакомиться с полными системными требованиями.

к сведению

Если сервер имеет 2-4 ГБ оперативной памяти, рекомендуется включить SWAP файл.

2. Базовые действия перед установкой

Получить права root и обновить локальную базу данных пакетов:

shell

sudo -i 
apt-get update

Установить веб-сервер Apache2 и утилиту передачи данных curl:

shell

apt-get install -y apache2 unzip curl zip jq

3. Установка PHP

3.1 Загрузка архива

Получить PHP-архив в текущую директорию:

SE 1.8
SE 1.7

wget https://repos.passwork.ru/repository/php/builds/83/linux/astra/18/x86_64/php_latest.tar.gz

wget https://repos.passwork.ru/repository/php/builds/83/linux/astra/17/x86_64/php_latest.tar.gz

(Опционально) Проверка подписи архива

SE 1.8
SE 1.7

curl -O https://repos.passwork.ru/repository/php/builds/83/linux/astra/18/x86_64/php_latest.tar.gz
curl -O https://repos.passwork.ru/repository/php/builds/83/linux/astra/18/x86_64/php_latest.tar.gz.sig
curl https://passwork.ru/public-key -o pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature php_latest.tar.gz.sig php_latest.tar.gz 

curl -O https://repos.passwork.ru/repository/php/builds/83/linux/astra/17/x86_64/php_latest.tar.gz
curl -O https://repos.passwork.ru/repository/php/builds/83/linux/astra/17/x86_64/php_latest.tar.gz.sig
curl https://passwork.ru/public-key -o pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature php_latest.tar.gz.sig php_latest.tar.gz 

к сведению

Архив также можно получить вручную:

Создать директорию и разархивируйте содержимое:

shell

mkdir ./php && tar -zxvf ./php_latest.tar.gz -C ./php/

3.2 Установка

Установить все .deb пакеты из архива:

shell

apt install ./php/*.deb -y

Установить утилиту PEAR с помощью go-pear.phar:

shell

php ./php/go-pear.phar

к сведению

Выполнить стандартную (без изменений) установку — Enter

Изменить объём RAM, доступный для выполнения PHP скриптов:

shell

sed -i 's/^memory_limit\s*=.*/memory_limit = 256M/' /etc/php/8.3/fpm/php.ini

warning

Рекомендуется увеличивать параметр memory_limit с 256M до 512M или выше, если в Пассворке планируется большое количество пользователей.

Убедиться, что служба php8.3-fpm запущена:

shell

systemctl status php8.3-fpm

Запустить и активировать автозапуск службы, если она остановлена:

shell

systemctl start php8.3-fpm
systemctl enable php8.3-fpm

3.3 Установка драйвера PHP MongoDB

Установить драйвер PHP MongoDB:

shell

pecl install ./php/mongodb-*.tgz

осторожно

Выполнить стандартную (без изменений) сборку — Enter

Создать файлы конфигурации для загрузки и включения PHP MongoDB:

shell

echo "extension=mongodb.so" | tee /etc/php/8.3/fpm/conf.d/20-mongodb.ini
echo "extension=mongodb.so" | tee /etc/php/8.3/cli/conf.d/20-mongodb.ini

4. Установка базы данных MongoDB

к сведению

Если планируется использование PostgreSQL — пропустить 4-й шаг установки.

Подробнее о поддержке PostgreSQL.

Получить архив MongoDB в текущую директорию:

SE 1.8
SE 1.7

wget https://repos.passwork.ru/repository/mongodb/7/astra/18/x86_64/mongodb_latest.tar.gz

wget https://repos.passwork.ru/repository/mongodb/6/astra/17/x86_64/mongodb_latest.tar.gz

Создать директорию и разархивируйте содержимое:

shell

mkdir ./mongodb && tar -zxvf ./mongodb_latest.tar.gz -C ./mongodb/

Установить MongoDB с помощью dpkg:

shell

dpkg -i ./mongodb/*.deb

Запустить службу mongod.service:

shell

systemctl start mongod.service

Включить автозапуск службы:

shell

systemctl enable mongod.service

5. Получение и настройка Пассворка

Онлайн

Получить скрипт:

wget
curl

wget https://repos.passwork.ru/repository/linux/scripts/passwork.sh

curl -O https://repos.passwork.ru/repository/linux/scripts/passwork.sh

осторожно

Скрипт установки Пассворка не должен располагаться в каталоге вместе с файлами сервера приложений.

Назначить скрипту права на исполнение:

chmod +x passwork.sh

По умолчанию, скрипт passwork.sh выполнит:

Создание скрытого .script_env файла в текущем каталоге;
Создание директории passwork_archive для резервного копирования Пассворка;
Получение последней доступной верси Пассворка, подпись и открытый ключ;
Установку ранее полученного архива в /var/www/

к сведению

Чтобы использовать нестандартный путь установки, отключить проверку сертификата или изменить поведение можно использовать параметрами запуска скрипта.

Запустить скрипт:

sudo ./passwork.sh

При первом запуске скрипт запросит API-ключ и выполнит базовые проверки окружения:

Пример успешного выполнения скрипта:

Офлайн

Получить скрипт на другой машине с доступом в Интернет:

wget
curl
PowerShell

wget https://repos.passwork.ru/repository/linux/scripts/passwork.sh

curl -O https://repos.passwork.ru/repository/linux/scripts/passwork.sh

(New-Object System.Net.WebClient).DownloadFile("https://repos.passwork.ru/repository/linux/scripts/passwork.sh", "$PWD\passwork.sh")

к сведению

Или получить passwork.sh скрипт вручную используя ссылку

осторожно

Скрипт установки Пассворка не должен располагаться в каталоге вместе с файлами сервера приложений.

Назначить скрипту права на исполнение:

chmod +x passwork.sh

Перед запуском passwork.sh необходимо:

Получить 7 версию Пассворка из клиентского портала (Обязательно);
Поместить в директорию запуска или использовать --input аргумент для указания расположение (Обязательно);
Получить подпись архива и публичный ключ Пассворка (необязательно если используется --skip аргумент).

По умолчанию, скрипт passwork.sh выполнит:

Создание директории passwork_archive для резервного копирования Пассворка;
Разархивирование архива с Пассворком;
Установку ранее полученного архива в /var/www/

к сведению

После подготовки запустить passwork.sh скрипт:

sudo ./passwork.sh -offline

Пример успешного выполнения скрипта:

6. Настройка веб-сервера для HTTPS-протокола

к сведению

Для обеспечения корректной работы необходимо использовать HTTPS протокол. Использование HTTP приведёт к ошибкам.

6.1 Генерация самоподписанного SSL-сертификата

Создать новую директорию для хранения закрытого ключа и сертификата:

shell

mkdir /etc/apache2/ssl/

Сгенерировать самоподписанный сертификат X.509 для Apache2 с помощью OpenSSL:

shell

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj '/CN=your.domain.name' -addext 'subjectAltName=DNS:your.domain.name,IP:192.168.0.100' -keyout /etc/apache2/ssl/apache.key -out /etc/apache2/ssl/apache.crt

Common Name (CN) — указать IP-адрес сервера или имя хоста так, чтобы они совпадали с тем, как пользователи открывают сайт (по доменному имени или по IP);
subjectAltName (SAN) — передать -addext 'subjectAltName=DNS:your.domain.name,IP:192.168.0.100', подставив вместо your.domain.name и 192.168.0.100 текущее DNS-имя и IP-адрес сервера;

к сведению

Браузеры и SAN — браузеры при проверке HTTPS в первую очередь используют расширение Subject Alternative Name (SAN), а не только поле CN (Common Name). Чтобы избежать несоответствия имени хоста, задать в SAN и DNS, и IP в соответствии с адресом, который вводят пользователи.

Установить права доступа root пользователю для защиты закрытого ключа и сертификата:

shell

chmod 600 /etc/apache2/ssl/*

6.2 Настройка виртуального хоста для доступа по HTTPS-протоколу

осторожно

Перед настройкой веб-сервера с включённой SSL-терминацией, рекомендуется ознакомиться с особенностями настройки.

Активировать модуль SSL в Apache2, позволяя серверу поддерживать протокол HTTPS:

shell

a2enmod ssl

Включить конфигурационный файл виртуального хоста сайта с настройками для SSL-соединения:

shell

a2ensite default-ssl

Открыть файл конфигурации виртуального хоста для HTTPS-соединения:

shell

nano /etc/apache2/sites-enabled/default-ssl.conf

Внести следующие изменения:

Добавить строку ServerName и изменить www.example.com на IP-адрес или домен сервера (в зависимости от указанного значения в Common Name сертификата):
Раскомментировать строку DocumentRoot и изменить путь на корневой каталог Пассворка (/var/www/public);

shell

ServerAdmin webmaster@localhost
ServerName passwork:443
DocumentRoot /var/www/public

Добавить директиву <Directory> после ServerName:

shell

<Directory /var/www/public>
    Options +FollowSymLinks -Indexes -MultiViews
    AllowOverride FileInfo
    Require all granted
</Directory>

Обновить пути к файлам сертификатов, которые были сгенерированы ранее:

shell

SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key

Изменить обработчик .php-файлов, указав проксирование запросов к сокету php-fpm:

shell

<FilesMatch \.php$>
    SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost/"
</FilesMatch>

После внесения изменений проверить, что файл конфигурации виртуального хоста соответствует примеру:

shell

<VirtualHost *:443>
    ServerName passwork:443
    DocumentRoot /var/www/public

    <Directory /var/www/public>
        Options +FollowSymLinks -Indexes -MultiViews
        AllowOverride FileInfo
        Require all granted
    </Directory>

    SSLEngine on
    SSLCertificateFile /etc/apache2/ssl/apache.crt
    SSLCertificateKeyFile /etc/apache2/ssl/apache.key

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
        
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost/"
    </FilesMatch>
</VirtualHost>

Отключить режим AstraMode в Apache2:

shell

sed -i 's/# AstraMode on/AstraMode off/' /etc/apache2/apache2.conf

Включить модули и перезапустить службы:

shell

a2enmod rewrite proxy_fcgi setenvif
systemctl restart php8.3-fpm
systemctl restart apache2

7. Прохождение чек-листа

При первом подключении к Пассворку потребуется пройти чек-лист, в ходе которого будут проверены:

Необходимые параметры
Подключение к базе данных MongoDB
Выбор режима шифрования данных
Случайно сгенерированный ключ шифрования данных в MongoDB
Лицензионный ключ

После прохождения чек-листа будет предложено создать первого пользователя, для чего потребуется указать логин, пароль и адрес электронной почты для отправки уведомлений.

к сведению

Дополнительные параметры компонентов, настройки безопасности и конфигурации системы Пассворка доступны в разделе расширенных настроек.

Версия для LLM

1. Минимальные системные требования​

2. Базовые действия перед установкой​

3. Установка PHP​

3.1 Загрузка архива​

3.2 Установка​

3.3 Установка драйвера PHP MongoDB​

4. Установка базы данных MongoDB​

5. Получение и настройка Пассворка​

6. Настройка веб-сервера для HTTPS-протокола​

6.1 Генерация самоподписанного SSL-сертификата​

6.2 Настройка виртуального хоста для доступа по HTTPS-протоколу​

7. Прохождение чек-листа​

1. Минимальные системные требования

2. Базовые действия перед установкой

3. Установка PHP

3.1 Загрузка архива

3.2 Установка

3.3 Установка драйвера PHP MongoDB

4. Установка базы данных MongoDB

5. Получение и настройка Пассворка

6. Настройка веб-сервера для HTTPS-протокола

6.1 Генерация самоподписанного SSL-сертификата

6.2 Настройка виртуального хоста для доступа по HTTPS-протоколу

7. Прохождение чек-листа