Typecho 图片上传失败提示权限不足，通常是因为服务器上的 usr/uploads 目录缺少写入权限或所有者配置错误。最稳妥的处理是将上传目录权限设置为 755 或 775，并将所有者变更为 Web 服务运行用户，避免直接使用 777 权限带来安全风险。

命令速用版

以下命令适用于 Linux 服务器，需在 SSH 终端中进入 Typecho 网站根目录后执行。

chmod -R 755 usr/uploads
chown -R www-data:www-data usr/uploads

如果使用的是宝塔面板或其他特定环境，Web 用户可能是 www，请将 www-data 替换为实际用户。

为什么会这样

Linux 系统通过文件权限位控制不同用户对文件的访问，Web 服务器进程无权写入会导致上传失败。Typecho 运行时需要向 usr/uploads 目录写入图片文件，如果该目录权限设置为只读，或者所有者不属于 Web 服务运行用户，PHP 脚本就无法创建文件或子目录。部分教程建议直接开放 777 权限，但这会让所有用户拥有写入权，存在被上传恶意脚本的安全风险，公开资料中建议严禁对整个上传目录设 777。

分步处理

按顺序执行以下操作，每一步完成后检查是否有报错。

第一步：确认上传目录路径
登录服务器，进入 Typecho 安装根目录，确认 uploads 文件夹位置。标准 Typecho 结构中，附件存储在 usr/uploads 目录下。如果使用了自定义上传目录配置，需检查 config.inc.php 中的__TYPECHO_UPLOAD_DIR__定义。

第二步：修改目录权限
执行 chmod 命令放开目录读写执行权限。推荐先将目录设为 755，文件设为 644。若仍无法上传，可尝试将 uploads 目录设为 775，确保组用户有写入权。

find usr/uploads -type d -exec chmod 755 {} \;
find usr/uploads -type f -exec chmod 644 {} \;

第三步：修正文件所有者
权限正确但所有者错误依然无法写入。使用 chown 命令将目录所有者改为 Web 服务运行用户。常见用户为 www-data、www 或 nginx。

chown -R www-data:www-data usr/uploads

第四步：检查 PHP 配置
如果权限无误但仍上传失败，需检查 php.ini 中的上传限制。确保 upload_max_filesize 和 post_max_size 大于图片文件大小，max_execution_time 设置合理。

怎么验证是否生效

操作完成后，通过 Typecho 后台撰写文章页面尝试上传一张测试图片。若上传成功且能在文章编辑器中预览，说明权限配置生效。若仍失败，查看服务器错误日志，通常位于 /var/log/nginx/error.log 或 /var/log/apache2/error.log，确认是否有 Permission denied 或 Open basedir 限制报错。

常见坑

部分云服务器环境启用了 SELinux 或 AppArmor 安全策略，即使文件权限正确也会被拦截。如果遇到这种情况，需要调整安全策略或暂时禁用测试。另外，部分 Typecho 版本在检测到特定云环境变量时会禁止本地上传，需修改/var/Typecho/Common.php 中的 isAppEngine 方法返回 false。避免直接对整个网站根目录设置 777 权限，这会导致核心文件被篡改风险。

常见问题

755 和 777 权限有什么区别？

755 允许所有者读写执行，其他人只读执行，777 允许所有人读写执行。755 更安全，777 存在被上传 WebShell 的风险，公开资料中建议严禁对整个上传目录设 777。

Docker 环境怎么修改权限？

Docker 容器内权限映射复杂，建议在宿主机上对挂载的 uploads 目录执行 chmod 775 或 755，并确保容器内运行用户 ID 与宿主机文件所有者 ID 一致。

修改权限后仍然提示存储目录创建失败？

检查父目录权限是否限制了子目录创建，或确认磁盘空间是否充足。若使用对象存储插件，需检查插件配置中的 AccessKey 和 Bucket 权限。

参考来源

• Typecho 在使用的过程中常见问题汇总
• Typecho 上传附件失败最佳解决方法
• 解决 Typecho Docker 环境安装问题：权限配置指南
• php7.4 安装宝塔后文件权限异常怎么处理
• 后台图片上传提示：”上传失败：存储目录创建失败！ - 黄文 Rex - 博客园