caddyserver/caddySchneller und erweiterbarer Multiplattform-HTTP/1-2-3-Webserver mit automatischem HTTPS
ProjektCaddy ist eine erweiterbare Serverplattform, die standardmäßig TLS verwendet.
Veröffentlichungen · Dokumentation · Hilfe erhalten
Unterstützt von
Der einfachste, plattformübergreifende Weg zum Einstieg ist, Caddy von den GitHub-Releases herunterzuladen und die ausführbare Datei in Ihren PATH zu legen.
Siehe unsere Online-Dokumentation für andere Installationsanweisungen.
Anforderungen:
Hinweis: Diese Schritte werden keine korrekten Versionsinformationen einbetten. Befolgen Sie dazu bitte die Anweisungen im nächsten Abschnitt.
$ git clone "https://github.com/caddyserver/caddy.git"
$ cd caddy/cmd/caddy/
$ go build
Wenn Sie Caddy ausführen, wird es möglicherweise versuchen, sich an niedrige Ports zu binden, sofern in Ihrer Konfiguration nichts anderes angegeben ist. Wenn Ihr Betriebssystem dafür erhöhte Rechte benötigt, müssen Sie Ihrem neuen Binärprogramm die entsprechende Berechtigung erteilen. Unter Linux kann dies einfach mit: sudo setcap cap_net_bind_service=+ep ./caddy erfolgen.
Wenn Sie go run bevorzugen, das nur temporäre Binärdateien erstellt, können Sie dies dennoch mit der enthaltenen setcap.sh wie folgt tun:
$ go run -exec ./setcap.sh main.go
Wenn Sie Ihr Passwort für setcap nicht eingeben möchten, verwenden Sie sudo visudo, um Ihre sudoers-Datei zu bearbeiten und Ihrem Benutzerkonto zu erlauben, diesen Befehl ohne Passwort auszuführen, zum Beispiel:
username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap
Ersetzen Sie username durch Ihren tatsächlichen Benutzernamen. Bitte seien Sie vorsichtig und tun Sie dies nur, wenn Sie wissen, was Sie tun! Wir sind nur qualifiziert, die Verwendung von Caddy zu dokumentieren, nicht die Go-Werkzeuge oder Ihren Computer, und wir stellen diese Anweisungen nur aus Bequemlichkeit zur Verfügung; bitte lernen Sie, Ihren eigenen Computer auf eigene Gefahr zu verwenden und nehmen Sie alle notwendigen Anpassungen vor.
Dann können Sie die Tests in allen Modulen oder einem bestimmten ausführen:
$ go test ./...
$ go test ./modules/caddyhttp/tracing/
Mit unserem Builder-Tool, xcaddy...
$ xcaddy build
...die folgenden Schritte werden automatisiert:
mkdir caddycd caddygo mod init caddygo get github.com/caddyserver/caddy/v2@version und ersetzen Sie version durch einen Git-Tag, Commit- oder Branchnamen._ "import/path/here"go build -tags=nobadger,nomysql,nopgxDie Caddy-Website enthält Dokumentation mit Tutorials, Schnellstartanleitungen, Referenz und mehr.
Wir empfehlen allen Benutzern – unabhängig von ihrem Erfahrungsgrad – unseren Erste-Schritte-Leitfaden zu absolvieren, um sich mit der Verwendung von Caddy vertraut zu machen.
Wenn Sie nur eine Minute Zeit haben, die Website bietet mehrere Schnellstart-Tutorials zur Auswahl! Nach Abschluss eines Schnellstart-Tutorials lesen Sie bitte weitere Dokumentation, um zu verstehen, wie die Software funktioniert. 🙂
Caddy wird am häufigsten als HTTPS-Server verwendet, eignet sich aber für jedes langlebige Go-Programm. In erster Linie ist es eine Plattform zum Ausführen von Go-Anwendungen. Caddy-„Apps“ sind einfach Go-Programme, die als Caddy-Module implementiert sind. Zwei Apps – tls und http – werden standardmäßig mit Caddy ausgeliefert.
Caddy-Apps profitieren sofort von automatisierter Dokumentation, eleganten Online-Konfigurationsänderungen über die API und der Vereinheitlichung mit anderen Caddy-Apps.
Obwohl JSON Caddys native Konfigurationssprache ist, kann Caddy Eingaben von Konfigurationsadaptern akzeptieren, die im Wesentlichen jedes beliebige Konfigurationsformat in JSON konvertieren können: Caddyfile, JSON 5, YAML, TOML, NGINX-Konfiguration und mehr.
Die primäre Methode zur Konfiguration von Caddy ist über seine API, aber wenn Sie Konfigurationsdateien bevorzugen, unterstützt die Befehlszeilenschnittstelle diese ebenfalls.
Caddy bietet ein beispielloses Maß an Kontrolle im Vergleich zu jedem existierenden Webserver. In Caddy legen Sie in der Regel die tatsächlichen Werte der initialisierten Typen im Speicher fest, die alles von Ihren HTTP-Handlern und TLS-Handshakes bis hin zu Ihrem Speichermedium antreiben. Caddy ist zudem unglaublich erweiterbar, mit einem leistungsstarken Plugin-System, das enorme Verbesserungen gegenüber anderen Webservern bietet.
Um die Macht dieses Designs zu nutzen, müssen Sie wissen, wie das Konfigurationsdokument strukturiert ist. Bitte besuchen Sie unsere Dokumentationsseite für Details zur Konfigurationsstruktur von Caddy.
Nahezu die gesamte Konfiguration von Caddy ist in einem einzigen Konfigurationsdokument enthalten, anstatt über CLI-Flags, Umgebungsvariablen und eine Konfigurationsdatei verteilt zu sein wie bei anderen Webservern. Dies macht die Verwaltung Ihrer Serverkonfiguration einfacher und reduziert versteckte Variablen/Faktoren.
Unsere Website enthält eine vollständige Dokumentation:
Die Dokumentation ist ebenfalls Open Source. Sie können hier dazu beitragen: https://github.com/caddyserver/website
Wir empfehlen Unternehmen, die Caddy verwenden, einen Supportvertrag über Ardan Labs abzuschließen, bevor Hilfe benötigt wird.
Ein Sponsoring hilft sehr! Wir können privaten Support für Sponsoren anbieten. Wenn Caddy Ihrem Unternehmen nützt, denken Sie bitte über ein Sponsoring nach. Dies hilft nicht nur, die Vollzeitarbeit zur Sicherstellung der Langlebigkeit des Projekts zu finanzieren, sondern bietet Ihrem Unternehmen auch die benötigten Ressourcen, Unterstützung und Rabatte; und es präsentiert Ihr Unternehmen gegenüber Ihren Kunden und potenziellen Kunden in einem guten Licht!
Einzelpersonen können kostenlos Hilfe in unserem Community-Forum unter https://caddy.community austauschen. Denken Sie daran, dass Menschen Hilfe in ihrer Freizeit und aus gutem Willen leisten. Der beste Weg, Hilfe zu bekommen, ist, sie zuerst zu geben!
Bitte verwenden Sie unseren Issue-Tracker nur für Fehlerberichte und Funktionsanfragen, d.h. umsetzbare Entwicklungsaufgaben (Support-Fragen werden in der Regel an die Foren verwiesen).
Matthew Holt begann 2014 mit der Entwicklung von Caddy, während er Informatik an der Brigham Young University studierte. (Der Name „Caddy“ wurde gewählt, weil diese Software bei den mühsamen, alltäglichen Aufgaben des Bereitstellens des Webs hilft und auch ein einziger Ort ist, an dem mehrere Dinge gemeinsam organisiert werden können.) Es wurde bald der erste Webserver, der HTTPS automatisch und standardmäßig verwendet, und hat jetzt Hunderte von Mitwirkenden und hat Billionen von HTTPS-Anfragen bedient.
Der Name „Caddy“ ist markenrechtlich geschützt. Der Name der Software ist „Caddy“, nicht „Caddy Server“ oder „CaddyServer“. Bitte nennen Sie es „Caddy“ oder, wenn Sie es klarstellen möchten, „den Caddy-Webserver“. Caddy ist eine eingetragene Marke der Stack Holdings GmbH.
Caddy ist ein Projekt von ZeroSSL, einem Unternehmen der HID Global.
Das Debian-Paketrepository-Hosting wird freundlicherweise von Cloudsmith bereitgestellt. Cloudsmith ist die einzige vollständig gehostete, cloud-native, universelle Paketverwaltungslösung, die es Ihrer Organisation ermöglicht, Pakete in jedem Format, an jeden Ort, mit voller Sicherheit zu erstellen, zu speichern und zu teilen.