Debian 11 VPS安装Directus后登录遇服务器错误求助

• 优先查看错误日志定位问题

  • 查看Directus服务实时日志：journalctl -u directus -f，或者检查Directus日志目录（通常是/var/log/directus/）里的文件，日志会明确记录是数据库连接失败、配置错误还是权限问题。
  • 同时检查Nginx错误日志：tail -f /var/log/nginx/error.log，排查反向代理是否存在连接异常。

• 验证数据库连接配置

  • 打开Directus根目录下的.env文件，确认DB_HOST、DB_PORT、DB_USER、DB_PASSWORD、DB_DATABASE参数完全匹配MariaDB的配置，MariaDB默认端口为3306。
  • 手动测试数据库连接：执行mysql -u <你的数据库用户> -p，输入密码后尝试访问Directus对应的数据库，确保用户拥有该数据库的读写权限，若权限不足可执行：

    GRANT ALL PRIVILEGES ON <directus数据库名>.* TO '<数据库用户>'@'localhost';
    FLUSH PRIVILEGES;
    

• 检查Node.js版本兼容性

  • Directus 10及以上版本要求Node.js 16.x及以上，Debian 11默认的Node版本可能不满足，执行node -v查看当前版本。
  • 若版本过低，可通过官方源安装高版本Node：

    echo "deb https://deb.nodesource.com/node_18.x bullseye main" >> /etc/apt/sources.list.d/nodesource.list
    echo "deb-src https://deb.nodesource.com/node_18.x bullseye main" >> /etc/apt/sources.list.d/nodesource.list
    curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/trusted.gpg.d/nodesource.gpg
    apt update
    apt install -y nodejs
    

  • 安装完成后验证版本：node -v，之后重启Directus服务：systemctl restart directus

• 确认Nginx反向代理配置正确性

  • 确保Nginx配置文件中正确转发请求到Directus默认端口（8055），典型配置片段如下：

    server {
        listen 80;
        server_name your-domain.com;
    
        location / {
            proxy_pass http://localhost:8055;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
    

  • 配置完成后重载Nginx：systemctl reload nginx，并检查Nginx状态：systemctl status nginx

• 修复文件目录权限

  • Directus需要对uploads目录和配置文件有读写权限，确保运行Directus的用户（如www-data或自定义用户）拥有对应权限：

    chown -R www-data:www-data /path/to/directus
    chmod -R 755 /path/to/directus/uploads
    

  • 权限修复后重启Directus服务。

• 重新执行数据库迁移

  • 若数据库表结构存在异常，执行数据库迁移命令：npx directus database migrate:latest
  • 迁移完成后重启Directus：systemctl restart directus

内容的提问来源于stack exchange，提问作者Nabi Arshad