Перейти к основному содержимому
Passwork LogoPasswork LogoТехническая документация
Поиск
7.0arrow
Поиск
Это документация для Пассворка версии 6.0, которая больше не поддерживается.

Актуальная документация находится на странице последней версии 7.0.
Версия: 6.0

Astra Linux

к сведению

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

  • Astra Linux SE 1.7
  • Astra Linux SE 1.8

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

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

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

к сведению

Если сервер имеет 2-4 ГБ ОЗУ, то для корректной сборки всех библиотек мы рекомендуем включить SWAP-файл

Создание SWAP файла на Linux

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

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

sudo -i 
apt-get update

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

apt-get install -y git apache2 unzip curl

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

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

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

wget https://repos.passwork.ru/repository/php/builds/82/linux/astra/17/x86_64/php_latest.tar.gz
(Опционально) Проверка подписи архива
curl -O https://repos.passwork.ru/repository/php/builds/82/linux/astra/17/x86_64/php_latest.tar.gz
curl -O https://repos.passwork.ru/repository/php/builds/82/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
к сведению

Вы также можете скачать архив вручную:

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

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

3.2 Установка​

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

apt install ./php/*.deb -y

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

php ./php/go-pear.phar
к сведению

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

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

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

pecl install ./php/mongodb-*.tgz

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

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

3.4 Установка расширения PHP Phalcon​

Установить PHP Phalcon расширение:

pecl install ./php/phalcon-*.tgz

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

echo "extension=phalcon.so" | tee /etc/php/8.2/apache2/conf.d/30-phalcon.ini
echo "extension=phalcon.so" | tee /etc/php/8.2/cli/conf.d/30-phalcon.ini

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

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

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

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

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

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

dpkg -i ./mongodb/*.deb

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

systemctl start mongod.service

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

systemctl enable mongod.service

5. Управление и загрузка последней версии Пассворк с помощью Git​

Перейти в директорию /var/www/:

cd /var/www/

Добавить глобальную конфигурацию Git, указывающую на безопасную директорию:

git config --global --add safe.directory /var/www

Инициализировать Git репозиторий в директории /var/www/:

git init

Добавить удалённый репозиторий Пассворка:

git remote add origin https://passwork.download/passwork/passwork.git

Получить удалённый репозиторий на локальный сервер:

git fetch
к сведению

Система запросит логин и пароль к репозиторию, которые находятся в клиентском портале Пассворка. Если у вас нет доступа к клиентскому порталу, свяжитесь с нами.

Переключиться на ветку v6 с последней актуальной версией Пассворка:

git checkout v6

Назначить права на директории, файлы и сделать www-data владельцем всех файлов:

find /var/www/ -type d -exec chmod 755 {} \;
find /var/www/ -type f -exec chmod 644 {} \;
chown -R www-data:www-data /var/www/

6. Настройка Apache2 для доступа по HTTP протоколу​

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

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

Отредактировать содержимое файла и приведите его к следующему виду:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/public
    <Directory /var/www/public>
        Options +FollowSymLinks -Indexes -MultiViews
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

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

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

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

a2enmod rewrite
service apache2 restart
к сведению

Открыть http://passwork.local или http://127.0.0.1 для проверки подключения к Пассворк

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

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

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

Если вы устанавливаете новую копию Пассворка, оставьте все поля по умолчанию

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

осторожно

Первый пользователь по умолчанию является локальным и владельцем Пассворка. В случае назначения владельцем LDAP/SSO пользователя, он автоматически станет локальным и вы не сможете авторизоваться.

8. Настройка доступа по HTTPS протоколу​

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

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

mkdir /etc/apache2/ssl/

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

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 пользователю для защиты закрытого ключа и сертификата:

chmod 600 /etc/apache2/ssl/*

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

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

a2enmod ssl

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

a2ensite default-ssl

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

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

Найти раздел, начинающийся с <VirtualHost _default_:443> и внести следующие изменения:

  • Добавить директиву ServerName (имя сервера или IP-адрес) и порт 443 под строкой ServerAdmin:
ServerAdmin webmaster@localhost
ServerName passwork.local:443
  • Добавить директиву <Directory> после ServerName:
<Directory /var/www/public>
    Options +FollowSymLinks -Indexes -MultiViews
    AllowOverride All
    Require all granted
</Directory>
  • Найти следующие изменения и обновите пути к файлам, которые были сгенерированы ранее или указать своё расположение до сертификата и ключа:
SSLCertificateFile /etc/apache2/ssl/apache.crt
SSLCertificateKeyFile /etc/apache2/ssl/apache.key
  • После внесения изменений проверить, что файл конфигурации виртуального хоста соответствует примеру:
<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerAdmin webmaster@localhost
        ServerName passwork.local:443
        DocumentRoot /var/www/public
        <Directory /var/www/public>
            Options +FollowSymLinks -Indexes -MultiViews
            AllowOverride All
            Require all granted
        </Directory>
        SSLEngine on
        SSLCertificateFile /etc/apache2/ssl/apache.crt
        SSLCertificateKeyFile /etc/apache2/ssl/apache.key
    </VirtualHost>
</IfModule>

Перезапустить службу Apache2 чтобы применить внесённые изменения в конфигурацию:

systemctl restart apache2
к сведению

Проверьте подключение к Пассворк по протоколу HTTPS на https://passwork.local

8.3 Настройка Пассворка для работы по HTTPS-протоколу​

При использовании защищенного SSL-соединения (HTTPS) клиентские браузеры требуют определенных флагов для обработки данных Пассворка.

Если флаги session.cookie_secure и disableSameSiteCookie не установлены, браузеры не смогут установить соединение, что может приведет к ошибкам авторизации.

Установить параметр session.cookie_secure в файле /etc/php/8.2/apache2/php.ini:

sed -i '/session.cookie_secure =/c session.cookie_secure = On' /etc/php/8.2/apache2/php.ini

Установить параметр disableSameSiteCookie в /var/www/app/config/config.ini на значение Off:

sed -i '/disableSameSiteCookie =/c disableSameSiteCookie = Off' /var/www/app/config/config.ini
к сведению

Не устанавливайте эти параметры или верните их в исходное значение, если вы передумаете использовать SSL и будете работать через HTTP-протокол

9. Настройка фоновых задач​

Фоновые задачи — это задачи, которые выполняются по планировщику в фоновом режиме. Как настроить фоновые задачи.

осторожно

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

  • Работы LDAP;
  • Отправки почтовых уведомлений;
  • Загрузки фавиконов;
  • Очистки коллекции session в базе данных Пассворка.

10. Настройка безопасности​

осторожно

Перед изменением и настройке параметров безопасности, настоятельно рекомендуем убедиться в стабильной и корректной работе Пассворка, а также создать резервную копию файлов

Безопасность сервера является важной частью обеспечения защиты ценных данных и ресурсов компании. Это процесс, который требует планирования и исполнения, чтобы обеспечить максимальную защиту от различных угроз.

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

Версия для LLM
© 2014–2026 ООО «Пассворк»
Документы
ОфертаЛицензионное соглашениеПолитика конфиденциальностиЛицензия на деятельность по ТЗКИЛицензия на деятельность по СЗКИ
Расширение
Google ChromeMozilla FirefoxMicrosoft EdgeApple Safari
Моб. приложение
App StoreGoogle PlayRuStore
Полезные ссылки
Техническая документацияРуководство пользователяРелизы