在Django REST Framework（简称DRF）项目部署到生产环境后，开发者常常会发现接口返回的JSON数据中，包含的URL字段（如图片、文件下载链接等）的域名部分竟然还是本地回环地址127.0.0.1。这种现象会导致前端应用拉取资源失败，或者第三方服务回调时指向了错误的服务器。要解决这个问题，不能仅仅停留在DRF框架的表面配置，而需要深入理解从客户端请求到服务器响应的整个链路中，域名是如何被解析和拼接的。
探究DRF序列化输出127.0.0.1的底层原因
DRF框架在处理文件字段（如ImageField或FileField）时，默认会调用其url属性来生成完整的资源链接。这个属性的底层实现依赖于Django的request.build_absolute_uri()方法。该方法的核心逻辑是获取当前请求的HTTP_HOST或SERVER_NAME来拼接完整的URI。
当应用服务器（如uWSGI或Gunicorn）直接运行在本地时，如果没有配置正确的代理转发，Django接收到的请求Host就是127.0.0.1。此外，如果Nginx作为反向代理，但没有在转发请求时携带Host头或X-Forwarded-Host头，Django同样无法得知外部访问的真实域名，从而导致了序列化输出时使用了内部回环地址。
理解了这个底层原理后，我们就明确了问题的根源不在于DRF本身的代码逻辑有缺陷，而在于网络架构的请求头信息传递存在缺失。因此，解决该问题的第一步就是确保反向代理服务器能够将客户端的真实域名信息传递给后端的Django应用。
配置Nginx反向代理正确传递Host请求头
在大多数生产环境中，Nginx是不可或缺的反向代理组件。当Nginx接收到外部请求并转发给内部的Django服务时，默认情况下可能不会修改或传递原始的Host头。我们需要在Nginx的配置文件中显式设置相关的请求头参数，确保后端能够获取到真实的外部访问域名。
具体来说，需要在Nginx的location块中添加proxy_set_header指令。最关键的是设置Host为$host，这样Nginx就会把客户端请求的真实域名传递给后端。同时，为了处理HTTPS协议的识别，还需要传递X-Forwarded-Proto头。
server {
listen 80;
server_name api.ipipp.com;
location / {
proxy_pass http://127.0.0.1:8000;
# 传递真实的主机名和请求协议
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;
}
}
上述配置中，proxy_set_header Host $host;是解决127.0.0.1问题的关键。它将外部访问的域名（如api.ipipp.com）原封不动地传递给运行在8000端口的Django应用。修改配置后，记得使用nginx -s reload重启Nginx服务使配置生效。
调整Django与DRF框架的动态域名生成策略
虽然Nginx已经正确传递了Host头，但Django默认出于安全考虑，并不会直接信任代理服务器传递过来的Host信息。Django的ALLOWED_HOSTS配置项决定了服务器接受哪些Host头的请求。如果真实域名没有包含在内，Django会抛出DisallowedHost异常。因此，必须将真实域名加入该列表。
此外，如果使用了HTTPS，Django还需要知道当前请求是通过HTTPS代理过来的。这就需要配置SECURE_PROXY_SSL_HEADER。当请求头中包含指定的值时，Django会认为当前请求是安全的，从而在生成绝对路径URL时使用https://前缀。
# settings.py
# 允许的真实域名
ALLOWED_HOSTS = ['api.ipipp.com', '127.0.0.1', 'localhost']
# 信任代理服务器传递的HTTPS协议头
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')
# 如果使用了多个代理，可能还需要开启
USE_X_FORWARDED_HOST = True
在DRF的序列化器中，如果需要自定义生成某些动态链接，建议直接使用self.context['request'].build_absolute_uri()来构建，而不是硬编码域名。这样能够确保生成的链接始终与当前请求的上下文保持一致，彻底避免本地IP暴露的问题。通过Nginx与Django的协同配置，DRF输出的数据域名就能正确显示为外部访问的真实地址了。