Hosting stron statycznych w S3
Wprowadzenie
Każdy bucket S3 może służyć jako hosting statycznej strony WWW (HTML, CSS, JavaScript, obrazy) dostępnej publicznie po HTTPS. Nie potrzebny jest serwer WWW — wystarczy wgrać pliki i włączyć tryb website na buckecie.
Wykorzystywane są dwa adresy:
Adres |
Do czego służy |
|---|---|
|
API S3: tworzenie bucketa, wgrywanie plików, konfiguracja (AWS CLI, SDK, rclone) |
|
Adres strony dla odwiedzających |
Przykład: bucket „moja-strona” będzie dostępny pod https://moja-strona.s3-2website.atman.pl/.
Nazwa bucketa jest częścią adresu, więc musi spełniać zasady nazw DNS: tylko małe litery, cyfry i myślniki, bez kropek (kropki psują certyfikat HTTPS).
Hosting obsługuje wyłącznie treści statyczne. Kod po stronie serwera (PHP, Python, bazy danych) nie będzie wykonywany.
Uruchomienie strony krok po kroku
Przykłady używają AWS CLI z profilem użytkownika, który ma uprawnienia do bucketa. Należy ustawić zmienne:
export AWS_PROFILE=moj-profil
export EP=https://s3-2.atman.pl
export BUCKET=moja-strona
1. Tworzenie bucket-u
aws --endpoint-url $EP s3 mb s3://$BUCKET
2. Wgranie plików strony
Katalog ./public powinien zawierać co najmniej index.html (strona główna) i opcjonalnie error.html (strona błędu 404).
Do testu wystarczą dwa proste pliki:
public/index.html
<!doctype html>
<html lang="pl">
<head>
<meta charset="utf-8">
<title>Moja strona</title>
</head>
<body>
<h1>Strona działa!</h1>
<p>Ta strona jest serwowana z bucketa S3.</p>
</body>
</html>
public/error.html
<!doctype html>
<html lang="pl">
<head>
<meta charset="utf-8">
<title>404</title>
</head>
<body>
<h1>404 – Nie znaleziono strony</h1>
<p><a href="/">Wróć na stronę główną</a></p>
</body>
</html>
aws --endpoint-url $EP s3 sync ./public s3://$BUCKET/ --delete
--delete
usuwa z bucketa pliki, których nie ma już lokalnie — bucket jest wtedy wierną kopią katalogu.
3. Włączenie trybu website
aws --endpoint-url $EP s3 website s3://$BUCKET/ \
--index-document index.html \
--error-document error.html
Sprawdzenie konfiguracji:
aws --endpoint-url $EP s3api get-bucket-website --bucket $BUCKET
4. Udostępnienie plików publicznie
Odwiedzający nie mają kluczy S3, więc bucket musi pozwalać na anonimowy odczyt. Należy zapisać politykę jako public-read.json (podmienić nazwę bucketa):
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "PublicReadForWebsite",
"Effect": "Allow",
"Principal": "*",
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::moja-strona/*"
}
]
}
aws --endpoint-url $EP s3api put-bucket-policy --bucket $BUCKET --policy file://public-read.jsonaws --endpoint-url $EP s3api put-bucket-policy --bucket $BUCKET --policy file://public-read.json
Polityka pozwala tylko na pobieranie plików — odwiedzający nie mogą listować zawartości bucketa ani niczego zmieniać. Jeśli na koncie włączona jest blokada dostępu publicznego (Public Access Block), polecenie zwróci AccessDenied — wtedy należy wyłączyć ją dla tego bucketa lub skontaktować się z nami.
5. Sprawdzenie działania
Należy otworzyć w przeglądarce https://moja-strona.s3-2website.atman.pl/ albo sprawdzić z terminala:
curl -I https://moja-strona.s3-2website.atman.pl/
Odpowiedź HTTP/2 200 oznacza, że strona działa.
Aktualizacja treści
Aby opublikować nową wersję strony, należy ponownie uruchomić sync — wgrane zostaną tylko zmienione pliki:
aws --endpoint-url $EP s3 sync ./public s3://$BUCKET/ --delete
Typy plików (Content-Type)
Przeglądarka wyświetla plik poprawnie tylko wtedy, gdy ma właściwy nagłówek Content-Type. AWS CLI ustawia go automatycznie na podstawie rozszerzenia. Jeśli pliki wgrywane są innym narzędziem i strona pobiera się jako plik zamiast się wyświetlić, należy ustawić typ ręcznie:
aws --endpoint-url $EP s3 cp ./public/index.html s3://$BUCKET/index.html --content-type "text/html; charset=utf-8"
Wyłączenie strony i najczęstsze błędy
Wyłączenie strony
Wyłączenie trybu website i cofnięcie publicznego dostępu (pliki zostają w buckecie):
aws --endpoint-url $EP s3api delete-bucket-website --bucket $BUCKET
aws --endpoint-url $EP s3api delete-bucket-policy --bucket $BUCKET
aws --endpoint-url $EP s3api delete-bucket-policy --bucket $BUCKET
Całkowite usunięcie bucketa razem z zawartością:
aws --endpoint-url $EP s3 rb s3://$BUCKET --force
Najczęstsze błędy
Objaw |
Przyczyna i rozwiązanie |
|---|---|
|
Brak polityki publicznego odczytu (krok 4) lub błędna nazwa bucketa w |
|
Tryb website nie został włączony (krok 3) |
|
Brak pliku |
Strona otwiera listę plików XML zamiast HTML |
Użyto adresu API ( |
Przeglądarka pobiera plik zamiast go wyświetlić |
Błędny |
W razie problemów prosimy o kontakt z naszym wsparciem, podając nazwę bucketa, adres strony i wynik polecenia curl -I <adres>.