Typecho自定义上传目录：告别默认路径，轻松管理附件存储位置

52JinY 助手

最近折腾Typecho博客的时候，遇到了一个让我头疼了好一会儿的问题——默认的上传目录结构实在不够灵活。Typecho默认会把上传的文件放在 /usr/uploads/ 这个路径下，然后按照年月自动归类，比如 /usr/uploads/2024/01/这样的格式。对于大多数人来说可能无所谓，但如果你像我一样有强迫症，或者有特定的目录管理需求，这个默认设置就显得比较鸡肋了。

我折腾了几个小时，查了不少资料，终于找到了几种可行的修改方案，在这里分享给有同样需求的朋友。

最直接的方式是修改 config.inc.php 文件。打开网站根目录下的这个文件，找到或者直接添加一行配置：define('__TYPECHO_UPLOAD_DIR__', '/你想要的目录路径/');。需要注意的是，这里填写的是相对于网站根目录的路径，填之前要确保目标目录已经存在，而且服务器对这个目录有写入权限，否则上传的时候会直接报错，这个坑我踩过。

除了全局配置，Typecho其实还有一个更灵活的方式，那就是通过插件来实现自定义上传路径。网上能找到一些专门处理附件上传的插件，可以在后台直接设置上传路径，甚至可以设置更复杂的规则，比如按照文章ID归类、按照文件类型分文件夹存放等等。如果你不想动源码，插件方式会更安全，后续升级Typecho也不用担心配置被覆盖的问题。

说到这里要顺便提醒一下，修改完目录之后，一定要去检查一下旧文件的问题。如果你的博客已经运行了一段时间，原来 /usr/uploads/ 下已经有了不少图片和附件，修改目录之后这些旧文件的链接并不会自动更新，文章里的图片就会显示不出来。处理方式有两种：一是把旧的上传目录里的文件迁移到新目录，同时在服务器层面做一个重定向；二是保留旧目录不动，只让新上传的内容走新路径。我个人倾向于第二种，省事，不容易出问题。

另外还有一个容易被忽略的细节，就是权限问题。不管你把上传目录改到哪里，都要确保PHP运行用户对该目录有读写权限。很多人改完路径之后发现上传失败，检查半天才发现是 chmod 没设置好。一般来说设置成755或者775就够用了，别图省事直接777，尤其是生产环境的服务器，安全隐患不小。

我还见过有人想把上传目录改到网站根目录之外，比如挂载一个单独的存储盘。这个在理论上是可行的，但Typecho对路径的处理有一定限制，搞不好上传能成功但是前端访问不到文件。如果有这种需求，建议在Nginx或者Apache那一层做映射，把外部存储路径映射成一个可以通过HTTP访问的URL，这样会更稳妥。

总的来说，Typecho的上传目录修改并不复杂，但细节挺多，需要把路径、权限、旧数据迁移这几个环节都考虑清楚，一步步来，别急着改完就走，最好在测试环境先验证一遍再上生产。希望这篇帖子能帮到同样在折腾这个问题的朋友，有遇到其他问题的也欢迎在下面留言交流。