Typecho 伪静态配置完整指南：含宝塔面板专属教程（告别 index.php）

Typecho 作为轻量优雅的博客程序，默认链接会带有  index.php  后缀（例如  https://yourdomain.com/index.php/archives/1/ ），不仅影响 URL 美观，还不利于 SEO 优化。通过伪静态配置，可将链接简化为  https://yourdomain.com/archives/1.html  这类干净格式。本文将详细讲解 Typecho 伪静态的核心步骤，重点覆盖宝塔面板（LNMP/LAMP 环境），同时兼容原生服务器配置，新手也能轻松上手。

一、伪静态配置前置条件

在开始配置前，需确保服务器环境满足以下要求，避免出现配置失效：

1.  服务器支持 URL 重写：Apache 需启用  mod_rewrite  模块，Nginx 需支持  rewrite  规则（宝塔面板默认已开启）；
2.  Typecho 已完成安装，且可正常访问后台（安装后建议删除  install.php  文件保障安全）；

3.  网站目录权限正确：目录权限为 755，文件权限为 644，避免服务器无法读取配置文件。

   二、核心步骤：先开启 Typecho 地址重写功能

   无论使用宝塔面板还是原生服务器，都需先在 Typecho 后台开启基础配置：
   1. 登录 Typecho 后台，进入「设置」→「永久链接」；
   2. 勾选「启用地址重写功能」，若提示“需修改服务器配置”，直接选择「仍然启动此功能」；
   3. 自定义文章路径格式（推荐 2 种实用样式）：
   　- 简洁 ID 格式： /archives/{cid}.html （cid 为文章ID，稳定不易出错）；
   　- 自定义别名格式： /post/{slug}.html （slug 为文章别名，需手动设置）；
   4. 点击「保存设置」，此时前台访问可能出现 404 错误，需继续配置服务器伪静态规则。

   三、宝塔面板用户专属配置（推荐，最便捷）

   宝塔面板已内置 Typecho 伪静态规则，无需手动编写代码，按环境分类操作即可：

   1. LNMP 环境（Nginx + PHP + MySQL）

   1. 登录宝塔面板，左侧导航栏点击「网站」，找到目标 Typecho 站点，点击「设置」；
   2. 进入「伪静态」选项卡，在规则列表中直接选择「Typecho」（若博客安装在二级目录，如  yourdomain.com/typecho ，则选择「Typecho2」）；
   3. 点击「保存」，伪静态规则自动生效，无需额外配置。

   2. LAMP 环境（Apache + PHP + MySQL）

   1. 同样进入站点「设置」→「伪静态」，宝塔默认无 Apache 预设规则，需手动添加以下代码：

   <IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteBase /
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^(.*)$ index.php (L,E=PATH_INFO:$1)
   </IfModule>

   2. 点击「保存」，完成配置。

   四、原生服务器配置（非宝塔用户）

   若未使用宝塔面板，需根据服务器类型手动创建配置文件：

   1. Apache 服务器（创建 .htaccess 文件）

   1. 用 FTP 工具（如 FileZilla）连接服务器，进入 Typecho 根目录；
   2. 新建文件命名为  .htaccess （注意以英文句点开头，无后缀），写入以下规则：

   <IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteBase /
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^(.*)$ index.php (L)
   </IfModule>

   3. 上传文件至根目录，确保 Apache 开启  AllowOverride All  权限（否则 .htaccess 无效）。

   2. Nginx 服务器（修改 nginx.conf）

   1. 登录服务器，编辑 Nginx 配置文件（路径通常为  /etc/nginx/nginx.conf  或  /etc/nginx/sites-available/default ）；
   2. 在对应站点的  server  块中添加以下规则：

   location / {
    index index.html index.htm index.php;
    if (-f $request_filename/index.html) {
        rewrite (.*) $1/index.html break;
    }
    if (-f $request_filename/index.php) {
        rewrite (.*) $1/index.php;
    }
    if (!-f $request_filename) {
        rewrite (.*) /index.php;
    }
   }
   # 支持 pathinfo（解决 404/405 错误）
   location ~ .*\.php(\/.*)*$ {
    include fastcgi.conf;
    fastcgi_pass 127.0.0.1:9000; # 若为 Unix 套接字，改为 unix:/run/php/php7.4-fpm.sock（需匹配 PHP 版本）
    set $path_info "";
    set $real_script_name $fastcgi_script_name;
    if ($fastcgi_script_name ~ "^(.+?\.php)(/.+)$") {
        set $real_script_name $1;
        set $path_info $2;
    }
    fastcgi_param SCRIPT_FILENAME $document_root$real_script_name;
    fastcgi_param SCRIPT_NAME $real_script_name;
    fastcgi_param PATH_INFO $path_info;
   }

   3. 保存文件后，执行命令  sudo nginx -t  验证配置语法，无错误则执行  sudo systemctl restart nginx  重启 Nginx。

   1. 进入 Typecho 根目录，新建  httpd.ini  文件，写入以下规则：

   CacheClockRate 3600
   RepeatLimit 32
   # 中文标签与静态文件例外
   RewriteRule /tag/(.*) /index\.php\?tag=$1
   RewriteRule /sitemap.xml /sitemap.xml (L)
   RewriteRule /favicon.ico /favicon.ico (L)
   # 核心重写规则
   RewriteRule /(.*).html /index.php/$1.html (L)
   RewriteRule /(.*)/comment /index.php/$1/comment (L)
   RewriteRule /category/(.*) /index.php/category/$1 (L)
   RewriteRule /page/(.*) /index.php/page/$1 (L)

   2. 保存文件并上传，确保 IIS 已安装 URL 重写模块。

   五、配置验证与常见问题排查

   1. 验证是否生效

   访问任意一篇文章，观察地址栏：若 URL 已去除  index.php  且页面正常加载，说明配置成功；若出现 404/500 错误，按以下方法排查。

   2. 常见问题及解决方案

六、优化建议

1. 配置完成后，可通过站长工具检测 URL 规范性，确保无  index.php  后缀残留；
2. 若需自定义更复杂的 URL 格式（如分类+日期+标题），可在「永久链接」中使用  /{category}/{year}/{month}/{slug}.html  这类规则；
3. 定期备份伪静态配置文件（.htaccess 或 nginx.conf），避免服务器迁移时丢失。

通过以上步骤，无论是宝塔面板用户还是原生服务器用户，都能快速实现 Typecho 伪静态。干净的 URL 不仅能提升用户体验，还能帮助搜索引擎更好地抓取内容，为博客 SEO 打下基础。如果遇到特殊环境配置问题，可留言说明服务器类型和错误信息，将为你提供针对性解决方案！