Typecho安装在子目录时404问题解决方法

在搭建基于Typecho的网站时，服务器环境的配置是关键环节。当使用LNMP（Linux + Nginx + MySQL + PHP）搭建服务器环境，且Typecho网站安装在子目录而非根目录时，Nginx伪静态规则的正确配置就显得尤为重要。若配置不当，会导致前台文章打开显示404 Not Found，登录Typecho网站后台也出现同样的错误提示，严重影响网站的正常访问和使用。本文将深入剖析这一问题，并给出切实可行的解决方案。

一、Nginx伪静态规则的作用

Nginx伪静态规则的核心功能是将动态的URL地址转换为更具可读性和利于搜索引擎优化（SEO）的静态URL地址。对于Typecho这类依赖动态脚本处理请求的博客系统来说，通过伪静态规则可以让用户访问的URL看起来像静态页面，不仅提升用户体验，还能帮助搜索引擎更好地抓取网站内容，提高网站在搜索结果中的排名。

当Typecho安装在根目录时，Nginx对请求的处理相对直接。服务器可以轻松识别请求的资源是否存在于根目录下，若不存在则按照预设规则进行处理。然而，当Typecho安装在子目录时，情况变得复杂起来。此时，服务器需要明确知道请求是针对子目录中的Typecho应用，而不是根目录下的其他资源。如果直接使用根目录的伪静态规则，Nginx无法正确匹配子目录中的资源路径，从而导致404错误。

三、子目录Typecho站点伪静态规则详解

以下是适用于安装在子目录的Typecho站点的Nginx伪静态规则：

location /blog/ {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /blog/index.php$1 last;
    }
}

location /blog/：这部分定义了规则的作用范围，即针对以/blog/开头的所有请求。这里的blog是实际的子目录名称，例如，如果Typecho安装在/blog/子目录下。
if (!-e $request_filename)：这是一个条件判断语句。-e表示检查文件或目录是否存在，$request_filename是Nginx内置变量，代表当前请求的文件名。这个条件的意思是，如果请求的文件或目录不存在，就执行后续的重写操作。
rewrite ^(.*)$ /blog/index.php$1 last;：rewrite指令用于重写URL。^(.*)$是一个正则表达式，表示匹配任意字符，$1是反向引用，代表前面正则表达式匹配到的内容。这条指令的作用是将请求重定向到/blog/index.php，并将原请求的路径附加在后面。例如，原请求是
https://liyuai.com/blog/archives/chatgpt-tutorial.html
，重定向后就变成https://liyuai.com/blog/index.php/archives/chatgpt-tutorial.html ，这样Typecho应用就能正确处理请求并返回相应内容。last标志表示完成重写后停止处理当前的location块，并重新查找匹配的location块。

四、配置步骤与注意事项

查找Nginx配置文件：通常，Nginx的配置文件位于/etc/nginx/目录下，常见的文件名有nginx.conf或sites-available/default等。不同的服务器环境和安装方式可能会有所不同，可以通过查找或咨询服务器管理员确定具体路径。
添加伪静态规则：打开找到的Nginx配置文件，在合适的位置添加上述伪静态规则。注意，如果配置文件中已经存在其他location块，要确保添加的规则不会与已有规则冲突。
修改子目录名称：将规则中的foldername替换为实际的Typecho安装子目录名称。
重启Nginx服务：完成规则添加和修改后，保存配置文件，然后重启Nginx服务使配置生效。在Linux系统中，可以使用命令sudo service nginx restart（不同系统可能略有差异）。
测试验证：重启后，访问Typecho网站的前台文章和后台登录页面，检查是否还存在404错误。若仍有问题，需要检查配置是否正确，包括文件路径、语法错误等，还可以查看Nginx的错误日志（通常位于/var/log/nginx/error.log）获取更多线索。