Данная статья предназначена для тех, кто искал подробное и понятное руководство о том, как установить Confluence на Ubuntu Server.

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

В этом руководстве мы будем рассматривать тот случай, когда у вас уже есть сервер с установленной на нем операционной системой Ubuntu Server 20.04 LTS.

Подробно о том, как установить Ubuntu Server 20.04 LTS, вы можете прочитать в моем руководстве “Установка Ubuntu Server 20.04 LTS”.

Кроме того, на сервер должен быть установлен OpenSSH, а также открыт 22 порт, чтобы иметь возможность подключаться к серверу по протоколу SSH.

Для установки OpenSSH на сервер вы можете воспользоваться командой:

sudo apt install openssh-server

Если вы планируете подключиться к серверу, используя операционную систему Windows, то можете воспользоваться PuTTY - свободно распространяемым клиентом для различных протоколов удаленного доступа, включая SSH, Telnet, rlogin.

В данном руководстве рассматривается подключение к серверу при помощи терминального эмулятора iTerm2, установленного на операционную систему macOS.

Обратите внимание, вам потребуется открыть следующие порты TCP для доступа к вашему серверу:

  • 80 - для получения бесплатного криптографического сертификата через центр сертификации Let’s Encrypt.
  • 443 - для доступа к веб-интерфейсу Confluence.
  • 8090 - для доступа к веб-интерфейсу Confluence.

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

Обновим локальный индекс пакетов до последних изменений в репозиториях с помощью команды:

sudo apt update

Установка Confluence на Ubuntu Server

В данном руководстве рассматривается получение бесплатного криптографического сертификата через центр сертификации Let’s Encrypt. Для получения и последующего обновления бесплатного SSL-сертификата мы будем использовать программный клиент Certbot, который призван максимально упростить получение и обновление сертификата через центр сертификации Let’s Encrypt.

Теперь установим пакеты, необходимые для работы Confluence, с помощью команды:

sudo apt install -y postgresql apache2 apt-transport-https certbot python3-certbot-apache fontconfig

Обратите внимание, в данном руководстве в качестве системы для управления базами данных будет использоваться PostgreSQL, а в качестве веб-сервера - Apache.

Установка Confluence на Ubuntu Server

Настроим Apache для последующей работы с Confluence.

Включаем модуль веб-сервера Apache под названием “proxy_http” с помощью команды:

sudo a2enmod proxy_http

Обратите внимание, модуль “proxy_http” выполняет функции прокси-сервера для протоколов HTTP и HTTPS.

Установка Confluence на Ubuntu Server

Включаем модуль веб-сервера Apache под названием “rewrite” с помощью команды:

sudo a2enmod rewrite

Обратите внимание, модуль “rewrite” является одним из самых часто используемых модулей веб-сервера Apache и предоставляет гибкий и мощный способ манипулирования URL-адресами.

Установка Confluence на Ubuntu Server

Теперь нужно создать два файла виртуальных хостов (в Nginx называется блок), с которыми в дальнейшем будет работать Confluence.

Два файла виртуальных хостов потребуются для обеспечения доступа к Confluence по HTTPS, а также для реализации возможности использования Confluence по адресу https://confluence.heyvaldemar.net, без указания порта 8090 в адресной строке браузера.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

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

sudo vim /etc/apache2/sites-available/confluence.heyvaldemar.net.conf

Установка Confluence на Ubuntu Server

Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы веб-сервера.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

Установка Confluence на Ubuntu Server

Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.

Установка Confluence на Ubuntu Server

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

sudo vim /etc/apache2/sites-available/confluence.heyvaldemar.net-ssl.conf

Установка Confluence на Ubuntu Server

Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, затем вставляем следующую конфигурацию для работы веб-сервера.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

Установка Confluence на Ubuntu Server

Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.

Установка Confluence на Ubuntu Server

Активируем первый виртуальный хост с помощью команды:

sudo a2ensite confluence.heyvaldemar.net.conf

Установка Confluence на Ubuntu Server

Активируем второй виртуальный хост с помощью команды:

sudo a2ensite confluence.heyvaldemar.net-ssl.conf

Установка Confluence на Ubuntu Server

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

sudo a2dissite 000-default.conf

Установка Confluence на Ubuntu Server

Убедимся, что в синтаксисе нового конфигурационного файла Apache нет ошибок, с помощью команды:

sudo apache2ctl configtest

Установка Confluence на Ubuntu Server

Перезапустим Apache, чтобы применить внесенные изменения, с помощью команды:

sudo systemctl restart apache2

Установка Confluence на Ubuntu Server

Проверим, что Apache успешно запустился, с помощью команды:

sudo systemctl status apache2

Установка Confluence на Ubuntu Server

Теперь, чтобы повысить уровень безопасности веб-сервера, необходимо получить криптографический сертификат для домена или субдомена, по которому панель управления Confluence будет доступна из сети Интернет.

Для получения и последующего обновления бесплатного SSL-сертификата мы будем использовать центр сертификации Let’s Encrypt, а также программный клиент Certbot, который призван максимально упростить получение и обновление сертификата через центр сертификации Let’s Encrypt.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

Запросим криптографический сертификат с помощью команды:

sudo certbot --apache -d confluence.heyvaldemar.net

Установка Confluence на Ubuntu Server

Далее указываем адрес электронной почты, на который Let’s Encrypt будет присылать уведомления об истечении срока криптографического сертификата, и нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

На следующем этапе необходимо прочитать и принять условия использования предоставляемых сервисов.

Нажимаем на кнопку “a”, затем “Enter”, если вы согласны с условиями использования предоставляемых сервисов.

Установка Confluence на Ubuntu Server

На следующем этапе необходимо выбрать: хотите ли вы поделиться указанным ранее адресом электронной почты с Electronic Frontier Foundation для получения информационных рассылок.

Нажимаем на кнопку “n”, затем “Enter”.

Установка Confluence на Ubuntu Server

На следующем этапе необходимо выбрать: хотите ли вы, чтобы в конфигурационный файл Apache были автоматически добавлены параметры для автоматического перенаправления HTTP-трафика на HTTPS.

Нажимаем на кнопку “2”, затем “Enter”.

Установка Confluence на Ubuntu Server

Обратите внимание, криптографические сертификаты, полученные через центр сертификации Let’s Encrypt, действительны в течение девяноста дней. Certbot автоматически добавляет скрипт для обновления сертификата в планировщик задач, и скрипт запускается два раза в день, автоматически обновляя любой криптографический сертификат, срок действия которого истекает в течение тридцати дней.

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

sudo certbot renew --dry-run

Установка Confluence на Ubuntu Server

Теперь необходимо создать базу данных, которую в дальнейшем будет использовать Confluence, а также пользователя с необходимыми правами в этой базе данных.

Переключаемся на пользователя “postgres”, который обладает правами администратора в PostgreSQL, с помощью команды:

sudo su - postgres

Установка Confluence на Ubuntu Server

Далее переключаемся на командную строку PostgreSQL с помощью команды:

psql

Установка Confluence на Ubuntu Server

Создаем нового пользователя с помощью команды:

CREATE USER confluencedbuser WITH PASSWORD '2n!sfa@423FdsC0fH$vL';

В данном руководстве в качестве имени пользователя будет использоваться “confluencedbuser”, с паролем “2n!sfa@423FdsC0fH$vL”.

Установка Confluence на Ubuntu Server

Создаем новую базу данных и выдаем на нее права ранее созданному пользователю с помощью команды:

CREATE DATABASE "confluencedb" WITH OWNER "confluencedbuser" ENCODING 'UTF8' LC_COLLATE = 'en_US.UTF-8' LC_CTYPE = 'en_US.UTF-8' TEMPLATE template0 CONNECTION LIMIT = -1;

В данном руководстве в качестве имени для базы данных будет использоваться “confluencedb”.

Установка Confluence на Ubuntu Server

Выходим из командной строки “PostgreSQL” с помощью команды:

\q

Установка Confluence на Ubuntu Server

Выходим из-под пользователя “postgres” с помощью команды:

exit

Установка Confluence на Ubuntu Server

Теперь необходимо загрузить установщик Confluence с помощью команды:

wget https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-7.12.0-x64.bin

Обратите внимание, актуальную версию Confluence можно найти на официальном сайте Atlassian.

В данном руководстве рассматривается установка Confluence 7.12.0.

Установка Confluence на Ubuntu Server

Разрешим исполнение файла “atlassian-confluence-7.12.0-x64.bin” с помощью команды:

sudo chmod a+x atlassian-confluence-7.12.0-x64.bin

Установка Confluence на Ubuntu Server

Запустим установку Confluence с помощью команды:

sudo ./atlassian-confluence-7.12.0-x64.bin

Обратите внимание, ваша команда будет отличаться от указанной в этой статье, так как вы будете устанавливать актуальную на момент прочтения версию Confluence.

Установка Confluence на Ubuntu Server

На первом этапе установщик предупредит о том, что на ваш сервер будет установлен Confluence.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

Далее выбираем “Custom Install (recommended for advanced users)”.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

На следующем шаге можно выбрать, куда установить Confluence.

В данном руководстве рассматривается установка Confluence в “/opt/atlassian/confluence”.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

Далее можно выбрать, где хранить данные Confluence.

В данном руководстве рассматривается установка Confluence в “/var/atlassian/application-data/confluence”.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

Теперь можно выбрать порты, которые будет использовать Confluence.

В данном руководстве рассматривается установка Confluence с использованием порта 8090 для HTTP и порта 8000 для Control.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

Далее будет предложена возможность установить Confluence, как сервис.

Нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

Установка Confluence успешно завершена.

Обратите внимание, запускать Confluence не нужно.

Указываем “n” и нажимаем на кнопку “Enter”.

Установка Confluence на Ubuntu Server

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

sudo vim /opt/atlassian/confluence/conf/server.xml

Установка Confluence на Ubuntu Server

Нажимаем на кнопку “i”, чтобы перейти в режим редактирования, находим раздел “DEFAULT - Direct connector with no proxy, for unproxied HTTP access to Confluence” и закомментируем его, поставив <! – на строке выше параметров раздела и –> ниже параметров раздела, которые требуется закомментировать.

Установка Confluence на Ubuntu Server

Далее находим раздел “HTTPS - Proxying Confluence via Apache or Nginx over HTTPS” и раскомментируем его, удалив знак <! – на строке выше параметров раздела и –> ниже параметров раздела, которые требуется раскомментировать.

Затем указываем для параметра “proxyName” значение “confluence.heyvaldemar.net”.

В данном руководстве для доступа к Confluence из сети Интернет будет использоваться субдомен confluence.heyvaldemar.net. Вам нужно будет указать ваш домен или субдомен, по которому ваш Confluence будет доступен из сети Интернет.

Установка Confluence на Ubuntu Server

Теперь нажмите на кнопку “Esc”, чтобы выйти из режима редактирования, а затем введите “:x” и нажмите на кнопку “Enter”, чтобы сохранить изменения и выйти из редактора.

Установка Confluence на Ubuntu Server

Запускаем Confluence с помощью команды:

sudo /etc/init.d/confluence start

Установка Confluence на Ubuntu Server

Открываем лог Confluence, чтобы проверить корректность запуска Confluence, с помощью команды:

sudo less /opt/atlassian/confluence/logs/catalina.out

Установка Confluence на Ubuntu Server

На клавиатуре нажимаем сочетание клавиш “Shift” и “f”, чтобы начать следить за изменениями в логе Confluence в реальном времени.

Обратите внимание, сообщение, содержащее “Server startup in [12,548] milliseconds”, свидетельствует, что Confluence успешно запустился.

На клавиатуре нажимаем сочетание клавиш “Ctrl” и “c”, затем “q”, чтобы закрыть лог Confluence.

Установка Confluence на Ubuntu Server

Для продолжения процесса установки Confluence необходимо с рабочей станции перейти по ссылке https://confluence.heyvaldemar.net, где confluence.heyvaldemar.net - имя моего сервера. Соответственно, вам необходимо указать имя или IP-адрес вашего сервера Confluence.

В данном руководстве рассматривается установка Confluence для продуктивной среды.

Выбираем “Production Installation” и нажимаем на кнопку “Next”.

Установка Confluence на Ubuntu Server

Теперь необходимо указать лицензионный ключ для Confluence.

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

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

Нажимаем на “Get an evaluation licence”.

Установка Confluence на Ubuntu Server

Далее нажимаем на кнопку “Sign up for an account”, если у вас еще нет учетной записи Atlassian.

Установка Confluence на Ubuntu Server

На следующем шаге необходимо указать: адрес электронной почты, имя, фамилию и пароль для создания учетной Atlassian.

Нажимаем на кнопку “Sign up”.

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

Установка Confluence на Ubuntu Server

Если у вас уже есть учетная запись Atlassian, то в поле “Enter email” указываем адрес электронной почты, привязанной к учетной записи Atlassian, и нажимаем на кнопку “Continue”.

Установка Confluence на Ubuntu Server

Указываем пароль от учетной записи Atlassian и нажимаем на кнопку “Log in”.

Установка Confluence на Ubuntu Server

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

Нажимаем на кнопку “Generate License” для генерации временного лицензионного ключа для Confluence.

Установка Confluence на Ubuntu Server

Далее нужно подтвердить, что временный лицензионный ключ для Confluence будет установлен на ваш сервер.

Нажимаем на кнопку “Yes”.

Установка Confluence на Ubuntu Server

В поле “Confluence” вставляем ранее полученный временный лицензионный ключ и нажимаем на кнопку “Next”.

Установка Confluence на Ubuntu Server

Теперь необходимо настроить подключение к ранее созданной базе данных.

Выбираем “My own database” и нажимаем на кнопку “Next”.

Установка Confluence на Ubuntu Server

Теперь необходимо указать систему для управления базами данных и ранее созданную базу данных, которая будет использоваться для работы Confluence.

В поле “Database type” выбираем “PostgreSQL”.

В разделе “Setup type” выбираем “Simple”.

В данном руководстве база данных для работы Confluence находится на одном сервере с Confluence.

В поле “Hostname” указываем “localhost”.

В поле “Database port” указываем значение “5432”.

В данном руководстве в качестве имени базы данных для работы Confluence используется “confluencedb”.

В поле “Database name” указываем “confluencedb”.

В данном руководстве в качестве имени пользователя, обладающего правами на базу данных для работы Confluence, используется “confluencedbuser”.

В поле “Username” указываем “confluencedbuser”.

В поле “Password” указываем пароль, присвоенный пользователю “confluencedbuser”.

Нажимаем на кнопку “Test connection”.

Установка Confluence на Ubuntu Server

Сообщение “Success! Database connected successfully.” означает, что все данные были указаны корректно.

Нажимаем на кнопку “Next”.

Установка Confluence на Ubuntu Server

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

В данном руководстве рассматривается установка Confluence без импорта какого-либо контента.

Нажимаем на кнопку “Empty Site”.

Установка Confluence на Ubuntu Server

Далее можно настроить управление пользователями Confluence при помощи “Jira”.

В данном руководстве рассматривается установка Confluence без возможности управления пользователями при помощи Jira.

Нажимаем на кнопку “Manage users and groups within Confluence”.

Установка Confluence на Ubuntu Server

На следующем шаге необходимо указать: логин, имя, адрес электронной почты и пароль для создания учетной записи администратора Confluence.

Нажимаем на кнопку “Next”.

Установка Confluence на Ubuntu Server

Все готово для использования Confluence.

Нажимаем на кнопку “Start”.

Установка Confluence на Ubuntu Server

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

Указываем имя для первого пространства и нажимаем на кнопку “Continue”.

Установка Confluence на Ubuntu Server

Далее откроется редактор, в котором можно создать первую страницу в новом пространстве.

Нажимаем на кнопку “Skip tutorial”.

Установка Confluence на Ubuntu Server

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

Нажимаем на кнопку “Publish”.

Установка Confluence на Ubuntu Server

Первая страница в пространстве для разработчиков успешно создана.

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

Установка Confluence на Ubuntu Server

Владимир Михалев
Привет, я Владимир Михалев, но друзья зовут меня Вальдемарыч. Я обладаю практическим опытом проектирования и сопровождения различных информационных систем.