File .htaccess là file cấu hình riêng của Apache và LiteSpeed, đặt trong từng thư mục và áp dụng cho thư mục đó cùng các thư mục con. Với WordPress, file cấu hình .htaccess mặc định chỉ làm một việc chính: chuyển các đường dẫn đẹp về index.php để WordPress tự định tuyến.

Bài này dùng đúng 3 mẫu chuẩn từ tài liệu WordPress: WordPress thường, Multisite subfolder và Multisite subdomain. Kèm theo là cách sửa file trên cPanel, DirectAdmin và vài lỗi thường gặp.

Bạn chỉ cần copy đúng mẫu, không cần hiểu hết từng dòng mới dùng được. Phần giải thích bên dưới giúp bạn biết dòng nào làm gì để sửa đúng chỗ khi cần.

1. .htaccess là gì?

Khi Apache nhận một request, nó đọc file .htaccess trong thư mục được yêu cầu trước khi phục vụ nội dung. Nhờ đó bạn đổi được hành vi của server mà không cần sửa file cấu hình chính hay khởi động lại Apache.

Một lưu ý quan trọng: chỉ Apache và LiteSpeed đọc .htaccess. Nginx không dùng file này, nên nếu site chạy nginx thuần thì đoạn mã trong bài không có tác dụng.

File này có hiệu lực theo thư mục: đặt ở thư mục gốc thì áp cho toàn site, đặt trong thư mục con thì chỉ áp cho thư mục đó. WordPress chỉ dùng file ở thư mục gốc.

2. Cấu hình .htaccess mặc định trên WordPress

WordPress tự sinh đoạn mã cấu hình .htaccess này khi bạn lưu Permalink lần đầu. File nằm ở thư mục gốc của site, cùng cấp với wp-config.php. Nếu file chưa có hoặc server không ghi được, WordPress sẽ hiện mã để bạn copy tay.

# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
  • RewriteEngine On: bật module viết lại URL.
  • RewriteRule .* - [E=HTTP_AUTHORIZATION:...]: giữ lại header Authorization cho REST API và các ứng dụng xác thực.
  • RewriteBase /: đường dẫn gốc tính từ thư mục cài WordPress. Site nằm trong thư mục con thì đổi thành /thumuc/.
  • RewriteRule ^index\.php$ - [L]: request thẳng tới index.php thì giữ nguyên, không viết lại nữa.
  • RewriteCond %{REQUEST_FILENAME} !-f và !-d: chỉ viết lại khi request không phải file thật và không phải thư mục thật.
  • RewriteRule . /index.php [L]: mọi request còn lại đều đưa về index.php để WordPress định tuyến theo permalink.

Khi cấu hình .htaccess, chỉ sửa ngoài cặp marker # BEGIN WordPress và # END WordPress. Mỗi lần lưu Permalink, WordPress ghi đè toàn bộ nội dung giữa hai marker này, mọi đoạn mã tự thêm vào giữa sẽ mất.

3. Multisite: 2 mẫu mặc định khác

Multisite dùng mẫu cấu hình .htaccess riêng tùy theo kiểu mạng. Chọn đúng một mẫu dưới đây, đừng trộn hai mẫu với nhau.

Multisite subfolder

Dùng khi site con có dạng domain.com/site1.

# BEGIN WordPress Multisite
# Using subfolder network type: https://wordpress.org/documentation/article/htaccess/#multisite

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]

# uploaded files
RewriteRule ^([_0-9a-zA-Z-]+/)?files/(.+) wp-includes/ms-files.php?file=$2 [L]

# add a trailing slash to /wp-admin
RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]

RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
RewriteRule ^[_0-9a-zA-Z-]+/(wp-(content|admin|includes).*) $1 [L]
RewriteRule ^[_0-9a-zA-Z-]+/(.*\.php)$ $1 [L]
RewriteRule . index.php [L]

# END WordPress Multisite

Multisite subdomain

Dùng khi site con có dạng site1.domain.com.

# BEGIN WordPress Multisite
# Using subdomain network type: https://wordpress.org/documentation/article/htaccess/#multisite

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]

# uploaded files
RewriteRule ^files/(.+) wp-includes/ms-files.php?file=$1 [L]

RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
RewriteRule . index.php [L]

# END WordPress Multisite

4. Cách sửa file cấu hình .htaccess trên cPanel và DirectAdmin

File .htaccess là file ẩn nên trình quản lý file mặc định không hiện nó. Khi cấu hình .htaccess, bật hiện file ẩn trước rồi mới sửa. Nếu chưa biết mở file ở đâu, xem thêm 4 cách mở và sửa file .htaccess trên hosting và VPS.

  1. cPanel: mở File Manager, bấm Settings ở góc phải, tick Show Hidden Files (dotfiles), mở thư mục public_html, chuột phải file .htaccess rồi Edit.
  2. DirectAdmin: mở File Manager, vào thư mục public_html (hoặc thư mục chứa site), bấm Edit ở file .htaccess.
  3. Dán đúng mẫu cấu hình .htaccess ở trên, Save rồi tải lại site để kiểm tra.
Mở File Manager trên cPanel để sửa file cấu hình .htaccess
File Manager trên cPanel, nhớ bật Show Hidden Files để thấy file .htaccess.
Mở File Manager trên DirectAdmin để sửa file cấu hình .htaccess
File Manager trên DirectAdmin, file .htaccess nằm trong thư mục chứa site.

5. Xử lý lỗi thường gặp

  • Lỗi 500 sau khi cấu hình .htaccess: thường do sai cú pháp. Đổi tên file thành .htaccess.bak để site chạy lại ngay, rồi soát lại từng dòng vừa thêm.
  • Mất đường dẫn đẹp: lưu lại Permalink trong wp-admin để WordPress tái tạo đoạn mã mặc định.
  • Quên sao lưu trước khi sửa: luôn copy file gốc thành .htaccess.bak trước khi thay đổi để có đường lui.
  • Dùng nginx mà vẫn lỗi 404: nginx không đọc .htaccess, thêm đoạn sau vào block location / trong cấu hình nginx.
location / {
    try_files $uri $uri/ /index.php?$args;
}

Câu hỏi thường gặp

WordPress có tự tạo file .htaccess không?

Có, khi bạn lưu Permalink lần đầu và thư mục gốc ghi được. Nếu không ghi được, WordPress hiện đoạn mã cấu hình .htaccess để bạn tự tạo file và dán vào.

Sửa .htaccess bị lỗi 500 thì khôi phục ra sao?

Đổi tên file thành .htaccess.bak qua File Manager hoặc SSH, site sẽ chạy lại ngay vì Apache không còn đọc file lỗi. Sau đó mở file .bak ra soát cú pháp rồi đổi tên lại.

Thêm mã tùy chỉnh vào đâu để WordPress không ghi đè?

Khi cấu hình .htaccess, thêm ngoài cặp marker # BEGIN WordPress và # END WordPress. Mọi thứ nằm giữa hai marker này đều bị ghi đè mỗi lần lưu Permalink.

Kết luận

Nắm đúng 3 mẫu cấu hình .htaccess trên là đủ cho hầu hết site WordPress. Khi cần thêm tính năng như chặn truy cập hay chuyển hướng, hãy thêm ngoài cặp marker và sao lưu file trước khi sửa. Xem thêm cách bảo mật WordPress bằng .htaccess.

Nguồn tham khảo

4.8/5 - (80 bình chọn)
Bài viết đã được kiểm duyệt bởi Đỗ Trung Quân
5 tháng 11, 2026
Đỗ Trung Quân
Đỗ Trung Quân
CÔNG TÁC TẠI AZDIGI

Với kinh nghiệm thực chiến từ việc tiếp xúc hàng ngày với vô vàn vấn đề về Website, Hosting, VPS, Server tại Phòng Kỹ thuật AZDIGI, mình luôn ấp ủ niềm đam mê chia sẻ kiến thức.

Mình xây dựng các blog không chỉ để tự trau dồi kỹ năng mà còn để cung cấp những tài liệu, hướng dẫn hữu ích nhất đến cộng đồng. Rất mong nhận được sự quan tâm của các bạn!

Đăng ký tư vấn miễn phí

Để lại thông tin, mình sẽ phản hồi ngay.

2 comments

KHang Phan

làm sao để chuyển tên miền cũ sang tên miền mới không mất google ạ

Trả lời 16 thg 4, 2023
ĐỖ TRUNG QUÂN Quản trị viên

Bạn tham khảo hướng dẫn sau để cấu hình nhé

Trả lời 16 thg 4, 2023

Để lại một bình luận