Django-allauth自定义邮件模板添加个人图片问题求助

The core problem here is that email clients don’t share the same context as your local Django server. When you use {% static %} with a relative /static/ path, the email client tries to load the image from the email server’s domain/port (your 0.0.0.0:8025) instead of your Django dev server (0.0.0.0:8000). Here are three reliable fixes:

1. Use Fully Qualified Absolute URLs for Static Assets #

The simplest quick fix for both development and production is to configure Django to output full URLs for static files instead of relative paths.

How to set this up: #

In your settings.py, update the STATIC_URL based on your environment:

import socket

# Get your local IP address (for development)
def get_local_ip():
    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
    try:
        # Doesn't even have to be reachable
        s.connect(("10.255.255.255", 1))
        IP = s.getsockname()[0]
    except Exception:
        IP = "127.0.0.1"
    finally:
        s.close()
    return IP

if DEBUG:
    # Use your local LAN IP + Django port for development
    STATIC_URL = f"http://{get_local_ip()}:8000/static/"
else:
    # Use your production domain/CDN for live environments
    STATIC_URL = "https://your-production-domain.com/static/"

Now when you use {% static 'images/img0.png' %}, it will generate a full URL like http://192.168.1.100:8000/static/images/img0.png that the email client can reach directly from your dev server.

2. Inline Images Directly into the Email (Most Reliable) #

Many email clients block external images by default, so embedding images directly into the email ensures they load without user interaction. To do this with Django-allauth, you’ll need to override the email-sending adapter.

Step 1: Override the Account Adapter #

Create a custom adapter in your app (e.g., accounts/adapters.py):

from allauth.account.adapter import DefaultAccountAdapter
from django.core.mail import EmailMultiAlternatives
from django.conf import settings
from django.template.loader import render_to_string
import os

class CustomAccountAdapter(DefaultAccountAdapter):
    def send_confirmation_mail(self, request, emailconfirmation, signup):
        ctx = {
            "user": emailconfirmation.email_address.user,
            "confirmation": emailconfirmation,
            "request": request,
        }
        # Render your HTML and plaintext templates
        html_content = render_to_string("account/email/email_confirmation_signup.html", ctx)
        plaintext_content = render_to_string("account/email/email_confirmation_signup.txt", ctx)
        
        # Create the email with inline image support
        msg = EmailMultiAlternatives(
            self.get_email_confirmation_subject(request),
            plaintext_content,
            settings.DEFAULT_FROM_EMAIL,
            [emailconfirmation.email_address.email]
        )
        msg.attach_alternative(html_content, "text/html")
        
        # Attach the image as an inline resource
        img_path = os.path.join(settings.STATIC_ROOT, "images/img0.png")
        with open(img_path, "rb") as img_file:
            msg.attach(
                "img0.png",
                img_file.read(),
                "image/png"
            )
        # Set mixed subtype to ensure inline images work correctly
        msg.mixed_subtype = "related"
        msg.send()

Step 2: Update Settings to Use the Custom Adapter #

Add this line to your settings.py:

ACCOUNT_ADAPTER = "accounts.adapters.CustomAccountAdapter"

Step 3: Update Your Email Template #

Change the image tag to reference the inline image using a cid: URL:

<img src="cid:img0.png" alt="Your Brand Image" />

3. Quick Development Hack (Use 127.0.0.1 Instead of 0.0.0.0) #

If you just need a temporary fix for testing, replace 0.0.0.0 with 127.0.0.1 in your STATIC_URL and run your Django server on 127.0.0.1:8000. The image URL in the email will become http://127.0.0.1:8000/static/images/img0.png, which your local email client (like MailHog running on 127.0.0.1:8025) can access without cross-port issues.

内容的提问来源于stack exchange，提问作者Deft-pawN