diff --git a/docs/docs/guacamole/about.md b/docs/docs/guacamole/about.md new file mode 100644 index 0000000..46b6aca --- /dev/null +++ b/docs/docs/guacamole/about.md @@ -0,0 +1,19 @@ +## Что такое Guacamole? + +**Guacamole** это веб сервис от **Apache**, который дает возможность подключаться по разным протоколам к разным устройствам через веб клиент. + +## Список поддерживаемых протоколов + +- **RDP** +- **VNC** +- **SSH** +- **TELLNET** + + +| ![guacamole main page](../../media/guacamole-mainpage.png) | ![guacamole win2009](../../media/guacamole-connect-to-win2009.png) | +| :---: | :---: | +| Основная страница Guacamole | Windows server 2009 через Guacamole | + +| ![guacamole terminal](../../media/guacamole-terminal.png) | +| :---: | +| Терминал с MC | diff --git a/docs/docs/guacamole/install.md b/docs/docs/guacamole/install.md new file mode 100644 index 0000000..914296e --- /dev/null +++ b/docs/docs/guacamole/install.md @@ -0,0 +1,122 @@ +# Установка Guacamle + +!!!Info "Вариант установки" + Есть 2 варианта установки: + + 1. **Ручная** - Компиляция **Guacd**, установка **tomcat** с клиентом **Guacamole** и подключение к **базе данных**. + 2. **Docker** контейнеры - **mysql**, **guacd**, **guacamole**. + + Будет описана установка Guacamole с помощью Docker. + +## Примечание +Проверьте, что у вас установлен **Docker**. + +## Готовые файлы + +`docker-compoae.yaml`: +```yaml +services: + guacamole: + image: guacamole/guacamole + container_name: guacamole + restart: always + env_file: + - ./.env + depends_on: + - guacd + - mysql + ports: + - "80:8080" + environment: + GUACD_HOSTNAME: guacd + MYSQL_HOSTNAME: mysql + MYSQL_DATABASE: guacamole_db + MYSQL_USER: "guacamole" + MYSQL_PASSWORD: "guacamole" + volumes: + - ./data/guacamole/data:/app/data + + guacd: + image: guacamole/guacd + container_name: guacd + restart: always + + mysql: + image: mysql:8.0 + container_name: mysql + restart: always + env_file: + - ./.env + environment: + MYSQL_ROOT_PASSWORD: ${ROOTPASS} + MYSQL_DATABASE: guacamole_db + MSQL_USER: ${GUACUSER} + MYSQL_PASSWORD: ${GUACPASS} + volumes: + - ./data/mysql/data:/var/lib/mysql + - ./data/mysql/script:/script + pma: + image: phpmyadmin + restart: always + ports: + - 8080:80 + environment: + PMA_HOST: mysql +``` + +`.env`: +``` +GUACUSER=CHANGE-ME +GUACPASS=CHANGE-ME +ROOTPASS=CHANGE-ME +``` + +## Первая настройка +Перед запуском, нужно настроить базу данных. + +Запускаем все контейнеры +```bash +docker compose up -d +``` + +Создаем файл базы данных **initdb.sql** +```bash +docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh > ./initdb.sql +``` + +Файл базы данных **initdb.sql** должен появиться в активном каталоге. + +Добавим самым простым способом в базу данных mysql, использую **PhpMyAdmin**. + +1. Заходим на **PhpMyAdmin** и вводим логин и пароль. `{address}:8080` +2. Переходим в базу данных, которую будет использовать **Guacamole**. В наем случае это **guacamole_db**. +3. Выбираем вкладку **SQL**. +4. Открываем **initdb.sql**, копируем содержимое и вставляем в большое поле. +5. После вставки, нажимаем **Вперёд**. + +| ![phpmyadmin login](../../media/phpmyadmin-login.png) | ![phpmyadmin main page](../../media/phpmyadmin-main_page.png) | +| :---: | :---: | +| Страница авторизации | Главная страница | + +| ![phpmyadin paste data](../../media/phpmyadmin-paste-sql-data-from-database.png) | +| :---: | +| Вставленные данные | + + +## Вход на Guacamole + +Переходим на сайт Guacamole и вводим логин и пароль учетной записи. + +- Логин: `guacadmin` +- Пароль: `guacadmin` + +| ![guacamole login](../../media/guacamole-login.png) | +| : --- : | +| Вход на Guacamole | + +Если все сделали корректно, то аунтификация должна пройти успешно. + +## Ссылки + +- [Оф. сайт](https://guacamole.apache.org/) +- [Документация](https://guacamole.apache.org/doc/gug/) - на английском diff --git a/docs/media/guacamole-connect-to-win2009.png b/docs/media/guacamole-connect-to-win2009.png new file mode 100644 index 0000000..88f07e9 Binary files /dev/null and b/docs/media/guacamole-connect-to-win2009.png differ diff --git a/docs/media/guacamole-login.png b/docs/media/guacamole-login.png new file mode 100644 index 0000000..c411543 Binary files /dev/null and b/docs/media/guacamole-login.png differ diff --git a/docs/media/guacamole-mainpage.png b/docs/media/guacamole-mainpage.png new file mode 100644 index 0000000..3bd681d Binary files /dev/null and b/docs/media/guacamole-mainpage.png differ diff --git a/docs/media/guacamole-terminal.png b/docs/media/guacamole-terminal.png new file mode 100644 index 0000000..6fa01f8 Binary files /dev/null and b/docs/media/guacamole-terminal.png differ diff --git a/docs/media/phpmyadmin-login.png b/docs/media/phpmyadmin-login.png new file mode 100644 index 0000000..e356e6b Binary files /dev/null and b/docs/media/phpmyadmin-login.png differ diff --git a/docs/media/phpmyadmin-main_page.png b/docs/media/phpmyadmin-main_page.png new file mode 100644 index 0000000..a4d8b11 Binary files /dev/null and b/docs/media/phpmyadmin-main_page.png differ diff --git a/docs/media/phpmyadmin-paste-sql-data-from-database.png b/docs/media/phpmyadmin-paste-sql-data-from-database.png new file mode 100644 index 0000000..ead8ba7 Binary files /dev/null and b/docs/media/phpmyadmin-paste-sql-data-from-database.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 2398f69..babe625 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -45,16 +45,19 @@ nav: 'Установка': docs/docker/install.md #'Команды': docs/docker/commands.md 'Запуск контейнеров': docs/docker/run_container.md + - 'Apache guacamole': + - 'О проекте': docs/guacamole/about.md + - 'Установка': docs/guacamole/install.md - 'Steam Deck': - "Снятие Read Only с корневого раздела": docs/steam-deck/disable-read-only.md - Сервисы: services.md - Мои сервера: server.md - - Блог: - - Привет: blog/hi.md - - 2026: - - Январь: - #- "01 Создание блога": blog/2026/create-blog.md - - "01 Дефецит комплектующих ПК": blog/2026/ai-and-me.md + #- Блог: + # - Привет: blog/hi.md + # - 2026: + # - Январь: + # #- "01 Создание блога": blog/2026/create-blog.md + # - "01 Дифицит комплектующих ПК": blog/2026/ai-and-me.md extra: social: