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

https://s3-2.atman.pl

API S3: tworzenie bucketa, wgrywanie plików, konfiguracja (AWS CLI, SDK, rclone)

https://<nazwa-bucketa>.s3-2website.atman.pl/

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

403 Forbidden / AccessDenied na stronie

Brak polityki publicznego odczytu (krok 4) lub błędna nazwa bucketa w Resource

404 NoSuchWebsiteConfiguration

Tryb website nie został włączony (krok 3)

404 NoSuchKey dla strony głównej

Brak pliku index.html w głównym katalogu bucketa

Strona otwiera listę plików XML zamiast HTML

Użyto adresu API (s3-2.atman.pl) zamiast adresu website (<bucket>.s3-2website.atman.pl)

Przeglądarka pobiera plik zamiast go wyświetlić

Błędny Content-Type — wgraj plik ponownie z --content-type

W razie problemów prosimy o kontakt z naszym wsparciem, podając nazwę bucketa, adres strony i wynik polecenia curl -I <adres>.