git-daemon

Точное сопоставление путей (то есть путь "/foo/repo" не будет принят, если реальный путь — "/foo/repo.git" или "/foo/repo/.git"); пути относительно домашнего каталога пользователя не используются. git daemon откажется запускаться, если этот параметр включён, а аргументы с каталогами не указаны.

Сопоставлять все запросы путей относительно указанного пути. Это своего рода «корень Git»: если запустить git daemon с параметром --base-path=/srv/git для example.com, то при последующей попытке извлечь изменения из git://example.com/hello.git команда git daemon будет интерпретировать путь как /srv/git/hello.git.

Если включён параметр --base-path и поиск репозитория завершается неудачей, с этим параметром git daemon попытается выполнить поиск без добавления базового пути. Это полезно при переходе на использование --base-path, сохраняя поддержку старых путей.

Для поддержки виртуального хостинга можно использовать шаблон пути с подстановками, чтобы динамически формировать альтернативные пути. Шаблон поддерживает %H для имени целевого узла, переданного клиентом и преобразованного в нижний регистр, %CH для канонического имени узла, %IP для IP-адреса сервера, %P для номера порта и %D для абсолютного пути к указанному репозиторию. После подстановки путь проверяется на соответствие списку каталогов.

Разрешить извлечение изменений из всех каталогов, похожих на репозитории Git (с подкаталогами objects и refs), даже если в них нет файла git-daemon-export-ok.

Запустить сервер как службу inetd. Подразумевает --syslog (можно переопределить с помощью --log-destination=). Несовместим с параметрами --detach, --port, --listen, --user и --group.

Прослушивать указанный IP-адрес или имя узла. IP-адрес может быть адресом IPv4 или, если поддерживается, IPv6. Если IPv6 не поддерживается, параметр --listen=<hostname> также не поддерживается, а в --listen необходимо указать адрес IPv4. Параметр можно указывать несколько раз. Несовместим с параметром --inetd.

Прослушивать альтернативный порт. Несовместим с параметром --inetd.

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

Тайм-аут (в секундах) для отдельных подзапросов клиента. Он включает время обработки подзапроса сервером и время ожидания следующего запроса клиента.

Максимальное число одновременных клиентов; по умолчанию — 32. Установите значение 0, чтобы снять ограничение.

Сокращение для --log-destination=syslog.

Отправлять сообщения журнала в указанное место назначения. Обратите внимание, что этот параметр не подразумевает --verbose, поэтому по умолчанию регистрируются только ошибки. Значением <destination> должно быть одно из следующих:

По умолчанию местом назначения является syslog, если указан параметр --inetd или --detach; в противном случае используется stderr.

Разрешить использование обозначения ~user в запросах. Если параметр указан без значения, запрос git://host/~alice/foo рассматривается как запрос доступа к репозиторию foo в домашнем каталоге пользователя alice. Если указан параметр --user-path=<path>, тот же запрос рассматривается как запрос доступа к репозиторию <path>/foo в домашнем каталоге пользователя alice.

Записывать подробные сведения о входящих соединениях и запрашиваемых файлах.

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

Отсоединиться от оболочки. Подразумевает --syslog.

Сохранить идентификатор процесса в <file>. Игнорируется, если демон запущен под управлением --inetd.

Изменить uid и gid демона перед переходом к циклу обслуживания. Если указан только --user, но не --group, используется идентификатор основной группы пользователя. Значения параметров передаются в getpwnam(3) и getgrnam(3); числовые идентификаторы не поддерживаются.

Использование этих параметров вместе с --inetd приводит к ошибке; при необходимости используйте средства демона inet, чтобы добиться того же до запуска git daemon.

Как и многие программы, меняющие идентификатор пользователя, демон не сбрасывает переменные окружения, такие как HOME, при запуске программ Git, например upload-pack и receive-pack. При использовании этого параметра также может потребоваться задать и экспортировать HOME, указав домашний каталог пользователя <user>, до запуска демона, а также убедиться, что любые файлы конфигурации Git в этом каталоге доступны для чтения пользователю <user>.

Включить или отключить службу по умолчанию для всего сайта. Обратите внимание: службу, отключённую на уровне сайта, всё ещё можно включить для отдельного репозитория, если разрешено переопределение и служба включена в конфигурации репозитория.

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

Если включены информативные сообщения об ошибках, git-daemon отправляет клиенту более подробные сведения, различая, например, ситуации «репозиторий не существует» и «репозиторий не экспортируется». Это удобнее для клиентов, но может раскрыть сведения о существовании неэкспортируемых репозиториев. Если информативные сообщения об ошибках не включены, во всех случаях клиенту сообщается «доступ запрещён». По умолчанию используется --no-informative-errors.

При каждом подключении клиента сначала запускать внешнюю команду, указанную в <path>. В качестве аргументов командной строки ей передаются имя службы (например, "upload-pack"), путь к репозиторию, имя узла (%H), каноническое имя узла (%CH), IP-адрес (%IP) и порт TCP (%P). Внешняя команда может отклонить запрос на службу, завершившись с ненулевым кодом (или разрешить его, завершившись с нулевым кодом). При принятии решения она также может использовать переменные окружения $REMOTE_ADDR и $REMOTE_PORT, чтобы получить сведения о запрашивающей стороне.

При отклонении запроса внешняя команда может записать одну строку в стандартный поток вывода; она будет отправлена запрашивающей стороне в качестве сообщения об ошибке.

Оставшиеся аргументы задают список каталогов. Если каталоги указаны, процесс git-daemon будет обслуживать запрошенный каталог, только если тот находится в одном из этих каталогов. Если указан параметр --strict-paths, запрошенный каталог должен точно совпадать с одним из этих каталогов.

Эта служба обслуживает клиентов git fetch-pack и git ls-remote. По умолчанию она включена, но её можно отключить для репозитория, установив для параметра конфигурации daemon.uploadpack значение false.

Эта служба обслуживает git archive --remote. По умолчанию она отключена, но её можно включить для репозитория, установив для параметра конфигурации daemon.uploadarch значение true.

Эта служба обслуживает клиентов git send-pack, позволяя выполнять анонимную отправку изменений. По умолчанию она отключена, поскольку в протоколе отсутствует no аутентификация (иными словами, любой может отправить в репозиторий любые данные, в том числе удалить ссылки). Эта служба предназначена исключительно для закрытых локальных сетей, где все участники заслуживают доверия. Её можно включить, установив для параметра конфигурации daemon.receivepack значение true.

Чтобы настроить git daemon как службу inetd, обслуживающую любые репозитории в /pub/foo или /pub/bar, добавьте в /etc/inetd следующую запись, расположив её целиком в одной строке:

        git stream tcp nowait nobody  /usr/bin/git
                git daemon --inetd --verbose --export-all
                /pub/foo /pub/bar

Чтобы настроить git daemon как службу inetd, обслуживающую репозитории для разных виртуальных хостов — www.example.com и www.example.org, — добавьте в /etc/inetd следующую запись, расположив её целиком в одной строке:

        git stream tcp nowait nobody /usr/bin/git
                git daemon --inetd --verbose --export-all
                --interpolated-path=/pub/%H%D
                /pub/www.example.org/software
                /pub/www.example.com/software
                /software

В этом примере каталог верхнего уровня /pub содержит подкаталог для каждого поддерживаемого имени виртуального хоста. Кроме того, оба хоста объявляют репозитории просто как git://www.example.com/software/repo.git. Для клиентов до версии 1.4.0 можно также создать символическую ссылку из /software на соответствующий репозиторий по умолчанию.

Чтобы настроить git daemon как обычную службу, не использующую inetd и обслуживающую репозитории нескольких виртуальных хостов на основе их IP-адресов, запустите демон следующим образом:

        git daemon --verbose --export-all
                --interpolated-path=/pub/%IP/%D
                /pub/192.168.1.200/software
                /pub/10.10.220.23/software

В этом примере каталог верхнего уровня /pub содержит подкаталог для каждого поддерживаемого IP-адреса виртуального хоста. Репозитории по-прежнему можно открывать по имени узла, если оно соответствует одному из этих IP-адресов.

Чтобы включить для репозитория службы git archive --remote и отключить git fetch, добавьте следующие строки в файл конфигурации репозитория (то есть в файл config рядом с HEAD, refs и objects).

        [daemon]
                uploadpack = false
                uploadarch = true