部署虚拟Web服务器时遇到Environment Variable配置问题求助

问题原因 #

1. 环境变量未被容器正确读取：从报错信息判断是Docker容器部署场景，你定义的DB_NAME、DJANGO_SECRET_KEY等环境变量未被Django服务容器加载，系统默认将其设为空字符串，触发警告。
2. Postgres容器缺少必填初始化变量：Postgres官方镜像启动时必须设置POSTGRES_PASSWORD来初始化超级用户，未设置则无法完成数据库初始化，直接报错。

解决步骤（Docker Compose多容器场景） #

1. 修正docker-compose.yml的环境变量配置 #

打开项目根目录的docker-compose.yml，分别为Postgres和Django服务配置对应环境变量：

services:
  # Postgres数据库服务
  db:
    image: postgres:latest
    environment:
      - POSTGRES_PASSWORD=your_secure_password  # 必填，设置Postgres超级用户密码
      - POSTGRES_USER=your_db_user             # 可选，默认值为postgres
      - POSTGRES_DB=your_db_name               # 可选，默认与POSTGRES_USER同名

  # Django DRF服务
  web:
    build: .
    environment:
      - DB_NAME=your_db_name       # 与Postgres的POSTGRES_DB保持一致
      - DB_USER=your_db_user       # 与Postgres的POSTGRES_USER保持一致
      - DB_PASS=your_secure_password  # 与Postgres的POSTGRES_PASSWORD保持一致
      - DJANGO_SECRET_KEY=your_django_secret_key  # 替换为安全的随机密钥
      - DJANGO_ALLOWED_HOSTS=your_domain_or_ip    # 替换为服务器域名/IP，多个用逗号分隔
    depends_on:
      - db

2. 用.env文件统一管理环境变量（推荐） #

若不想把敏感信息写在配置文件中，可创建.env文件统一管理：

1. 在项目根目录创建.env文件：

POSTGRES_PASSWORD=your_secure_password
POSTGRES_USER=your_db_user
POSTGRES_DB=your_db_name
DB_NAME=your_db_name
DB_USER=your_db_user
DB_PASS=your_secure_password
DJANGO_SECRET_KEY=your_django_secret_key
DJANGO_ALLOWED_HOSTS=your_domain_or_ip

2. 在docker-compose.yml最上方添加文件引用：

env_file:
  - .env

注意：将.env加入.gitignore，避免敏感信息提交到版本库

3. 重启容器使配置生效 #

执行以下命令重新构建并启动容器：

docker-compose down
docker-compose up --build

解决步骤（单独Docker容器场景） #

1. 启动Postgres容器并指定必填变量 #

docker run -d \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=your_db_user \
  -e POSTGRES_DB=your_db_name \
  --name recipe-app-api-db \
  postgres:latest

2. 启动Django容器并传入对应变量 #

docker run -d \
  -e DB_NAME=your_db_name \
  -e DB_USER=your_db_user \
  -e DB_PASS=your_secure_password \
  -e DJANGO_SECRET_KEY=your_django_secret_key \
  -e DJANGO_ALLOWED_HOSTS=your_domain_or_ip \
  --link recipe-app-api-db:db \
  --name recipe-app-api-web \
  your-django-image:latest

额外注意事项 #

• DJANGO_SECRET_KEY必须使用安全的随机字符串，禁止复用开发环境的测试密钥。
• DJANGO_ALLOWED_HOSTS需设置为部署服务器的域名或公网IP，多个值用逗号分隔（例如"example.com,192.168.1.100"）。
• 绝对不要使用POSTGRES_HOST_AUTH_METHOD=trust，这会跳过密码验证，存在严重安全风险。

内容的提问来源于stack exchange，提问作者Adam Bain