NixOS下Nginx将除JSON外所有文件的MIME类型设为text/html，导致Pterodactyl应用运行异常

架构老林

2026-4-17

我完全懂你现在的困扰——在NixOS上部署Pterodactyl这个PHP-FPM驱动的开源面板时，Nginx居然把CSS、JS、图片这些静态资源全当成text/html类型返回，唯独JSON文件正常，这肯定会让页面样式错乱、脚本跑不起来，而且NixOS那套独特的配置体系，连常规发行版里的conf.d/php.conf都找不到，简直雪上加霜。

先帮你捋清楚问题根源：NixOS是声明式配置系统，Nginx和PHP的配置都不是靠零散的.conf文件堆出来的，而是通过configuration.nix统一管理。你遇到的MIME类型问题，大概率是因为站点配置里把所有请求都转发给了PHP-FPM，导致静态资源也被PHP处理，最终返回了text/html；或者是静态资源的location规则没写对，没让Nginx直接处理这些文件。

下面给你一步步来解决：

先修正Nginx的站点配置，区分静态资源和PHP请求
在你的configuration.nix里，找到Pterodactyl对应的Nginx虚拟主机配置，一定要让静态资源的location规则优先匹配，让Nginx直接返回这些文件（它自带标准的MIME类型映射，不用手动加），剩下的动态请求再交给PHP-FPM。示例配置大概是这样：

services.nginx.virtualHosts."your-pterodactyl-domain.com" = {
  root = "/var/lib/pterodactyl/public"; # 改成你Pterodactyl的public目录路径
  enableACME = true; # 用不上可以删掉
  forceSSL = true;

  locations."/" = {
    tryFiles = "$uri $uri/ /index.php?$query_string";
  };

  # 匹配所有静态资源后缀，让Nginx直接处理
  locations."~* \.(css|js|png|ico|jpg|jpeg|gif|svg|woff|woff2|ttf|eot)$" = {
    expires = "30d";
    addHeaders = {
      "Cache-Control" = "public, max-age=2592000";
    };
    # 这里不需要额外指定MIME类型，NixOS的Nginx默认已经配置好了
  };

  # 处理PHP动态请求
  locations."~ \.php$" = {
    fastcgiPass = "unix:/run/php-fpm/pterodactyl.sock"; # 对应你PHP-FPM的socket路径
    fastcgiParams = {
      SCRIPT_FILENAME = "$document_root$fastcgi_script_name";
      PATH_INFO = "$fastcgi_path_info";
      QUERY_STRING = "$query_string";
      # 其他必要的FastCGI参数根据需要添加
    };
  };
};

关键就是静态资源的location要写在PHP请求的前面，这样Nginx会先匹配静态文件，直接返回正确的MIME类型。

确认Nginx的MIME类型配置没被覆盖
NixOS的Nginx默认已经包含了完整的mime.types配置（路径在/nix/store里对应版本的nginx目录下），除非你在全局配置里加了default_type text/html;强制覆盖，否则静态资源的MIME类型应该是正常的。如果真的加了，要么删掉这个全局设置，要么在静态资源的location里单独指定default_type（比如default_type text/css;针对CSS文件，但其实没必要，默认已经够了）。

检查PHP-FPM的配置正确性
从你给出的php --ini输出看，当前没有加载php.ini，你可以在NixOS的PHP-FPM池配置里指定必要的PHP参数，同时确保socket的权限正确，让Nginx能读写。示例配置：

services.phpfpm.pools.pterodactyl = {
  user = "pterodactyl";
  group = "pterodactyl";
  phpOptions = ''
    memory_limit = 512M
    upload_max_filesize = 100M
    post_max_size = 100M
  '';
  extraConfig = ''
    listen = /run/php-fpm/pterodactyl.sock
    listen.owner = nginx
    listen.group = nginx
    listen.mode = 0660
  '';
};

应用配置并验证
运行sudo nixos-rebuild switch让配置生效，然后重启相关服务：
```
sudo systemctl restart nginx
sudo systemctl restart php-fpm-pterodactyl.service
```
之后用curl -I https://你的域名/css/app.css来检查响应头，正常情况下会看到Content-Type: text/css，其他资源也对应各自的MIME类型。

备注：内容来源于stack exchange，提问作者imposiblaa