Jak uruchomić Caddy jako serwer WWW w systemie Windows Server

Aby uruchomić Caddy w systemie Windows Server, zainstaluj jego natywny plik wykonywalny, wskaż folder swojej witryny za pomocą pliku Caddyfile i zarejestruj Caddy jako usługę systemu Windows. Ta konfiguracja obsługuje pliki statyczne i umożliwia automatyczne uzyskiwanie i odnawianie certyfikatów HTTPS dla domeny publicznej. Docker jest opcjonalny; poniższe kroki nie wymagają środowiska uruchomieniowego kontenera.

Polecenia używają C:\Caddydomeny zastępczej. Uruchom program PowerShell jako administrator podczas tworzenia reguł zapory lub instalowania usługi.

1. Pobierz Caddy dla systemu Windows

Otwórz oficjalną stronę pobierania Caddy i wybierz kompilację systemu Windows dla architektury swojego serwera. Jeśli korzystasz z wersji GitHub, wybierz pasujący zasób systemu Windows. Wypakuj lub skopiuj caddy.exedo pliku C:\Caddy. Instrukcja instalacji Caddy opisuje również statyczne pliki binarne i weryfikację podpisów.

2. Utwórz folder witryny internetowej

W programie PowerShell utwórz katalog główny dokumentu i małą stronę testową. Gdy będziesz gotowy, zastąp ten plik testowy plikami swojej witryny:

New-Item -ItemType Directory -Force C:\Caddy\site | Out-Null
Set-Content -Path C:\Caddy\site\index.html -Value '<h1>Hello from Caddy</h1>' -Encoding utf8

3. Utwórz lokalny plik Caddyfile

Otwórz Notatnik za pomocą notepad C:\Caddy\Caddyfile. Jeśli pojawi się monit o utworzenie pliku, wybierz Tak. Wprowadź tę konfigurację, a następnie zapisz ją Caddyfilebez .txtrozszerzenia:

:8080 {
    root * C:/Caddy/site
    file_server
}

Dyrektywa rootustawia katalog i file_serverudostępnia jego pliki. Wysoki port lokalny ułatwia testowanie przed przełączeniem na publiczne porty HTTP i HTTPS. Zobacz oficjalne referencje dotyczące roota i serwera plików .

4. Sprawdź i przetestuj witrynę

W programie PowerShell przejdź do folderu Caddy, sprawdź poprawność konfiguracji i uruchom Caddy na pierwszym planie:

Set-Location C:\Caddy
.\caddy.exe validate --config .\Caddyfile
.\caddy.exe run --config .\Caddyfile

Gdy to okno pozostaje otwarte, przejdź do http://localhost:8080serwera. Powinieneś zobaczyć nagłówek testu. To lokalne sprawdzenie celowo wykorzystuje protokół HTTP; zatrzymaj proces na pierwszym planie za pomocą Ctrl+Cprzed zmianą pliku dla swojej domeny publicznej.

5. Skonfiguruj swoją prawdziwą domenę

Edytuj C:\Caddy\Caddyfilei zastąp konfigurację testu własną domeną i katalogiem głównym dokumentu:

www.example.com {
    root * C:/Caddy/site
    file_server
}

Zastąp www.example.comdomeną, którą kontrolujesz. Dzięki nazwie hosta w adresie witryny, Caddy może zarządzać publicznymi certyfikatami TLS i przekierowywać HTTP na HTTPS. Automatyczne wydawanie wymaga, aby nazwa hosta została przetłumaczona na ten serwer i aby dotarł do niego odpowiedni ruch wywoławczy. Przed uruchomieniem zapoznaj się z wymaganiami Caddy dotyczącymi automatycznego protokołu HTTPS .

6. Zezwól na publiczny ruch sieciowy

Utwórz rekordy DNS A i AAAA, jeśli Twój serwer obsługuje IPv6, które kierują Twoją domenę na publiczny adres serwera. W oknie programu PowerShell z podwyższonym poziomem uprawnień dodaj regułę przychodzącą Zapory systemu Windows dla portów TCP 80 i 443:

New-NetFirewallRule -DisplayName "Caddy HTTP and HTTPS" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 80,443

Zezwól również na te porty przez dowolną zaporę sieciową w chmurze, router lub grupę zabezpieczeń sieci przed serwerem. Caddy używa portu 80 do obsługi HTTP i wspólnej walidacji ACME, a portu 443 do HTTPS. UDP 443 jest opcjonalny dla HTTP/3. Microsoft dokumentuje polecenie cmdlet New-NetFirewallRule .

7. Uruchom Caddy jako usługę systemu Windows

Zachowaj konfigurację domeny, a następnie otwórz okno programu PowerShell z podwyższonym poziomem uprawnień. Oficjalny przewodnik po usługach Caddy obsługuje sc.exeWinSW. Aby uzyskać bezpośrednią usługę, zarejestruj plik wykonywalny z jawną ścieżką konfiguracji i uruchom go:

sc.exe create caddy start= auto binPath= '"C:\Caddy\caddy.exe" run --config C:\Caddy\Caddyfile'
sc.exe start caddy

Usługi systemu Windows działają na koncie usługi. Upewnij się, że konto to może odczytywać pliki witryny i konfiguracji oraz zapisywać dane w trwałym katalogu danych Caddy, który przechowuje zarządzane certyfikaty. Nie traktuj tego katalogu jako jednorazowego; zapoznaj się z konwencjami katalogowymi Caddy i instrukcjami dotyczącymi usług systemu Windows .

8. Zweryfikuj protokół HTTPS i rozwiąż problemy

Sprawdź stan usługi za pomocą sc.exe query caddy, a następnie otwórz ją, https://www.example.comużywając swojej rzeczywistej nazwy hosta. Jeśli witryna się nie ładuje, sprawdź rekordy DNS, zapory systemu Windows i sieci oraz czy inny program nie ma już portów 80 lub 443. Możesz sprawdzić nasłuchiwacze za pomocą:

Get-NetTCPConnection -State Listen -LocalPort 80,443

Jeśli Caddy zgłosi błąd certyfikatu lub wyzwanie, sprawdź, czy publiczny DNS wskazuje na ten serwer i czy przychodzące pakiety TCP 80 i 443 do niego docierają. W przypadku zmian w konfiguracji ponownie sprawdź poprawność pliku, a następnie ponownie załaduj Caddy za pomocą C:\Caddy\caddy.exe reload --config C:\Caddy\Caddyfile. Podręcznik wprowadzający i poradnik rozwiązywania problemów z Caddy obejmują dodatkowe konfiguracje i błędy.