Co je soubor .htaccess
a k čemu ho použít

Začínáme

Jak soubor .htaccess vytvořit a kde ho umístit

Kde soubor musí ležet

Soubor .htaccess se musí nacházet ve složce, pro kterou chceš nastavení aplikovat. Platí pro daný adresář a všechny jeho podadresáře. Pokud ho umístíš do kořenového adresáře webu (tzv. document root, například /public_html/ nebo /www/), budou se jeho direktivy aplikovat na celý web.

Na jednom webu může existovat více souborů .htaccess najednou, každý v jiném adresáři. Pokud se direktivy překrývají, má vyšší prioritu soubor v bližším (vnořenějším) adresáři. Nastavení z podadresáře tedy přebije nastavení z nadřazeného adresáře.

Jak soubor vytvořit na Windows

Na Linuxu a macOS soubory začínající tečkou vytvoříš běžně přes terminál. Na Windows to komplikuje systémové omezení — systém předpokládá, že každý soubor musí mít příponu.

1. Otevři Poznámkový blok (nebo jiný textový editor).
2. Klikni na Soubor a vyber Uložit jako.
3. Do pole Název souboru zadej ".htaccess" včetně uvozovek.
   Uvozovky jsou nutné, jinak Windows přidá příponu .txt.
4. V poli Typ souboru vyber Všechny soubory.
5. Ulož.

Alternativně soubor vytvoříš v příkazovém řádku (cmd) příkazem: echo. > .htaccess

Jak soubor nahrát přes FTP

.htaccess je na Linuxu skrytý soubor — na FTP serveru ho ve výchozím stavu nevidíš. Zobrazíš ho v nastavení svého FTP klienta: v programu FileZilla jde o menu Server a volbu Vynutit zobrazení skrytých souborů. V Total Commanderu použij menu Síť a volbu FTP – ukázat skryté soubory.

Po úpravě soubor nahraj na server standardním způsobem. Změny se projevují okamžitě, bez restartu serveru.

Příklady ke zkopírování

Nejčastější použití .htaccess

Každý příklad níže je funkční blok kódu, který můžeš zkopírovat a upravit pro svou doménu. U každého je vysvětleno, co přesně kód dělá a na co si dát pozor.

Přesměrování na HTTPS

Vynucení HTTPS přesměruje všechny požadavky na HTTP verzi webu automaticky na HTTPS. Jde o základní nastavení každého webu, který má platný SSL certifikát. Bez tohoto pravidla je web přístupný na obou verzích, což má dopad na přesměrování a indexaci.

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

Přesměrování www na verzi bez www (a obráceně)

Verzi domény sjednoť na jednu variantu. Mít web přístupný na obou adresách zároveň vytváří riziko duplicitního obsahu. Trvalé přesměrování 301 zajistí, že Google obě varianty sloučí do jedné a hodnocení stránek se nepřerozdělí.

Přesměrování z www na bez www:

RewriteEngine On
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [R=301,L]

Přesměrování z bez www na www:

RewriteEngine On
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteRule ^(.*)$ https://www.%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

Přesměrování konkrétní staré URL na novou

Když přesouváš stránku na novou adresu, přidej trvalé přesměrování, aby Google přenesl hodnocení ze staré URL na novou a návštěvníci se neztratili.

Redirect 301 /stara-stranka/ https://www.example.com/nova-stranka/

Pokud přesměrováváš celou složku na novou cestu, použij:

RedirectMatch 301 ^/stary-adresar/(.*)$ https://www.example.com/novy-adresar/$1

Vlastní chybové stránky

Místo výchozích serverových chybových hlášení zobraz vlastní stránku, která udrží uživatele na webu a vysvětlí situaci v jazyce a designu tvého webu.

ErrorDocument 404 /stranka-nenalezena.html
ErrorDocument 500 /chyba-serveru.html
ErrorDocument 403 /pristup-odepren.html

Zakázání výpisu adresářů

Pokud adresář neobsahuje výchozí soubor (index.html nebo index.php), Apache ve výchozím nastavení zobrazí seznam souborů. To je bezpečnostní riziko — návštěvník vidí strukturu souborů na serveru. Zakáže ho jediná direktiva:

Options -Indexes

Nastavení výchozího souboru adresáře

Direktiva DirectoryIndex určuje, který soubor server otevře při přístupu na adresář. Server prochází soubory v pořadí, v jakém jsou uvedeny, a otevře první, který najde.

DirectoryIndex index.php index.html

Bezpečnost

.htaccess a zabezpečení webu

.htaccess umožňuje nastavit základní bezpečnostní pravidla bez zásahu do kódu aplikace. Tři oblasti mají největší praktický dopad: ochrana citlivých souborů, řízení přístupu podle IP adresy a ochrana adresáře heslem.

Blokování přístupu k citlivým souborům

Soubory jako .env, wp-config.php nebo .htpasswd obsahují databázové přihlašovací údaje a API klíče. Pokud jsou dostupné přes URL, jde o závažné bezpečnostní riziko.

# Apache 2.4 a novější (aktuální standard)
<FilesMatch "^\.env|wp-config\.php|\.htpasswd|composer\.json|composer\.lock">
  Require all denied
</FilesMatch>

Omezení přístupu podle IP adresy

Pro zpřístupnění části webu jen svému týmu nebo konkrétním IP adresám použij řízení přístupu na úrovni adresáře. Typické využití: staging prostředí, adminský panel, interní nástroje.

Povolení přístupu pouze pro konkrétní IP (Apache 2.4):

Require ip 192.168.1.100
Require ip 10.0.0.0/8

Zablokování konkrétní IP:

<RequireAll>
  Require all granted
  Require not ip 203.0.113.45
</RequireAll>

Ochrana adresáře heslem (.htpasswd)

Pro ochranu adresáře přihlašovacím jménem a heslem potřebuješ dva soubory: .htaccess v chráněném adresáři a .htpasswd se záznamy uživatelů.

AuthType Basic
AuthName "Chranena oblast"
AuthUserFile /absolutni/cesta/k/.htpasswd
Require valid-user

Debugging

Řešení chyb — co dělat, když .htaccess nefunguje

Chyba 500 Internal Server Error

Chyba 500 po uložení .htaccess téměř vždy znamená syntaktickou chybu v souboru nebo pokus o použití direktivy, která není na serveru povolena.

Postup krok za krokem:

1. Otevri error log serveru.
   Na sdilenem hostingu: ovladaci panel (cPanel, Plesk)
   sekce Chybove zaznamy nebo Logy.
   Na VPS: /var/log/apache2/error.log
   nebo /var/log/httpd/error.log

2. Najdi radek s casovym razitkem odpovidajicim
   dobe chyby. Chybova zprava uvede bud cislo radku,
   nebo nazev nepovolene direktivy.

3. Oprav nebo odstraň problemicky radek.

4. Bez pristupu k error logu: pridavej direktivy
   po jedne a po kazdem pridani over, ze web funguje.

Přesměrování nefunguje

Pokud pravidlo RewriteRule nefunguje, zkontroluj v tomto pořadí:

Nekonečná smyčka přesměrování (ERR_TOO_MANY_REDIRECTS)

Chyba ERR_TOO_MANY_REDIRECTS znamená, že pravidlo přesměrování odkazuje samo na sebe nebo na jiné pravidlo, které zpátky odkazuje na něj. Nejčastější příčiny: kombinace pravidel www a HTTPS bez správných podmínek RewriteCond, nebo chybějící podmínka %{HTTPS} off.

Řešení: Vymaž obsah .htaccess — web se zobrazí bez přesměrování. Pak přidávej pravidla jedno po druhém a po každém přidání ověř funkčnost v anonymním okně prohlížeče, aby ses vyhnul starým přesměrováním uloženým v cache.

Soubor se ignoruje

Pokud Apache .htaccess zcela ignoruje, nejpravděpodobnější příčina je AllowOverride None v hlavní konfiguraci serveru. Toto nastavení zakáže .htaccess globálně. Vyřeší to správce serveru nebo poskytovatel hostingu — na sdíleném hostingu je AllowOverride All obvykle výchozí nastavení.

Test funkčnosti: Přidej do souboru záměrně neplatnou direktivu (např. slovo „test“ na prázdný řádek). Pokud se zobrazí chyba 500, .htaccess funguje. Pokud se stránka zobrazí normálně, .htaccess je ignorován. Po testu neplatný řádek odstraň.