Docker化Django REST应用与PostgreSQL：无需频繁修改settings.py的方法？

当然有办法解决这个痛点！每次切换环境都改settings.py确实太繁琐了，下面是几个经过实践验证的方案，你可以根据自己的需求选择：

这个方案最轻量化，不需要额外依赖，核心思路是让settings.py从环境变量读取配置项，同时给本地环境设置默认值，Docker环境通过docker-compose.yml传递环境变量覆盖即可。

修改你的settings.py：

import os

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        # 第一个参数是环境变量名，第二个是本地环境的默认值
        'NAME': os.environ.get('DB_NAME', '你的本地数据库名'),
        'USER': os.environ.get('DB_USER', '你的本地数据库用户名'),
        'PASSWORD': os.environ.get('DB_PASSWORD', '你的本地数据库密码'),
        'HOST': os.environ.get('DB_HOST', 'localhost'),
        'PORT': os.environ.get('DB_PORT', '5432'),
    }
}

本地运行优化 #

为了不用每次启动都手动输环境变量，你可以在项目根目录创建一个.env文件（记得把它加入.gitignore，别提交到代码仓库）：

DB_NAME=你的本地数据库名
DB_USER=你的本地数据库用户名
DB_PASSWORD=你的本地数据库密码
DB_HOST=localhost
DB_PORT=5432

然后安装python-dotenv包自动加载这个文件：

pip install python-dotenv

在settings.py的最顶部添加：

from dotenv import load_dotenv
load_dotenv()  # 自动加载.env里的环境变量

Docker环境配置 #

在docker-compose.yml的web服务里添加环境变量：

services:
  web:
    # 你的其他配置（镜像、端口映射等）...
    environment:
      - DB_NAME=agent_technologies_db
      - DB_USER=stefan_radonjic
      - DB_PASSWORD=cepajecar995
      - DB_HOST=db
      - DB_PORT=5432
  db:
    # 你的数据库服务配置...

这样Docker启动时会用这些环境变量覆盖默认值，完全不用改代码。

如果你的本地和Docker环境除了数据库还有很多其他配置差异，这个方案更合适。把配置拆分成通用基础配置和环境专属配置：

1. 在项目的settings目录下创建三个文件：

   • base.py：存放所有环境通用的配置（比如INSTALLED_APPS、MIDDLEWARE、SECRET_KEY等）
   • local.py：本地环境专属配置（继承base.py，覆盖数据库配置）
   • docker.py：Docker环境专属配置（继承base.py，覆盖数据库配置）

2. 编写base.py：

# 通用配置，比如：
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    # ... 其他应用
]

MIDDLEWARE = [
    # ... 中间件配置
]

# 其他通用配置...

3. 编写local.py：

from .base import *

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': '你的本地数据库名',
        'USER': '你的本地数据库用户名',
        'PASSWORD': '你的本地数据库密码',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

4. 编写docker.py：

from .base import *

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'agent_technologies_db',
        'USER': 'stefan_radonjic',
        'PASSWORD': 'cepajecar995',
        'HOST': 'db',
        'PORT': '',
    }
}

启动时指定配置文件 #

• 本地运行：

python manage.py runserver --settings=你的项目名.settings.local

• Docker环境下，在docker-compose.yml里设置环境变量指定配置：

services:
  web:
    environment:
      - DJANGO_SETTINGS_MODULE=你的项目名.settings.docker
    # 其他配置...

这是Django生态中专门管理配置的第三方包，能更优雅地处理环境变量和配置文件，符合12-factor应用的配置规范，非常推荐。

1. 安装包：

pip install django-environ

2. 在项目根目录创建.env文件（本地用）：

DB_NAME=你的本地数据库名
DB_USER=你的本地数据库用户名
DB_PASSWORD=你的本地数据库密码
DB_HOST=localhost
DB_PORT=5432

3. 修改settings.py：

import environ

# 初始化环境变量解析器
env = environ.Env()
# 读取.env文件（仅本地环境生效，Docker环境会用环境变量覆盖）
environ.Env.read_env()

DATABASES = {
    # 直接用env.db()方法自动解析DB_URL，或者手动指定每个字段
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': env('DB_NAME'),
        'USER': env('DB_USER'),
        'PASSWORD': env('DB_PASSWORD'),
        'HOST': env('DB_HOST'),
        'PORT': env('DB_PORT'),
    }
}

4. Docker环境配置
   同样在docker-compose.yml的web服务里添加环境变量：

services:
  web:
    environment:
      - DB_NAME=agent_technologies_db
      - DB_USER=stefan_radonjic
      - DB_PASSWORD=cepajecar995
      - DB_HOST=db
      - DB_PORT=5432
    # 其他配置...

这个方案既灵活又规范，后续新增配置项也很方便，非常适合长期维护的项目。

内容的提问来源于stack exchange，提问作者Stefan Radonjic