Поиск по сайту:

Как установить BookStack на Ubuntu 18.04 LTS

На этой странице

  1. Требования
  2. Начало работы
  3. Установить сервер LAMP
  4. Настройка MariaDB
  5. Установить книжный стек
  6. Настройка Apache для Bookstack
  7. Доступ к книжной стопке
  8. Заключение

BookStack — это бесплатная платформа управления знаниями с открытым исходным кодом, которую можно использовать для создания документации и вики-контента для ваших пользователей. BookStack написан на языке PHP и использует веб-фреймворк Laravel. BookStack позволяет вам настроить BookStack в соответствии с вашими потребностями, например, изменить имя, логотип и параметры регистрации. BookStack предоставляет множество функций, таких как многоязычная поддержка, редактор Markdown, настраиваемый, с возможностью поиска, интерфейс WYSIWYG, управление ролями и разрешениями, встроенная аутентификация и многое другое.

В этом руководстве мы узнаем, как установить Bookstack с Apache на сервер Ubuntu 18.04.

Требования

  • Сервер под управлением Ubuntu 18.04.
  • Пользователь без полномочий root с привилегиями sudo.

Начиная

Перед запуском вам нужно будет обновить вашу систему до последней версии. Вы можете сделать это, выполнив следующую команду:

sudo apt-get update -y
sudo apt-get upgrade -y

После обновления вашей системы перезапустите систему, чтобы изменения вступили в силу.

Установить LAMP-сервер

Во-первых, вам нужно будет установить веб-сервер Apache, сервер MariaDB, PHP и другие модули PHP в вашу систему. Вы можете установить их все, выполнив следующую команду:

sudo apt-get install apache2 mariadb-server php7.2 libapache2-mod-php7.2 php7.2-common php7.2-sqlite3 php7.2-curl php7.2-intl php7.2-mbstring php7.2-xmlrpc php7.2-mysql php7.2-gd php7.2-xml php7.2-cli php7.2-tidy php7.2-zip unzip wget git -y

После установки всех пакетов откройте файл php.ini и внесите некоторые изменения:

sudo nano /etc/php/7.2/apache2/php.ini

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

memory_limit = 256M
upload_max_filesize = 150M
max_execution_time = 360
date.timezone = Asia/Kolakata

Сохраните и закройте файл.

Настроить MariaDB

По умолчанию MariaDB не защищена. Так что вам нужно будет обеспечить его в первую очередь. Вы можете защитить его, выполнив следующую команду:

sudo mysql_secure_installation

Ответьте на все вопросы, как показано ниже:

    Enter current password for root (enter for none): ENTER
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Как только MariaDB будет защищена, войдите в оболочку MariaDB:

mysql -u root -p

Укажите свой пароль root. Затем создайте базу данных и пользователя для Bookstack:

MariaDB [(none)]> CREATE DATABASE bookstackdb;
MariaDB [(none)]> CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'password';

Замените слово «пароль» в приведенной выше команде безопасным паролем, а не опускайте его для последующего использования. Затем предоставьте все привилегии Bookstack с помощью следующей команды:

MariaDB [(none)]> GRANT ALL ON bookstackdb.* TO 'bookstack'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Замените слово пароль снова здесь тем же паролем, который вы использовали выше. Затем сбросьте привилегии и выйдите из оболочки MariaDB:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Установить книжный стек

Во-первых, вам нужно будет установить Composer в вашу систему. Composer — это менеджер зависимостей для PHP. Вы можете установить Composer с помощью следующей команды:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Затем измените каталог на /var/www/html и загрузите последнюю версию Bookstack из репозитория Git с помощью следующей команды:

cd /var/www/html/
sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch

Затем измените каталог на Bookstack и установите все зависимости, необходимые для PHP, с помощью следующей команды:

cd Bookstack
sudo composer install

После установки всех зависимостей скопируйте пример файла конфигурации среды с помощью следующей команды:

sudo cp .env.example .env

Затем обновите настройки базы данных в файле .env:

sudo nano .env

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

# Database details
DB_HOST=localhost
DB_DATABASE=bookstackdb
DB_USERNAME=bookstack
DB_PASSWORD=password

Сохраните и закройте файл. Затем создайте ключ приложения и перенесите базу данных с помощью следующей команды:

sudo php artisan key:generate

Вывод:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Application key [base64:KTcNpGD5CacIz20eiKpusk02YaHm14OQTZTERizEDBw=] set successfully.

Далее вам нужно будет перенести базу данных. Вы можете перенести базу данных с помощью следующей команды:

sudo php artisan migrate

Вы должны увидеть следующий вывод:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Migration table created successfully.

Затем предоставьте соответствующие разрешения каталогу Bookstack с помощью следующей команды:

sudo chown -R www-data:www-data /var/www/html/BookStack/
sudo chmod -R 755 /var/www/html/BookStack/

Настройте Apache для Bookstack

Далее вам нужно будет создать файл виртуального хоста Apache для Bookstack. Вы можете создать его с помощью следующей команды:

sudo nano /etc/apache2/sites-available/bookstack.conf

Добавьте следующие строки:

<VirtualHost *:80>
     ServerAdmin 
     DocumentRoot /var/www/html/Bookstack
     ServerName example.com
     ServerAlias www.example.com

    <Directory /var/www/html/Bookstack/>
        Options FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Замените example.com и www.example.com в приведенном выше файле своим собственным доменным именем. Затем сохраните и закройте файл, включите файл виртуального хоста Apache и перепишите модуль с помощью следующих команд:

sudo a2ensite bookstack.conf
sudo a2enmod rewrite

Наконец, перезапустите веб-службу Apache, чтобы применить все изменения:

sudo systemctl restart apache2

Доступ к книжной стопке

Откройте веб-браузер и введите URL-адрес, в моем случае это http://example.com, вы будете перенаправлены на следующую страницу:

Теперь укажите имя пользователя по умолчанию как [email и пароль в качестве пароля, затем нажмите кнопку ВХОД. Вы будете перенаправлены на панель инструментов Bookstack на следующей странице:

Следующим шагом должно быть изменение пароля по умолчанию для защиты входа в BookStack.

Заключение

Поздравляем! вы успешно установили Bookstack на сервер Ubuntu 18.04 LTS. Теперь вы можете легко создать свой собственный вики-сайт с помощью Bookstack. Не стесняйтесь спрашивать меня, если у вас есть какие-либо вопросы.