如何在Django模板中显示SFTP远程服务器中的图片文件？

核心思路 #

img标签的src属性需要指向可访问的URL，而非直接传递文件内容或HttpResponse对象。我们需要创建独立视图负责从SFTP服务器读取图片并返回给浏览器，再在模板中通过URL指向该视图。

步骤1：创建SFTP图片处理视图 #

这个视图接收图片路径作为参数，从SFTP读取文件并返回流式响应（适合大文件，降低内存占用）：

# views.py
from django.http import StreamingHttpResponse, Http404
import mimetypes

def sftp_image_view(request, image_path):
    # 假设sfs是已配置好的SFTP存储实例
    if not sfs.exists(image_path):
        raise Http404("图片不存在")
    
    file_content = sfs._read(image_path)
    content_type, _ = mimetypes.guess_type(image_path)
    content_type = content_type or 'image/jpeg'  # 兜底默认图片类型
    
    # 用StreamingHttpResponse分块传输文件
    response = StreamingHttpResponse([file_content], content_type=content_type)
    # 可选：添加缓存头提升性能
    response['Cache-Control'] = 'max-age=86400'
    return response

步骤2：配置URL路由 #

在urls.py中添加对应路由，让模板能生成指向上述视图的URL：

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    # 其他路由...
    path('sftp-image/<path:image_path>/', views.sftp_image_view, name='sftp_image'),
]

步骤3：修改课程列表视图 #

无需生成HttpResponse列表，直接传递课程对象即可：

# views.py
def coursesPageView(request):
    courses = Course.objects.filter(is_published=True)
    return render(request, 'pages/course2.html', {
        'published_courses_list': courses
    })

步骤4：修改模板 #

使用{% url %}标签生成SFTP图片的访问URL，替换原有的{{images}}：

<!-- course2.html -->
{% for course in published_courses_list %}
    <a href="{{ course.get_absolute_url }}">
        <img src="{% url 'sftp_image' course.image.name %}" alt="{{ course.title }}">
    </a>
{% endfor %}

关键优化点 #

• 避免在列表视图中预读所有图片：防止内存占用过高，尤其是课程数量多或图片体积大时。
• 复用SFTP连接：建议用连接池或单例模式复用SFTP连接，避免每次请求新建连接损耗性能。
• 权限控制（可选）：若需限制图片访问，可在sftp_image_view中添加登录验证或课程权限检查。

内容的提问来源于stack exchange，提问作者Feyza Kılıç