Caddy - это расширяемая серверная платформа, которая по умолчанию использует TLS.
Выпуски · Документация · Получите помощь
Питаться от
Самый простой, кроссплатформенный способ начать-загрузить Caddy из выпусков GitHub и поместить исполняемый файл в свой путь.
Смотрите нашу онлайн -документацию для других инструкций по установке.
Требования:
Примечание. Эти шаги не будут внедрять правильную информацию о версии. Для этого, пожалуйста, следуйте инструкциям в следующем разделе.
$ git clone " https://github.com/caddyserver/caddy.git "
$ cd caddy/cmd/caddy/
$ go build
Когда вы запускаете Caddy, он может попытаться привязать к низким портам, если иное не указано в вашей конфигурации. Если для вашей ОС требуется повышенные привилегии для этого, вам нужно будет дать новое бинарное разрешение для этого. На Linux это можно легко сделать с помощью: sudo setcap cap_net_bind_service=+ep ./caddy
Если вы предпочитаете использовать go run
, что создает только временные двоичные файлы, вы все равно можете сделать это с включенным setcap.sh
как так:
$ go run -exec ./setcap.sh main.go
Если вы не хотите печатать свой пароль для setcap
, используйте sudo visudo
, чтобы редактировать свой файл Sudoers и разрешить вашей учетной записи пользователя запустить эту команду без пароля, например:
username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap
Замена username
вашим настоящим именем пользователя. Пожалуйста, будьте осторожны и сделайте это, только если знаете, что делаете! Мы только квалифицированы, чтобы документировать, как использовать Caddy, а не go, или ваш компьютер, и мы предоставляем эти инструкции только для удобства; Пожалуйста, узнайте, как использовать свой собственный компьютер на свой собственный риск и внесите какие -либо необходимые корректировки.
Используя наш инструмент строительства, xcaddy
...
$ xcaddy build
... Следующие шаги автоматизированы:
mkdir caddy
cd caddy
go mod init caddy
go get github.com/caddyserver/caddy/v2@version
Заменить version
на тег GIT, коммит или имя филиала._ "import/path/here"
go build -tags=nobadger,nomysql,nopgx
На веб-сайте Caddy есть документация, которая включает в себя учебные пособия, быстрые руководства, ссылки и многое другое.
Мы рекомендуем всем пользователям - независимо от уровня опыта - наше руководство по началу, чтобы познакомиться с использованием Caddy.
Если у вас есть только минута, на веб-сайте есть несколько учебных пособий на выбор! Однако после окончания учебного пособия, пожалуйста, прочитайте больше документации, чтобы понять, как работает программное обеспечение. ?
Caddy чаще всего используется в качестве сервера HTTPS, но он подходит для любой продолжительной программы GO. Прежде всего, это платформа для запуска приложений GO. Caddy «приложения» - это просто программы GO, которые реализованы в качестве модулей Caddy. Два приложения - tls
и http
- Ship Standard с Caddy.
Приложения Caddy мгновенно выигрывают от автоматизированной документации, изящных онлайн-изменений конфигурации через API и объединение с другими приложениями Caddy.
Хотя JSON является нативным языком конфигурации Caddy, Caddy может принять ввод от конфигурационных адаптеров, который может по существу преобразовать любой формат конфигурации по вашему выбору в JSON: CaddyFile, JSON 5, YAML, TOML, NGINX COUNT и многое другое.
Основным способом настройки Caddy является его API, но если вы предпочитаете файлы конфигурации, интерфейс командной строки также поддерживает их.
Caddy выявляет беспрецедентный уровень контроля по сравнению с любым существующим веб -сервером. В Caddy вы обычно устанавливаете фактические значения инициализированных типов в памяти, которые питают все, от ваших управляющих HTTP и рукопожатия TLS до вашей среды для хранения. Caddy также смехотворно расширяется, с мощной системой плагинов, которая вносит огромные улучшения по сравнению с другими веб -серверами.
Чтобы обладать мощностью этого дизайна, вам нужно знать, как структурирован конфигурационный документ. Пожалуйста, смотрите наш сайт документации для получения подробной информации о структуре конфигурации Caddy.
Почти вся конфигурация Caddy содержится в одном документе конфигурации, а не разбросана по флагам CLI и переменных ENV, а также в файле конфигурации, как с другими веб -серверами. Это делает управление конфигурацией вашего сервера более простым и уменьшает скрытые переменные/факторы.
Наш веб -сайт имеет полную документацию:
https://caddyserver.com/docs/
Документы также открыты. Вы можете внести свой вклад в них здесь: https://github.com/caddyserver/website
Мы консультируем компании, использующие Caddy для заключения договора поддержки через Ardan Labs до того, как потребуется помощь.
Спонсорство проходит долгий путь! Мы можем предложить частную помощь спонсорам. Если Caddy приносит пользу вашей компании, рассмотрите возможность спонсорства. Это не только помогает финансировать работу на полную ставку для обеспечения долговечности проекта, но и предоставляет вашей компании ресурсы, поддержку и скидки, которые вам нужны; Наряду с отличным взглядом для вашей компании для ваших клиентов и потенциальных клиентов!
Люди могут бесплатно обменять помощь на нашем сообществе по адресу https://caddy.community. Помните, что люди оказывают помощь из свободного времени и хорошей воли. Лучший способ получить помощь - это дать это первым!
Пожалуйста, используйте наш трекер выпуска только для отчетов об ошибках и запросах функций, то есть элементов действенных действий (вопросы поддержки обычно упоминаются на форумах).
Мэтью Холт начал разрабатывать Caddy в 2014 году, изучая компьютерные науки в университете Бригам Янг. (Имя «Caddy» было выбрано потому, что это программное обеспечение помогает с утомительными, обычными задачами обслуживания в Интернете, а также является единственным местом для нескольких вещей, которые будут организованы вместе.) Вскоре он стал первым веб -сервером, который автоматически использует HTTPS и и по умолчанию, и теперь имеет сотни участников и обслуживал триллионы запросов HTTPS.
Название «Caddy» является торговой маркой. Имя программного обеспечения - «Caddy», а не «Caddy Server» или «Caddyserver». Пожалуйста, назовите это «Caddy» или, если вы хотите уточнить, «Caddy Web Server». Caddy является зарегистрированным товарным знаком Stack Holdings GmbH.
Caddy - это проект Zerossl, компании Stack Holdings.
Хистинг репозитория Debian в пакете любезно предоставлен Cloudsmith. Cloudsmith является единственным полностью размещенным, облачным, универсальным решением по управлению пакетами, которое позволяет вашей организации создавать, хранить и делиться пакетами в любом формате, в любом месте, с полной уверенностью.