如何通过Docker动态配置运行Node.js与Nginx服务？

Hey there! Let's break this down step by step since you're just getting started with Node.js, Nginx, and Docker. The core idea here is to use environment variables passed to your Docker container, then replace placeholder values in your Nginx config and Node.js app with these variables at runtime. Here's how to pull it off:

1. Project Structure Setup #

First, organize your files like this to keep things clean:

node-nginx-docker/
├── docker-compose.yml
├── entrypoint.sh       # Script to handle variable replacement
├── nginx/
│   ├── nginx.conf.template  # Nginx config with placeholders
│   └── ssl/                # Optional: Store SSL certs here (or mount externally)
└── node-app/
    ├── app.js.template     # Node.js app with placeholders
    └── package.json

2. Create Template Files with Placeholders #

Replace hardcoded values in your configs with placeholder strings (e.g., {{SERVER_URI}}, {{SERVER_PORT}}) that we'll swap out later.

Example nginx/nginx.conf.template #

server {
    listen {{SERVER_PORT}} ssl;
    server_name {{SERVER_URI}};

    ssl_certificate {{SSL_CERT_PATH}};
    ssl_certificate_key {{SSL_KEY_PATH}};

    location / {
        proxy_pass http://localhost:3000;  # Point to your Node.js app
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Example node-app/app.js.template #

If your Node app needs to reference the domain or other variables, add placeholders here too:

const express = require('express');
const app = express();
const port = 3000; // Node's internal port (we'll proxy to this via Nginx)

app.get('/', (req, res) => {
    res.send(`Hello from Node.js! Running on domain: {{SERVER_URI}}`);
});

app.listen(port, () => {
    console.log(`Node app listening at http://localhost:${port}`);
});

3. Write an Entrypoint Script to Replace Variables #

The entrypoint.sh will run when the container starts, replacing all placeholders with the environment variables passed by the user. Make sure it's executable (chmod +x entrypoint.sh).

#!/bin/bash

# Add validation for required variables
if [ -z "$SERVER_URI" ]; then
    echo "Error: SERVER_URI environment variable is required"
    exit 1
fi

if [ -z "$SERVER_PORT" ]; then
    echo "Error: SERVER_PORT environment variable is required"
    exit 1
fi

# Replace placeholders in Nginx config
sed -i "s/{{SERVER_URI}}/$SERVER_URI/g" /etc/nginx/nginx.conf
sed -i "s/{{SERVER_PORT}}/$SERVER_PORT/g" /etc/nginx/nginx.conf
sed -i "s/{{SSL_CERT_PATH}}/$SSL_CERT_PATH/g" /etc/nginx/nginx.conf
sed -i "s/{{SSL_KEY_PATH}}/$SSL_KEY_PATH/g" /etc/nginx/nginx.conf

# Replace placeholders in Node.js app
sed -i "s/{{SERVER_URI}}/$SERVER_URI/g" /app/app.js

# Start Nginx and Node.js (run Nginx in foreground to keep container alive)
nginx -g 'daemon off;' &
node /app/app.js

4. Configure Docker Compose & Dockerfile #

Use these files to build your container image and define service settings:

Example Dockerfile #

# Use a base image with Node.js and Nginx
FROM node:18-alpine

# Install Nginx and dependencies
RUN apk add --no-cache nginx

# Create necessary directories
RUN mkdir -p /app /etc/nginx/ssl

# Copy Node app files
COPY node-app/package.json /app/
COPY node-app/app.js.template /app/app.js.template

# Install Node dependencies
RUN cd /app && npm install

# Copy Nginx config template
COPY nginx/nginx.conf.template /etc/nginx/nginx.conf

# Copy entrypoint script
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

# Set entrypoint
ENTRYPOINT ["/entrypoint.sh"]

Example docker-compose.yml #

version: '3.8'
services:
  web:
    build: .
    ports:
      - "${SERVER_PORT}:${SERVER_PORT}"
    environment:
      - SERVER_URI=${SERVER_URI}
      - SERVER_PORT=${SERVER_PORT}
      - SSL_CERT_PATH=/etc/nginx/ssl/cert.pem
      - SSL_KEY_PATH=/etc/nginx/ssl/key.pem
    volumes:
      # Mount local SSL certs into the container (keep certs out of the image!)
      - ./nginx/ssl:/etc/nginx/ssl

5. Run the Container with User Input #

Create a .env file to store your variables (or pass them directly via command line):

.env File Example #

SERVER_URI=your-custom-domain.com
SERVER_PORT=443

Then start the container with:

docker-compose up -d --build

Or pass variables directly without a .env file:

SERVER_URI=your-domain.com SERVER_PORT=443 docker-compose up -d --build

Key Tips for Beginners #

• SSL Certificates: Never bake SSL certs into your Docker image—always mount them as a volume for security and flexibility. For testing, generate a self-signed cert with openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes.
• Separate Containers: For production, split Nginx and Node into separate containers (use Docker Compose's network feature to connect them). This example combines them for simplicity, but splitting makes scaling easier.
• Debugging: If variables aren't replacing correctly, run docker exec -it <container-id> bash to inspect the generated config files and check if environment variables are set with printenv.

内容的提问来源于stack exchange，提问作者total dependent random choice