nginx软链接root路径失效导致404/403，需按序排查：用nginx -t查生效root，ls -l确认是否为软链接，readlink -f验证目标路径存在且nginx用户可访问，检查disable_symlinks配置及selinux上下文。
Linux 下 Nginx 的 root 路径若指向软链接（symbolic link），而该链接失效或目标不可达，常表现为 404 或 403 错误——Nginx 不会自动报“链接损坏”，而是静默失败。排查重点不是“链接是否存在”，而是“Nginx 能否顺着链接抵达真实路径并读取内容”。
确认 root 指向的路径是否为软链接
先查配置中生效的 root 值：
- 运行
nginx -T | grep "root"，定位实际生效的root指令（注意 location 块内定义会覆盖 server 级） - 对输出的路径执行
ls -l /your/root/path，观察是否显示lrwxrwxrwx及箭头（→）指向目标 - 用
readlink -f /your/root/path获取最终解析路径；若返回为空或报错，说明链接已断
验证软链接目标路径的存在性与可访问性
即使链接存在，目标路径也必须满足三项条件：存在、Nginx 用户可进入、文件可读。
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 检查目标目录是否存在：
ls -ld $(readlink -f /your/root/path) - 确认 Nginx worker 进程用户（如
www-data或nginx）对该目录有执行权限（x）：sudo -u www-data ls -l $(readlink -f /your/root/path) - 若目标在挂载点（如 NAS、LVM 卷），需确认该设备已成功挂载：
mount | grep $(dirname $(readlink -f /your/root/path))
检查 Nginx 是否允许跟随软链接
Nginx 默认禁止跨文件系统解析软链接，尤其在启用安全限制时。
- 在
http或server块中检查是否设置了disable_symlinks on;（默认是off，但某些发行版或安全加固配置可能开启） - 若需启用，显式添加：
disable_symlinks off from=/your/real/target/path;，其中from必须是软链接目标所在的真实父目录 - 注意：
disable_symlinks不支持 Windows 快捷方式（.lnk），仅适用于 Linux 符号链接
排除 SELinux 或容器环境干扰
在 CentOS/RHEL 或启用了 SELinux 的系统中，软链接目标目录可能缺少必要上下文。
- 运行
ls -Z $(readlink -f /your/root/path)，确认目录标记为httpd_sys_content_t - 若不符，修复：
sudo chcon -R -t httpd_sys_content_t $(readlink -f /your/root/path) - 容器环境（如 Docker）中，确保软链接目标路径已被正确挂载进容器，且挂载选项未设
noexec或nosuid
