Различия

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

Посмотреть различия двумя колонкамивнутри текста Go

Ссылка на это сравнение

2022/07/10 18:01 dx 2022/05/19 23:40 dx 2022/04/19 17:05 dx созданоGo Следующая версия		Предыдущая версия 2022/07/10 18:01 dx 2022/05/19 23:40 dx 2022/04/19 17:05 dx созданоGo
linux:ubuntu:cockpit [2022/04/19 17:05] – создано dx		linux:ubuntu:cockpit [2022/07/10 18:01] (текущий) – dx
Строка 1:		Строка 1:
		+	====== Установка Cockpit в 20.04 через Backports ======
		+	===== Постановка задачи =====
		+
		+	Запустить Cockpit подкаталоге, например https://foobar.com/cp/
		+
		+	Система Ubuntu 20.04, веб-сервер Apache.
		+
		+	Сразу оставлю ссылки по проксированию через apache и nginx
		+
		+	* [[https://github.com/cockpit-project/cockpit/wiki/Proxying-Cockpit-over-Apache-with-LetsEncrypt|Proxying Cockpit over Apache with LetsEncrypt]]
		+	* [[https://github.com/cockpit-project/cockpit/wiki/Proxying-Cockpit-over-nginx|Proxying Cockpit over nginx]]
		+
		+	В документации Cockpit указано, что нельзя использовать ''/cockpit/'' или ''/cockpit+'' в качестве подкаталога, поскольку они зарезервированы. Поэтому в моём примере будет использоваться ''/cp/''
		+
		+	===== Установка =====
		+
		+	Backports репозиторий должен быть включен по-умолчанию
		+
		+	<code>
		+	# apt-cache policy | grep http | awk '{print $2" "$3}' | sort -u | grep backport
		+	https://mirror.hetzner.com/ubuntu/packages focal-backports/main
		+	https://mirror.hetzner.com/ubuntu/packages focal-backports/universe
		+	</code>
		+
		+	Если нету, то добавляем в ''/etc/apt/sources.list''
		+
		+	<code>
		+	deb http://archive.ubuntu.com/ubuntu focal-backports main restricted universe multiverse
		+	</code>
		+
		+	Устанавливаем Cockpit
		+
		+	<code>
		+	apt-get update
		+	apt-get install -t focal-backports cockpit
		+	</code>
		+
		+	Лучше с **--no-install-recommends**, а то слишком много лишнего.
		+
		+	===== Файл настроек =====
		+
		+	Создаём файл ''/etc/cockpit/cockpit.conf''
		+
		+	<code>
		+	[WebService]
		+	Origins = https://foobar.com http://127.0.0.1:9090
		+	ProtocolHeader = X-Forwarded-Proto
		+	AllowUnencrypted = true
		+	UrlRoot = /cp/
		+	RequireHost = false
		+	LoginTo = false
		+	</code>
		+
		+	* **RequireHost** - если установлено значение false, то не потребуется указывать хост для входа.
		+	* **LoginTo** - если установлено значение false, то на экране входа не будет выводиться опция Connect to, которая позволяет при необходимости подключаться к удаленным хостам.
		+
		+	Описание опций [[https://cockpit-project.org/guide/latest/cockpit.conf.5.html|доступно здесь]].
		+
		+	===== Проксируем через Apache =====
		+
		+	Важный момент. Не забудьте активировать **proxy_wstunnel**. Не везде об этом пишут.
		+
		+	<code bash>a2enmod proxy proxy_wstunnel proxy_http ssl rewrite</code>
		+
		+	Настройки для Apache
		+
		+	<code bash>
		+	ProxyPreserveHost       On
		+	ProxyRequests           Off
		+
		+	SSLProxyVerify          None
		+	SSLProxyCheckPeerCN     Off
		+	SSLProxyCheckPeerName   Off
		+	SSLProxyCheckPeerExpire Off
		+
		+	# allow for upgrading to websockets
		+	RewriteEngine On
		+	RewriteCond %{HTTP:Upgrade}    =websocket [NC]
		+	RewriteRule /cp/(.*)           ws://127.0.0.1:9090/cp/$1 [P,L]
		+	RewriteCond %{HTTP:Upgrade}    !=websocket [NC]
		+	RewriteRule /cp/(.*)           http://127.0.0.1:9090/cp/$1 [P,L]
		+
		+	# Proxy to your local cockpit instance
		+	ProxyPass        /cp/          http://127.0.0.1:9090/cp/
		+	ProxyPassReverse /cp/          http://127.0.0.1:9090/cp/
		+	</code>
		+
		+	Если вы хотите использовать TLS за обратным прокси, то нужно заменить http на https, а ws на wss. Кроме того, необходимо удалить директивы SSLProxy.
		+
		+	Также необходимо скопировать сертификат и ключ в ''/etc/cockpit/ws-certs.d''.
		+
		+	<code bash>
		+	cp /etc/letsencrypt/live/foobar.com/fullchain.pem /etc/cockpit/ws-certs.d/foobar.com.crt
		+	cp /etc/letsencrypt/live/foobar.com/privkey.pem   /etc/cockpit/ws-certs.d/foobar.com.key
		+	chown cockpit-ws:cockpit-ws /etc/cockpit/ws-certs.d/foobar.com.crt /etc/cockpit/ws-certs.d/foobar.com.key
		+	</code>
		+
		+	Вроде бы есть специальная команда remotectl для проверки какой сертификат использует Cockpit, но это же Ubuntu :) У меня не сработало.
		+
		+	Вывод должен быть такой
		+
		+	<code bash>
		+	# remotectl certificate
		+	certificate: /etc/cockpit/ws-certs.d/foobar.crt
		+	</code>
		+
		+	<code bash>systemctl restart cockpit</code>
		+
		+	При обновлении сертификата LE нам также необходимо обновить их в Cockpit. Для этого добавим hook в ''/etc/letsencrypt/renewal-hooks/post/restart-cockpit.sh''
		+
		+	<code bash>
		+	#!/usr/bin/env bash
		+
		+	echo "SSL certificate update"
		+
		+	cp /etc/letsencrypt/live/foobar.com/fullchain.pem /etc/cockpit/ws-certs.d/foobar.com.crt
		+	cp /etc/letsencrypt/live/foobar.com/privkey.pem   /etc/cockpit/ws-certs.d/foobar.com.key
		+	chown cockpit-ws:cockpit-ws /etc/cockpit/ws-certs.d/foobar.com.crt /etc/cockpit/ws-certs.d/foobar.com.key
		+
		+	echo "Restarting Cockpit"
		+	systemctl restart cockpit
		+	</code>
		+
		+	{{:linux:ubuntu:ubuntu_cockpit_login.png?nolink|}}
		+
		+	EOM
		+
		+	{{tag>ubuntu apache cockpit control_panel панель_управления}}