Docker 安裝 Nginx的詳細步驟

# Docker 安裝 Nginx 的詳細步驟

## 前言

Nginx 是一款高性能的 Web 服務器和反向代理服務器，以其高并發處理能力和低內存消耗而聞名。Docker 是一種輕量級的容器化技術，能夠快速部署和運行應用程序。將 Nginx 運行在 Docker 容器中，可以簡化配置、提高可移植性，并實現快速部署。

本文將詳細介紹如何使用 Docker 安裝和配置 Nginx，包括以下內容：

1. Docker 環境準備
2. 拉取 Nginx 鏡像
3. 運行 Nginx 容器
4. 自定義 Nginx 配置
5. 掛載本地目錄
6. 配置 SSL 證書
7. 常見問題排查
8. 性能優化建議

---

## 1. Docker 環境準備

在開始之前，請確保您的系統已安裝 Docker。以下是不同操作系統下的安裝方法：

### Linux 系統安裝 Docker

```bash
# 卸載舊版本（如有）
sudo apt-get remove docker docker-engine docker.io containerd runc

# 更新軟件包索引
sudo apt-get update

# 安裝依賴包
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加 Docker 官方 GPG 密鑰
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 設置穩定版倉庫
echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安裝 Docker 引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

# 驗證安裝
sudo docker run hello-world

macOS 安裝 Docker

1. 下載 Docker Desktop for Mac：https://www.docker.com/products/docker-desktop
2. 雙擊下載的 .dmg 文件并拖拽到 Applications 文件夾
3. 啟動 Docker 應用并完成初始化設置

Windows 安裝 Docker

1. 下載 Docker Desktop for Windows：https://www.docker.com/products/docker-desktop
2. 運行安裝程序并按照向導完成安裝
3. 啟動 Docker Desktop 并等待服務就緒

2. 拉取 Nginx 鏡像

Docker Hub 提供了官方 Nginx 鏡像，我們可以直接拉?。?/p>

# 拉取最新版 Nginx 鏡像
docker pull nginx:latest

# 查看已下載的鏡像
docker images

如果需要特定版本的 Nginx，可以指定標簽：

# 拉取指定版本的 Nginx
docker pull nginx:1.21.6

3. 運行 Nginx 容器

基礎運行命令

# 運行一個簡單的 Nginx 容器
docker run --name my-nginx -d -p 8080:80 nginx

參數說明： - --name my-nginx：為容器指定名稱 - -d：后臺運行容器 - -p 8080:80：將主機的 8080 端口映射到容器的 80 端口

驗證容器運行

# 查看運行中的容器
docker ps

# 檢查容器日志
docker logs my-nginx

現在，您可以通過瀏覽器訪問 http://localhost:8080 看到 Nginx 的歡迎頁面。

4. 自定義 Nginx 配置

方法一：直接進入容器修改

# 進入運行中的容器
docker exec -it my-nginx /bin/bash

# 容器內編輯配置文件
apt-get update && apt-get install vim
vim /etc/nginx/nginx.conf

注意：這種方法修改的配置在容器重啟后會丟失，僅適用于臨時測試。

方法二：使用自定義配置文件（推薦）

1. 在本地創建配置文件目錄：

mkdir -p ~/nginx-config/conf.d

1. 創建自定義配置文件：

vim ~/nginx-config/conf.d/default.conf

示例配置內容：

server {
    listen       80;
    server_name  localhost;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }

    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

1. 運行容器時掛載配置文件：

docker run --name my-nginx \
    -v ~/nginx-config/conf.d:/etc/nginx/conf.d \
    -d -p 8080:80 nginx

5. 掛載本地目錄

掛載 HTML 目錄

# 創建本地 HTML 目錄
mkdir -p ~/nginx-html

# 創建測試頁面
echo "<h1>Hello from Docker Nginx</h1>" > ~/nginx-html/index.html

# 運行容器并掛載目錄
docker run --name my-nginx \
    -v ~/nginx-html:/usr/share/nginx/html \
    -v ~/nginx-config/conf.d:/etc/nginx/conf.d \
    -d -p 8080:80 nginx

掛載日志文件

# 創建日志目錄
mkdir -p ~/nginx-logs

# 運行容器并掛載日志
docker run --name my-nginx \
    -v ~/nginx-html:/usr/share/nginx/html \
    -v ~/nginx-config/conf.d:/etc/nginx/conf.d \
    -v ~/nginx-logs:/var/log/nginx \
    -d -p 8080:80 nginx

6. 配置 SSL 證書

準備 SSL 證書

將您的證書文件（cert.pem 和 key.pem）放入本地目錄：

mkdir -p ~/nginx-ssl
# 將您的證書文件復制到此目錄

修改 Nginx 配置

創建 SSL 配置文件：

vim ~/nginx-config/conf.d/ssl.conf

內容示例：

server {
    listen       443 ssl;
    server_name  localhost;

    ssl_certificate      /etc/nginx/ssl/cert.pem;
    ssl_certificate_key  /etc/nginx/ssl/key.pem;

    ssl_session_cache    shared:SSL:1m;
    ssl_session_timeout  5m;

    ssl_ciphers  HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers  on;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }
}

運行支持 SSL 的容器

docker run --name my-nginx-ssl \
    -v ~/nginx-html:/usr/share/nginx/html \
    -v ~/nginx-config/conf.d:/etc/nginx/conf.d \
    -v ~/nginx-ssl:/etc/nginx/ssl \
    -v ~/nginx-logs:/var/log/nginx \
    -d -p 80:80 -p 443:443 nginx

7. 常見問題排查

容器啟動失敗

# 查看容器日志
docker logs my-nginx

# 常見錯誤：端口沖突
# 解決方案：更改主機端口或停止占用端口的服務

配置文件錯誤

# 測試 Nginx 配置
docker exec my-nginx nginx -t

# 如果測試失敗，檢查配置文件語法

權限問題

# 如果掛載的文件出現權限問題，可以：
# 1. 確保文件權限正確
# 2. 運行容器時添加 --user 參數
docker run --user 1000:1000 ...

8. 性能優化建議

調整工作進程數

# 在 nginx.conf 中設置
worker_processes auto; # 自動根據 CPU 核心數設置

啟用 Gzip 壓縮

gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

調整連接限制

events {
    worker_connections 1024;
    multi_accept on;
}

使用靜態資源緩存

location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 30d;
    add_header Cache-Control "public, no-transform";
}

總結

通過 Docker 運行 Nginx 提供了諸多優勢： - 快速部署和版本管理 - 環境隔離和安全性 - 配置持久化和易于遷移 - 資源利用高效

本文詳細介紹了從基礎安裝到高級配置的全過程，您現在應該能夠： 1. 在 Docker 中運行 Nginx 容器 2. 自定義 Nginx 配置 3. 掛載本地文件和目錄 4. 配置 SSL 加密 5. 排查常見問題 6. 進行基本的性能優化

希望這篇指南能幫助您順利在 Docker 環境中部署和管理 Nginx 服務器！ “`