linux .htaccess 设置 404 等错误页面

封面图 • 2025-10-26 • SEO技术

在 Linux 系统中，`.htaccess` 文件通常用于 Apache 服务器的配置。你可以通过 `.htaccess` 文件来设置自定义的错误页面，比如 404（未找到）错误页面。

---

## ✅ 设置 404 错误页面

### 1. 创建自定义的 404 页面
首先，你需要创建一个 HTML 文件，例如 `404.html`，并将其放在网站的根目录或指定的路径下：

```bash
sudo nano /var/www/html/404.html
```

内容示例：

```html
<!DOCTYPE html>
<html>
<head>
    <title>404 - 页面未找到</title>
</head>
<body>
    <h1>404 - 页面未找到</h1>
    <p>您请求的页面不存在，请检查 URL 是否正确。</p>
</body>
</html>
```

保存并退出编辑器。

---

### 2. 编辑 `.htaccess` 文件

在你的网站根目录（如 `/var/www/html/`）中创建或编辑 `.htaccess` 文件：

```bash
sudo nano /var/www/html/.htaccess
```

添加以下内容：

```apache
ErrorDocument 404 /404.html
```

这表示当发生 404 错误时，显示 `/404.html` 页面。

---

### 3. 可选：设置其他错误页面

你也可以为其他错误代码设置自定义页面，例如：

```apache
ErrorDocument 403 /403.html
ErrorDocument 500 /500.html
ErrorDocument 503 /503.html
```

确保这些文件也已经存在于你的网站根目录中。

---

## 🔧 注意事项

- **Apache 必须启用 `.htaccess`**  
  确保你的 Apache 配置允许使用 `.htaccess` 文件。检查你的 Apache 虚拟主机配置文件（如 `/etc/apache2/sites-available/000-default.conf` 或类似路径），确认有如下内容：

```apache
  <Directory /var/www/html>
      AllowOverride All
  </Directory>
  ```

如果是 `AllowOverride None`，请改为 `AllowOverride All`，然后重启 Apache：

```bash
  sudo systemctl restart apache2
  ```

- **权限问题**  
  确保 `.htaccess` 和自定义错误页面的文件权限正确，Apache 用户（通常是 `www-data`）可以读取它们：

```bash
  sudo chown -R www-data:www-data /var/www/html
  sudo chmod -R 755 /var/www/html
  ```

---

## 🧪 测试

访问一个不存在的页面，例如：

```
http://your-domain.com/nonexistent-page
```

你应该看到自定义的 404 页面。

---

如果你使用的是 Nginx 而不是 Apache，设置方式不同，我可以为你提供 Nginx 的配置方法。需要的话告诉我！