摘要項(xiàng)目寫完了聯(lián)調(diào)也通過(guò)了但代碼還在服務(wù)器上裸跑今天這篇手把手帶你把商城從開(kāi)發(fā)環(huán)境打包部署到生產(chǎn)服務(wù)器上。Docker 容器化、Nginx 反向代理、Gunicorn 高性能應(yīng)用服務(wù)器、HTTPS 證書配置、域名備案流程一套完整上線流程全走完。三個(gè)核心配置文件Dockerfile、docker-compose.yml、nginx.conf全部完整可用帶詳細(xì)注釋。最后再教你用 AI 寫部署腳本和排錯(cuò)指南省下大量踩坑時(shí)間。開(kāi)發(fā)完了用戶還看不到前 18 天我們把商城從 0 搭到了聯(lián)調(diào)完畢。Django 的 API 寫好了DRF 的接口通了MySQL 8.0 數(shù)據(jù)跑起來(lái)了Redis 緩存也配上了uni-app 前端也對(duì)接完了。但是——你的項(xiàng)目現(xiàn)在是什么狀態(tài)大概率是這樣在服務(wù)器上跑著python manage.py runserver 0.0.0.0:8000裸奔著。這就好比你開(kāi)了一家店招牌沒(méi)掛、門沒(méi)裝、燈沒(méi)亮客人從門口路過(guò)都不知道這是不是正經(jīng)營(yíng)業(yè)。runserver是開(kāi)發(fā)用的調(diào)試服務(wù)器單線程、不安全、不支持并發(fā)。性能不存在的。安全更不存在。那怎么讓你的商城真正跑起來(lái)讓用戶通過(guò)域名 HTTPS 安全地訪問(wèn)到今天的主角來(lái)了Docker Nginx Gunicorn三件套。這三樣?xùn)|西在生產(chǎn)環(huán)境部署 Django 項(xiàng)目里是標(biāo)配學(xué)會(huì)了這個(gè)以后部署任何 Python Web 項(xiàng)目都是同一套流程。三個(gè)家伙各管什么動(dòng)手之前先搞清楚每個(gè)角色負(fù)責(zé)什么這樣后面看配置才不會(huì)一頭霧水。Gunicorn —— 干活的工人Django 自帶的runserver是單線程的來(lái)了 100 個(gè)請(qǐng)求就排隊(duì)等著慢得要死。Gunicorn 是一個(gè) WSGI HTTP Server它能起多個(gè) worker 進(jìn)程真正處理并發(fā)請(qǐng)求。你可以把它理解成一個(gè)車間里的多個(gè)工人同時(shí)處理多個(gè)訂單。Nginx —— 門面擔(dān)當(dāng)Nginx 是整個(gè)架構(gòu)的入口它干三件事反向代理把用戶的請(qǐng)求根據(jù)規(guī)則轉(zhuǎn)發(fā)給后面的 Gunicorn靜態(tài)文件服務(wù)CSS、JS、圖片這些靜態(tài)資源直接由 Nginx 返回不需要經(jīng)過(guò) Django性能提升巨大HTTPS 終端SSL 證書的加解密都在 Nginx 層完成后面用 HTTP 通信就行Nginx 處理靜態(tài)文件的能力非常強(qiáng)單機(jī)輕松應(yīng)對(duì)上萬(wàn)并發(fā)。讓 Django 去處理圖片請(qǐng)求那簡(jiǎn)直是大材小用。Docker —— 一鍵搬家Docker 把你的整個(gè)運(yùn)行環(huán)境打包成一個(gè)鏡像Python 版本、系統(tǒng)依賴、代碼、配置文件全在一起。換服務(wù)器拉鏡像docker compose up -d30 秒搞定。不用再手動(dòng)裝 Python、裝依賴、配環(huán)境變量了。而且環(huán)境一致性有保障——開(kāi)發(fā)、測(cè)試、生產(chǎn)用的都是同一個(gè)鏡像不會(huì)出現(xiàn)在我電腦上能跑的經(jīng)典問(wèn)題。一句話總結(jié)Nginx 負(fù)責(zé)接客和分流 → Gunicorn 負(fù)責(zé)實(shí)際干活 → Docker 負(fù)責(zé)打包整個(gè)環(huán)境。動(dòng)手實(shí)戰(zhàn)從零到上線第一步編寫 DockerfileDockerfile 就是打包說(shuō)明書告訴 Docker 怎么一步步構(gòu)建你的運(yùn)行鏡像。用多階段構(gòu)建來(lái)減小最終鏡像體積# 第一階段構(gòu)建依賴 FROM python:3.11-slim AS builder WORKDIR /app # 安裝系統(tǒng)依賴編譯 MySQL 客戶端等需要 RUN apt-get update apt-get install -y \ gcc \ default-libmysqlclient-dev \ pkg-config \ rm -rf /var/lib/apt/lists/* # 先復(fù)制依賴文件利用 Docker 緩存層 COPY requirements.txt . RUN pip install --no-cache-dir --prefix/install -r requirements.txt # 第二階段運(yùn)行鏡像 FROM python:3.11-slim WORKDIR /app RUN apt-get update apt-get install -y curl rm -rf /var/lib/apt/lists/* # 從構(gòu)建階段拷貝安裝好的 Python 包運(yùn)行時(shí)不需要 gcc 這些編譯工具 COPY --frombuilder /install /usr/local COPY . . # 收集靜態(tài)文件生產(chǎn)模式需要 RUN python manage.py collectstatic --noinput EXPOSE 8000 # 啟動(dòng)命令4 個(gè) worker綁定 0.0.0.0:8000日志輸出到 stdoutdocker logs 可見(jiàn) CMD [gunicorn, shop.wsgi:application, \ --bind, 0.0.0.0:8000, \ --workers, 4, \ --threads, 2, \ --timeout, 120, \ --access-logfile, -, \ --error-logfile, -]幾個(gè)關(guān)鍵點(diǎn)多階段構(gòu)建第一階段裝編譯工具gcc 這些第二階段只拷貝裝好的包。最終鏡像里沒(méi)有編譯工具體積能從 1GB 降到 300MB 左右依賴緩存先 COPY requirements.txt再 COPY 代碼。改了業(yè)務(wù)代碼不會(huì)觸發(fā)重新裝依賴構(gòu)建速度快workers 數(shù)量經(jīng)驗(yàn)公式是2 * CPU核心數(shù) 14 核機(jī)器就配 4-5 個(gè) worker。太多反而會(huì)因上下文切換變慢第二步編寫 docker-compose.yml光有 Dockerfile 還不夠。項(xiàng)目不只有 Django還有 MySQL、Redis 這些服務(wù)。docker-compose.yml是編排清單定義所有服務(wù)和它們之間的關(guān)系一鍵啟動(dòng)version:3.8services:# MySQL 數(shù)據(jù)庫(kù) mysql:image:mysql:8.0restart:alwaysenvironment:MYSQL_ROOT_PASSWORD:${MYSQL_ROOT_PASSWORD}MYSQL_DATABASE:shop_mallTZ:Asia/Shanghaiports:-127.0.0.1:3306:3306# 只監(jiān)聽(tīng)本地不暴露到公網(wǎng)volumes:-mysql_data:/var/lib/mysql# 數(shù)據(jù)持久化command:---character-set-serverutf8mb4---default-authentication-pluginmysql_native_passwordhealthcheck:# 健康檢查MySQL ready 前應(yīng)用不啟動(dòng)test:[CMD,mysqladmin,ping,-h,localhost]interval:10stimeout:5sretries:5# Redis 緩存 redis:image:redis:7-alpinerestart:alwaysports:-127.0.0.1:6379:6379volumes:-redis_data:/datacommand:redis-server--appendonly yes--requirepass ${REDIS_PASSWORD}healthcheck:test:[CMD,redis-cli,-a,${REDIS_PASSWORD},ping]interval:10stimeout:5sretries:5# Django 應(yīng)用 web:build:context:.dockerfile:Dockerfilerestart:alwaysports:-127.0.0.1:8000:8000# 只監(jiān)聽(tīng)本地由 Nginx 轉(zhuǎn)發(fā)volumes:-static_files:/app/static# 靜態(tài)文件共享給 Nginx-media_files:/app/media# 用戶上傳文件env_file:-.env# 環(huán)境變量文件敏感配置不硬編碼environment:-DJANGO_SETTINGS_MODULEshop.settings.prod-DATABASE_HOSTmysql# 指向 compose 內(nèi)的 mysql 服務(wù)-REDIS_HOSTredisdepends_on:mysql:condition:service_healthy# 數(shù)據(jù)庫(kù)就緒后才啟動(dòng)應(yīng)用redis:condition:service_healthy# Nginx 反向代理 nginx:image:nginx:1.25-alpinerestart:alwaysports:-80:80-443:443volumes:-./nginx/nginx.conf:/etc/nginx/conf.d/default.conf:ro-./nginx/ssl:/etc/nginx/ssl:ro# SSL 證書目錄-static_files:/usr/share/nginx/html/static:ro-media_files:/usr/share/nginx/html/media:rodepends_on:-webvolumes:mysql_data:# 命名卷容器刪了重建數(shù)據(jù)不丟redis_data:static_files:media_files:設(shè)計(jì)講究網(wǎng)絡(luò)隔離MySQL 和 Redis 都綁定127.0.0.1外網(wǎng)掃描根本掃不到這兩個(gè)端口。只有容器之間能通信安全性拉滿健康檢查MySQL/Redis 配了 healthcheckweb 的depends_on配condition: service_healthy確保數(shù)據(jù)庫(kù)完全就緒后應(yīng)用才啟動(dòng)——不再踩應(yīng)用啟動(dòng)但數(shù)據(jù)庫(kù)還沒(méi) ready的坑環(huán)境變量外置密碼放.env文件不硬編碼在 yml 里數(shù)據(jù)持久化命名卷保證容器重建數(shù)據(jù)不丟第三步配置 NginxNginx 配置放在nginx/nginx.conf核心塊# 上游 Gunicorn 服務(wù)擴(kuò)容時(shí)加 server web2:8000 即可Nginx 自動(dòng)輪詢 upstream shop_backend { server web:8000; } # HTTP → HTTPS 強(qiáng)制跳轉(zhuǎn) server { listen 80; server_name your-domain.com; # Lets Encrypt 驗(yàn)證路徑 location /.well-known/acme-challenge/ { root /var/www/certbot; } # 其余所有請(qǐng)求跳轉(zhuǎn)到 HTTPS location / { return 301 https://$host$request_uri; } } # HTTPS 主配置 server { listen 443 ssl http2; server_name your-domain.com; ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key /etc/nginx/ssl/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on; # 安全頭 add_header Strict-Transport-Security max-age31536000; includeSubDomains always; add_header X-Content-Type-Options nosniff always; add_header X-Frame-Options SAMEORIGIN always; client_max_body_size 20M; # 允許上傳最大 20M圖片、頭像等 # Gzip 壓縮 gzip on; gzip_types text/plain text/css application/json application/javascript; gzip_min_length 1000; # ---------- 靜態(tài)文件Nginx 直接返回不經(jīng)過(guò) Django---------- location /static/ { alias /usr/share/nginx/html/static/; expires 30d; # 緩存 30 天 add_header Cache-Control public, immutable; access_log off; } # ---------- 用戶上傳的媒體文件 ---------- location /media/ { alias /usr/share/nginx/html/media/; expires 7d; } # ---------- API 請(qǐng)求反向代理到 Gunicorn ---------- location /api/ { proxy_pass http://shop_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_connect_timeout 60s; proxy_read_timeout 120s; } # ---------- 健康檢查端點(diǎn) ---------- location /health/ { proxy_pass http://shop_backend; access_log off; } }核心設(shè)計(jì)upstream 塊定義后端服務(wù)地址擴(kuò)展時(shí)加server web2:8000就行Nginx 自動(dòng)輪詢HTTP 跳 HTTPS所有 80 端口請(qǐng)求 301 重定向到 443確保用戶始終走加密通道靜態(tài)文件分離/static/、/media/由 Nginx 直接返回不經(jīng)過(guò) Django。原來(lái) Django 處理一個(gè)靜態(tài)文件要 50msNginx 只要 2ms安全頭HSTS 強(qiáng)制瀏覽器只用 HTTPS、X-Frame-Options 防點(diǎn)擊劫持、X-Content-Type-Options 防 MIME 嗅探第四步準(zhǔn)備環(huán)境變量文件項(xiàng)目根目錄創(chuàng)建.env管理所有敏感配置# .env - 生產(chǎn)環(huán)境變量千萬(wàn)別提交到 GitDJANGO_SETTINGS_MODULEshop.settings.prodSECRET_KEY你的django-secret-keyDEBUGFalseALLOWED_HOSTSyour-domain.com,www.your-domain.comMYSQL_ROOT_PASSWORDxxxMYSQL_PASSWORDxxxREDIS_PASSWORDxxx記得在.gitignore里加上.env密碼泄露到 GitHub 上可不是鬧著玩的。第五步申請(qǐng) SSL 證書推薦用Let’s Encrypt的免費(fèi)證書certbot申請(qǐng)90 天自動(dòng)續(xù)期# 1. 安裝 certbotaptupdateaptinstall-ycertbot# 2. 臨時(shí)停 Nginx釋放 80 端口給 certbot 驗(yàn)證dockercompose stop nginx# 3. 申請(qǐng)證書standalone 模式certbot certonly--standalone-dyour-domain.com-dwww.your-domain.com# 4. 把證書拷到項(xiàng)目目錄cp/etc/letsencrypt/live/your-domain.com/{fullchain.pem,privkey.pem}./nginx/ssl/# 5. 啟動(dòng)所有服務(wù)dockercompose up-d# 6. 驗(yàn)證自動(dòng)續(xù)期certbot renew --dry-run證書 90 天到期certbot 會(huì)自動(dòng)加定時(shí)任務(wù)續(xù)期。只要 80 端口不長(zhǎng)期關(guān)閉續(xù)期全自動(dòng)。第六步域名 SSL 備案域名這塊新手容易懵完整流程捋一遍買域名阿里云、騰訊云、Cloudflare 都行。.com大概 50-70 元/年.cn更便宜DNS 解析在域名管理后臺(tái)添加 A 記錄把域名指向服務(wù)器公網(wǎng) IPICP 備案國(guó)內(nèi)服務(wù)器必須備案不備案 80/443 端口會(huì)被云廠商封掉在服務(wù)器所在云廠商后臺(tái)提交一般審核 7-20 個(gè)工作日準(zhǔn)備身份證正反面、域名證書、網(wǎng)站負(fù)責(zé)人核驗(yàn)照片、真實(shí)性承諾書公安備案ICP 備案通過(guò)后 30 天內(nèi)去全國(guó)公安互聯(lián)網(wǎng)站安全管理服務(wù)平臺(tái)再備案一次小貼士趕時(shí)間可先用香港或海外服務(wù)器不需要備案但國(guó)內(nèi)用戶訪問(wèn)延遲會(huì)高 50-100ms正式運(yùn)營(yíng)的項(xiàng)目老老實(shí)實(shí)備案不然后面麻煩更多第七步上線檢查清單部署完別急著收工按清單逐條檢查? docker compose ps → 所有服務(wù) running ? 瀏覽器訪問(wèn) https://your-domain.com → 頁(yè)面正常 ? /admin/ 后臺(tái) → 能正常登錄 ? curl https://your-domain.com/api/ → 返回正常 JSON ? 靜態(tài)文件 → CSS/JS/圖片正常F12 看 Network ? 圖片上傳 → 功能正常圖片能顯示 ? HTTPS 證書 → 瀏覽器地址欄有綠色鎖 ? HTTP 跳轉(zhuǎn) → 輸入 http:// 自動(dòng)跳 https:// ? 數(shù)據(jù)持久化 → docker compose restart數(shù)據(jù)還在 ? .env 文件 → 確認(rèn)沒(méi)提交到 Git ? 日志查看 → docker compose logs -f web 能看到實(shí)時(shí)日志部署順序與踩坑經(jīng)驗(yàn)第一次上線部署順序很重要。別一上來(lái)就docker compose up按這個(gè)順序來(lái)1. 服務(wù)器基礎(chǔ)配置防火墻、SSH 密鑰登錄、系統(tǒng)更新 2. 安裝 Docker Docker Compose 3. git clone 拉代碼 4. 配置 .env 環(huán)境變量 5. docker compose build 構(gòu)建鏡像 6. 先啟動(dòng)數(shù)據(jù)庫(kù)和緩存docker compose up -d mysql redis 7. 健康檢查通過(guò)后執(zhí)行遷移docker compose exec web python manage.py migrate 8. 創(chuàng)建管理員docker compose exec web python manage.py createsuperuser 9. 收集靜態(tài)文件docker compose exec web python manage.py collectstatic --noinput 10. 申請(qǐng) SSL 證書 11. 啟動(dòng)全部服務(wù)docker compose up -d 12. 逐項(xiàng)檢查上線清單常見(jiàn)踩坑坑 1應(yīng)用啟動(dòng)后數(shù)據(jù)庫(kù)連接失敗應(yīng)用啟動(dòng)太快MySQL 還沒(méi)初始化好。compose 里配了 healthcheck condition: service_healthy基本可以避免。還有問(wèn)題就在應(yīng)用啟動(dòng)腳本加個(gè)重試邏輯?？?2靜態(tài)文件 404兩種可能忘了執(zhí)行collectstatic或 Nginx 的 alias 路徑和卷映射對(duì)不上。進(jìn)容器ls /app/static/看有沒(méi)有文件再檢查 nginx.conf 里 alias 的路徑?？?3HTTPS 證書無(wú)效或不受信任可能是域名解析沒(méi)生效DNS 緩存最長(zhǎng)等 48 小時(shí)或證書路徑寫錯(cuò)。用openssl s_client -connect your-domain.com:443查看實(shí)際返回的證書?？?4Gunicorn worker 頻繁重啟先docker stats看內(nèi)存夠不夠。2G 內(nèi)存跑 4 個(gè) worker 可能不夠減到 2 個(gè)。再檢查 timeout——有些接口執(zhí)行超過(guò) 120 秒需要調(diào)大。AI 加速讓 AI 幫你寫部署腳本和排錯(cuò)部署和運(yùn)維的活A(yù)I 特別擅長(zhǎng)。三個(gè)實(shí)操場(chǎng)景親測(cè)好用。場(chǎng)景 1生成一鍵部署腳本“我有一個(gè) Django 4.2 項(xiàng)目目錄結(jié)構(gòu)如下[貼 tree 輸出]。服務(wù)器是 Ubuntu 22.04已裝 Docker 24.0。請(qǐng)生成一個(gè)一鍵部署 shell 腳本包含環(huán)境檢查、代碼拉取、鏡像構(gòu)建、數(shù)據(jù)庫(kù)遷移、靜態(tài)文件收集、SSL 證書申請(qǐng)、服務(wù)啟動(dòng)。要求有錯(cuò)誤處理、彩色日志輸出、每一步都有提示?！睅追昼娚梢粋€(gè)完整 bash 腳本比手寫調(diào)試快太多。場(chǎng)景 2排查線上問(wèn)題“我的 Django Docker 部署后訪問(wèn) API 返回 502 Bad Gateway。Nginx 錯(cuò)誤日志[貼日志]。docker compose ps 輸出[貼輸出]。容器內(nèi) gunicorn 日志[貼日志]。請(qǐng)分析原因并給出修復(fù)方案?！盇I 能快速定位根因——可能是 worker 全掛、端口映射錯(cuò)誤、內(nèi)存不足被 OOM kill。場(chǎng)景 3生成監(jiān)控告警腳本“幫我寫一個(gè) Docker 健康監(jiān)控腳本。每 5 分鐘檢查所有容器狀態(tài)如果 web 容器異常則自動(dòng)重啟。連續(xù)重啟 3 次仍失敗就發(fā)告警郵件。用 bash 編寫日志記錄到 /var/log/shop-monitor.log?！边@種運(yùn)維腳本手寫要半小時(shí)AI 幾分鐘搞定質(zhì)量還高。學(xué)完來(lái)練練手日志管理配置 Nginx 的 access_log / error_log 輸出到獨(dú)立目錄用logrotate做日志輪轉(zhuǎn)防止磁盤撐爆可視化監(jiān)控部署 Portainer 做 Docker 可視化管理部署 Watchtower 實(shí)現(xiàn)鏡像自動(dòng)更新負(fù)載均衡修改 docker-compose 啟動(dòng) 2 個(gè) web 實(shí)例配置 Nginx upstream 的輪詢和權(quán)重策略自動(dòng)備份寫定時(shí)腳本每天凌晨mysqldump備份數(shù)據(jù)庫(kù)上傳到遠(yuǎn)程 OSS 存儲(chǔ)Docker 官方文檔docs.docker.comGunicorn 部署 Django 官方指南docs.djangoproject.comLet’s Encrypt。本系列為梅雅達(dá)編程筆記原創(chuàng)首發(fā)于 CSDN。有問(wèn)題評(píng)論區(qū)見(jiàn)