**О данном файле README**

Данный файл README предназначен для предоставления быстрой и точной документации для технических пользователей, намеревающихся самостоятельно скомпилировать части Apache Guacamole.

Исходные архивы доступны в разделе загрузок веб-сайта проекта:

    http://guacamole.apache.org/

Также доступно полное руководство:

    http://guacamole.apache.org/doc/gug/

**Что такое guacamole-server?**

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

guacd — это прокси-демон Guacamole, используемый веб-приложением и фреймворком Guacamole. Поскольку JavaScript не может эффективно обрабатывать двоичные протоколы (такие как VNC и удалённый рабочий стол), был разработан новый текстовый протокол, который содержал бы общий надмножество операций, необходимых для эффективного удалённого доступа к рабочему столу, но был бы легко обрабатываем программами на JavaScript. guacd является прокси, который переводит между произвольными протоколами и протоколом Guacamole.

**Необходимые зависимости**

Всё программное обеспечение в guacamole-server построено с использованием популярного GNU Automake и, таким образом, предоставляет стандартный скрипт configure. Перед компиляцией необходимо установить следующие необходимые зависимости:

1) Cairo (http://cairographics.org/).
2) libjpeg-turbo (http://libjpeg-turbo.virtualgl.org/) или libjpeg (http://www.ijg.org/).
3) libpng (http://www.libpng.org/pub/png/libpng.html).
4) OSSP UUID (http://www.ossp.org/pkg/lib/uuid/).

**Необязательные зависимости**

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

RDP:
* FreeRDP (http://www.freerdp.com/).

SSH:
* libssh2 (http://www.libssh2.org/).
* OpenSSL (https://www.openssl.org/).
* Pango (http://www.pango.org/).

Telnet:
* libtelnet (https://github.com/seanmiddleditch/libtelnet).
* Pango (http://www.pango.org/).

VNC:
* libVNCserver (http://libvnc.github.io/).

Поддержка аудио в VNC:
* PulseAudio (http://www.freedesktop.org/wiki/Software/PulseAudio/).

Поддержка SFTP-передачи файлов для VNC или RDP:
* libssh2 (http://www.libssh2.org/).
* OpenSSL (https://www.openssl.org/).

Поддержка сжатия изображений WebP:
* libwebp (https://developers.google.com/speed/webp/).

«guacenc» — утилита кодирования видео:
* FFmpeg (https://ffmpeg.org/).

**Компиляция и установка guacd, libguac и т. д.**

Всё программное обеспечение в guacamole-server создано с использованием популярного GNU Automake, и поэтому предоставляется стандартный скрипт configure.

1. Запустите configure:

   $ ./configure

   При условии, что все зависимости были установлены, это должно пройти без ошибок. Если вы хотите также установить скрипт инициализации, вам нужно указать местоположение, где находятся ваши системные скрипты инициализации (обычно /etc/init.d):

   $ ./configure --with-init-dir=/etc/init.d

   Запуск configure таким способом приведёт к тому, что шаг «make install» установит скрипт инициализации в указанный каталог, который затем можно активировать с помощью механизма управления службами, предоставляемого вашим дистрибутивом.

2. Запустите make:

   $ make

   guacd, libguac и любые... Доступна поддержка библиотек протоколов, которые теперь будут компилироваться.

3) Установка (как root):  
    # make install

Будет установлено всё только что созданное программное обеспечение, включая документацию.

По умолчанию guacd будет установлен в каталог /usr/local/sbin. Вы можете изменить место установки с помощью опции --prefix для configure.

------------------------------------------------------------
Запуск guacd
------------------------------------------------------------

Если вы установили скрипт инициализации во время компиляции и установки, вы сможете запустить guacd через утилиты управления службами, предоставляемые вашим дистрибутивом (если таковые имеются), или запустив скрипт инициализации напрямую (с правами root):

    # /etc/init.d/guacd start

Для записи файла pidfile /var/run/guacd.pid необходим доступ с правами root. Также можно запустить guacd напрямую без скрипта инициализации (любым пользователем):

    $ guacd

В настоящее время guacd поддерживает несколько параметров командной строки:

    -b HOST

Изменяет хост или адрес, на котором слушает guacd.

    -l PORT

Изменяет порт, который слушает guacd (по умолчанию — порт 4822).

    -p PIDFILE

Заставляет guacd записывать PID процесса демона в указанный файл. Это полезно для скриптов инициализации и используется предоставленным скриптом инициализации.

    -L LEVEL

Устанавливает максимальный уровень, на котором guacd будет регистрировать сообщения в syslog и, если работает на переднем плане, в консоли. Допустимые значения: debug, info, warning и error. Значение по умолчанию — info.

    -f

Запускает guacd на переднем плане вместо автоматического перехода в фоновый режим.

Дополнительную информацию можно найти на странице руководства guacd:

    $ man guacd

------------------------------------------------------------
Сообщение о проблемах
------------------------------------------------------------

Пожалуйста, сообщайте обо всех обнаруженных ошибках, открыв новую задачу в системе JIRA, размещённой по адресу:

https://issues.apache.org/jira/browse/GUACAMOLE