{"id":31437,"date":"2026-09-28T10:00:00","date_gmt":"2026-09-28T02:00:00","guid":{"rendered":"https:\/\/cn.hostease.com\/blog\/uncategorized\/docker-compose-multi-service-deployment\/"},"modified":"2026-09-29T14:39:11","modified_gmt":"2026-09-29T06:39:11","slug":"docker-compose-production-troubleshooting","status":"publish","type":"post","link":"https:\/\/cn.hostease.com\/blog\/tutorials\/docker-compose-production-troubleshooting\/","title":{"rendered":"Docker Compose \u751f\u4ea7\u6545\u969c\u6392\u67e5\uff1a\u591a\u670d\u52a1\u90e8\u7f72\u7a33\u5b9a\u6027\u6e05\u5355"},"content":{"rendered":"

\"Docker<\/p>\n

Docker Compose \u751f\u4ea7\u6545\u969c\u6392\u67e5\u7684\u91cd\u70b9\uff0c\u4e0d\u662f\u518d\u6559\u4f60\u5982\u4f55\u5199\u7b2c\u4e00\u4efd compose.yaml<\/code>\uff0c\u800c\u662f\u5e2e\u52a9\u4f60\u5728\u670d\u52a1\u5df2\u7ecf\u4e0a\u7ebf\u540e\uff0c\u5feb\u901f\u5224\u65ad\u95ee\u9898\u51fa\u5728\u7aef\u53e3\u3001\u7f51\u7edc\u3001\u6570\u636e\u5377\u3001\u542f\u52a8\u987a\u5e8f\u8fd8\u662f\u8d44\u6e90\u74f6\u9888\u3002\u5f88\u591a\u591a\u670d\u52a1\u5e94\u7528\u5728\u5f00\u53d1\u73af\u5883\u8fd0\u884c\u6b63\u5e38\uff0c\u8fc1\u79fb\u5230 [VPS](https:\/\/cn.hostease.com\/vps\/)\uff08[\u865a\u62df\u4e13\u7528\u670d\u52a1\u5668](https:\/\/cn.hostease.com\/vps\/)\uff09\u6216[\u72ec\u7acb\u670d\u52a1\u5668](https:\/\/cn.hostease.com\/dedicated-server\/)\u540e\u5374\u9891\u7e41\u51fa\u73b0 502\u3001\u6570\u636e\u5e93\u8fde\u63a5\u5931\u8d25\u3001\u5bb9\u5668\u53cd\u590d\u91cd\u542f\uff0c\u8fd9\u901a\u5e38\u4e0d\u662f\u5355\u4e2a\u914d\u7f6e\u9879\u9519\u8bef\uff0c\u800c\u662f\u90e8\u7f72\u94fe\u8def\u7f3a\u5c11\u7a33\u5b9a\u6027\u6e05\u5355\u3002<\/p>\n

\u672c\u6587\u4ee5\u4e00\u4e2a\u5e38\u89c1\u7684 Web \u5e94\u7528\u6808\u4e3a\u4f8b\uff1a\u53cd\u5411\u4ee3\u7406\u3001\u5e94\u7528\u5bb9\u5668\u3001\u6570\u636e\u5e93\u3001\u7f13\u5b58\u548c\u8ba1\u5212\u4efb\u52a1\u3002\u6211\u4eec\u4e0d\u91cd\u590d\u8bb2\u57fa\u7840\u7f16\u6392\u8bed\u6cd5\uff0c\u800c\u662f\u56f4\u7ed5\u771f\u5b9e\u751f\u4ea7\u6545\u969c\u62c6\u89e3\u6392\u67e5\u987a\u5e8f\u3002\u4f60\u53ef\u4ee5\u628a\u5b83\u5f53\u4f5c\u4e0a\u7ebf\u524d\u540e\u7684\u68c0\u67e5\u8868\uff0c\u914d\u5408 \u670d\u52a1\u5668\u8fd0\u7ef4\u6307\u5357<\/a>\u3001\u7f51\u7ad9\u6027\u80fd\u4f18\u5316\u6307\u5357<\/a> \u4e00\u8d77\u4f7f\u7528\uff0c\u5148\u5b9a\u4f4d\u95ee\u9898\uff0c\u518d\u51b3\u5b9a\u662f\u5426\u9700\u8981\u6269\u5bb9\u6216\u8c03\u6574\u67b6\u6784\u3002<\/p>\n

\u5148\u786e\u8ba4\u6545\u969c\u8fb9\u754c\uff1a\u662f\u5bb9\u5668\u95ee\u9898\u8fd8\u662f\u5bbf\u4e3b\u673a\u95ee\u9898<\/h2>\n

\u751f\u4ea7\u73af\u5883\u6392\u969c\u6700\u5bb9\u6613\u8d70\u504f\u7684\u5730\u65b9\uff0c\u662f\u4e00\u5f00\u59cb\u5c31\u76ef\u7740\u67d0\u4e2a\u670d\u52a1\u65e5\u5fd7\u3002\u66f4\u7a33\u59a5\u7684\u505a\u6cd5\u662f\u5148\u5224\u65ad\u6545\u969c\u8303\u56f4\uff1a\u53ea\u6709\u4e00\u4e2a\u5bb9\u5668\u5f02\u5e38\uff0c\u8fd8\u662f\u6574\u53f0\u670d\u52a1\u5668\u7684\u7f51\u7edc\u3001\u78c1\u76d8\u3001\u5185\u5b58\u90fd\u5728\u544a\u8b66\u3002\u8fb9\u754c\u5224\u65ad\u6e05\u695a\u540e\uff0c\u540e\u7eed\u547d\u4ee4\u624d\u6709\u610f\u4e49\u3002<\/p>\n

\ndocker compose ps\n\ndocker compose logs --tail=100 app\n\nfree -h\ndf -h\ndocker system df\n\ndocker stats --no-stream\n<\/pre>\n
\u5982\u679c docker compose ps<\/code> \u4e2d\u53ea\u6709 app<\/code> \u670d\u52a1\u4e0d\u65ad\u91cd\u542f\uff0c\u800c\u6570\u636e\u5e93\u548c\u7f13\u5b58\u7a33\u5b9a\uff0c\u4f18\u5148\u68c0\u67e5\u5e94\u7528\u914d\u7f6e\u3001\u4f9d\u8d56\u8fde\u63a5\u548c\u5065\u5eb7\u68c0\u67e5\u3002\u5982\u679c\u591a\u4e2a\u5bb9\u5668\u540c\u65f6\u5f02\u5e38\uff0c\u4e14 df -h<\/code> \u663e\u793a\u78c1\u76d8\u5360\u7528\u8d85\u8fc7 90%\uff0c\u5c31\u5e94\u5148\u6e05\u7406\u65e5\u5fd7\u3001\u955c\u50cf\u7f13\u5b58\u6216\u6269\u5bb9\u78c1\u76d8\uff0c\u800c\u4e0d\u662f\u53cd\u590d\u91cd\u542f\u5e94\u7528\u3002<\/p>\n
\u4e0a\u7ebf\u540e\u7684\u7b2c\u4e00\u6761\u539f\u5219\u662f\u4fdd\u7559\u8bc1\u636e\u3002\u4e0d\u8981\u5728\u6ca1\u770b\u65e5\u5fd7\u524d\u6267\u884c docker compose down -v<\/code>\uff0c\u8fd9\u4e2a\u547d\u4ee4\u4f1a\u5220\u9664\u5bb9\u5668\u5e76\u53ef\u80fd\u6e05\u7406\u6570\u636e\u5377\u3002\u6392\u969c\u9636\u6bb5\u5efa\u8bae\u53ea\u4f7f\u7528 restart<\/code>\u3001logs<\/code>\u3001exec<\/code>\u3001ps<\/code> \u8fd9\u7c7b\u4f4e\u98ce\u9669\u547d\u4ee4\u3002<\/p>\n
\u7aef\u53e3\u548c\u53cd\u5411\u4ee3\u7406\uff1a502 \u4e0e\u65e0\u6cd5\u8bbf\u95ee\u7684\u9ad8\u9891\u6765\u6e90<\/h2>\n
\u6d4f\u89c8\u5668\u6253\u4e0d\u5f00\u9875\u9762\u65f6\uff0c\u95ee\u9898\u4e0d\u4e00\u5b9a\u5728\u5e94\u7528\u4ee3\u7801\u3002\u5bf9\u5916\u8bbf\u95ee\u94fe\u8def\u901a\u5e38\u662f\uff1a\u516c\u7f51\u8bf7\u6c42\u8fdb\u5165\u670d\u52a1\u5668 80\/443 \u7aef\u53e3\uff0c\u518d\u7531 Nginx \u6216\u5176\u4ed6\u53cd\u5411\u4ee3\u7406\u8f6c\u53d1\u5230\u5185\u90e8\u5e94\u7528\u7aef\u53e3\u3002\u53ea\u8981\u5176\u4e2d\u4e00\u4e2a\u7aef\u53e3\u6620\u5c04\u3001\u76d1\u542c\u5730\u5740\u6216\u5bb9\u5668\u7f51\u7edc\u5199\u9519\uff0c\u5c31\u4f1a\u51fa\u73b0 502\u3001\u8fde\u63a5\u8d85\u65f6\u6216\u7a7a\u767d\u9875\u3002<\/p>\n
\nss -lntp | grep -E ':80|:443'\n\ndocker compose exec nginx curl -I http:\/\/app:3000\/health\n\ncurl -I http:\/\/127.0.0.1\n<\/pre>\n
\u5982\u679c\u5728 nginx<\/code> \u5bb9\u5668\u5185\u8bbf\u95ee http:\/\/app:3000\/health<\/code> \u5931\u8d25\uff0c\u8bf4\u660e\u95ee\u9898\u5728 Compose \u5185\u90e8\u7f51\u7edc\u6216\u5e94\u7528\u76d1\u542c\u5730\u5740\uff1b\u5982\u679c\u5bb9\u5668\u5185\u8bbf\u95ee\u6210\u529f\uff0c\u4f46\u5bbf\u4e3b\u673a\u8bbf\u95ee\u5931\u8d25\uff0c\u5219\u91cd\u70b9\u68c0\u67e5\u7aef\u53e3\u6620\u5c04\u3001\u9632\u706b\u5899\u548c\u53cd\u5411\u4ee3\u7406\u914d\u7f6e\u3002<\/p>\n
\u751f\u4ea7\u914d\u7f6e\u4e2d\uff0c\u6570\u636e\u5e93\u548c\u7f13\u5b58\u4e0d\u5efa\u8bae\u6620\u5c04\u5230 0.0.0.0<\/code>\u3002\u66f4\u5b89\u5168\u7684\u5199\u6cd5\u662f\u8ba9\u5b83\u4eec\u53ea\u5728\u5185\u90e8\u7f51\u7edc\u901a\u4fe1\uff0c\u5fc5\u8981\u65f6\u4ec5\u7ed1\u5b9a\u672c\u673a\u56de\u73af\u5730\u5740\uff1a<\/p>\n
\nservices:\n  db:\n    image: mysql:8.0\n    ports:\n      - \"127.0.0.1:3306:3306\"\n    networks:\n      - backend\n\n  app:\n    expose:\n      - \"3000\"\n    networks:\n      - frontend\n      - backend\n<\/pre>\n
\u8fd9\u79cd\u65b9\u5f0f\u53ef\u4ee5\u51cf\u5c11\u6570\u636e\u5e93\u88ab\u516c\u7f51\u626b\u63cf\u7684\u98ce\u9669\u3002\u82e5\u4e1a\u52a1\u8fd8\u9700\u8981 HTTPS\uff0c\u53ef\u4ee5\u5728\u53cd\u5411\u4ee3\u7406\u5c42\u914d\u7f6e SSL\uff08\u5b89\u5168\u4f20\u8f93\u534f\u8bae\uff09\u8bc1\u4e66\uff0c\u5e76\u53c2\u8003 \u7f51\u7ad9\u4f18\u5316\u4e0e\u5b89\u5168\u914d\u7f6e<\/a> \u4e2d\u7684\u8bc1\u4e66\u66f4\u65b0\u548c\u7f13\u5b58\u7b56\u7565\uff0c\u907f\u514d\u8bc1\u4e66\u8fc7\u671f\u5bfc\u81f4\u8bbf\u95ee\u4e2d\u65ad\u3002<\/p>\n
\"Docker<\/p>\n
\u670d\u52a1\u4f9d\u8d56\uff1adepends_on \u4e0d\u7b49\u4e8e\u771f\u6b63\u53ef\u7528<\/h2>\n
\u5f88\u591a\u751f\u4ea7\u4e8b\u6545\u53d1\u751f\u5728\u91cd\u542f\u540e\uff1a\u5bb9\u5668\u72b6\u6001\u663e\u793a\u5df2\u7ecf\u542f\u52a8\uff0c\u4f46\u5e94\u7528\u9a6c\u4e0a\u62a5\u6570\u636e\u5e93\u8fde\u63a5\u5931\u8d25\u3002\u539f\u56e0\u662f depends_on<\/code> \u9ed8\u8ba4\u53ea\u4fdd\u8bc1\u5bb9\u5668\u542f\u52a8\u987a\u5e8f\uff0c\u4e0d\u4ee3\u8868\u6570\u636e\u5e93\u521d\u59cb\u5316\u3001\u7f13\u5b58\u52a0\u8f7d\u6216\u8fc1\u79fb\u4efb\u52a1\u5df2\u7ecf\u5b8c\u6210\u3002\u751f\u4ea7\u73af\u5883\u5e94\u628a\u4f9d\u8d56\u68c0\u67e5\u5199\u6210\u53ef\u9a8c\u8bc1\u7684\u5065\u5eb7\u72b6\u6001\u3002<\/p>\n
\nservices:\n  db:\n    image: mysql:8.0\n    healthcheck:\n      test: [\"CMD\", \"mysqladmin\", \"ping\", \"-h\", \"localhost\"]\n      interval: 10s\n      timeout: 5s\n      retries: 5\n      start_period: 30s\n\n  app:\n    depends_on:\n      db:\n        condition: service_healthy\n    restart: unless-stopped\n<\/pre>\n
\u5065\u5eb7\u68c0\u67e5\u8981\u5199\u5f97\u8db3\u591f\u5177\u4f53\u3002\u5bf9 Web \u5e94\u7528\u6765\u8bf4\uff0c\u5355\u7eaf\u68c0\u67e5\u8fdb\u7a0b\u5b58\u5728\u5e76\u4e0d\u591f\uff0c\u5efa\u8bae\u63d0\u4f9b \/health<\/code> \u63a5\u53e3\uff0c\u81f3\u5c11\u9a8c\u8bc1\u5e94\u7528\u8fdb\u7a0b\u3001\u6570\u636e\u5e93\u8fde\u63a5\u548c\u7f13\u5b58\u8fde\u63a5\u4e09\u9879\u3002\u63a5\u53e3\u8fd4\u56de 200 \u65f6\u518d\u8ba4\u4e3a\u670d\u52a1\u53ef\u7528\uff0c\u8fd4\u56de 500 \u65f6\u8ba9\u65e5\u5fd7\u660e\u786e\u6307\u51fa\u5931\u8d25\u4f9d\u8d56\u3002<\/p>\n
\u5982\u679c\u4f60\u7684\u5e94\u7528\u542f\u52a8\u65f6\u9700\u8981\u6267\u884c\u6570\u636e\u5e93\u8fc1\u79fb\uff0c\u5efa\u8bae\u62c6\u6210\u4e00\u6b21\u6027\u4efb\u52a1\uff0c\u800c\u4e0d\u662f\u8ba9\u4e3b\u5e94\u7528\u5bb9\u5668\u5728\u542f\u52a8\u811a\u672c\u91cc\u9690\u5f0f\u6267\u884c\u3002\u8fd9\u6837\u53ef\u4ee5\u907f\u514d\u591a\u4e2a\u526f\u672c\u540c\u65f6\u8fc1\u79fb\uff0c\u4e5f\u4fbf\u4e8e\u5728\u5931\u8d25\u65f6\u5355\u72ec\u56de\u6eda\u3002<\/p>\n
\ndocker compose run --rm app npm run migrate\ndocker compose up -d app\n<\/pre>\n
\u6570\u636e\u5377\u4e0e\u5907\u4efd\uff1a\u5148\u4fdd\u62a4\u6570\u636e\uff0c\u518d\u5904\u7406\u5bb9\u5668<\/h2>\n
\u5bb9\u5668\u53ef\u4ee5\u5220\u9664\u91cd\u5efa\uff0c\u6570\u636e\u5377\u4e0d\u80fd\u968f\u610f\u5904\u7406\u3002\u751f\u4ea7\u73af\u5883\u4e2d\uff0c\u6570\u636e\u5e93\u3001\u4e0a\u4f20\u6587\u4ef6\u3001\u7f13\u5b58\u6301\u4e45\u5316\u76ee\u5f55\u548c\u8bc1\u4e66\u76ee\u5f55\u90fd\u5e94\u660e\u786e\u5199\u5165\u547d\u540d\u5377\u6216\u5bbf\u4e3b\u673a\u76ee\u5f55\uff0c\u5e76\u5728\u6587\u6863\u4e2d\u6807\u6ce8\u7528\u9014\u3002\u6392\u969c\u65f6\u770b\u5230 volumes<\/code> \u914d\u7f6e\uff0c\u5148\u5224\u65ad\u5b83\u627f\u8f7d\u7684\u662f\u4e34\u65f6\u7f13\u5b58\u8fd8\u662f\u6838\u5fc3\u6570\u636e\u3002<\/p>\n
\ndocker volume ls | grep myapp\n\ndocker volume inspect myapp_db_data\n\ndocker compose exec -T db mysqldump -u root -p\"$MYSQL_ROOT_PASS\" myapp \\\n  | gzip > backups\/myapp_$(date +%Y%m%d_%H%M).sql.gz\n<\/pre>\n
\u4e0a\u7ebf\u524d\u81f3\u5c11\u51c6\u5907\u4e24\u7c7b\u5907\u4efd\uff1a\u6570\u636e\u5e93\u903b\u8f91\u5907\u4efd\u548c\u6587\u4ef6\u76ee\u5f55\u5907\u4efd\u3002\u6570\u636e\u5e93\u5efa\u8bae\u6bcf\u5929\u81ea\u52a8\u5907\u4efd\u4e00\u6b21\uff0c\u4fdd\u7559 7 \u5230 14 \u5929\uff1b\u7528\u6237\u4e0a\u4f20\u76ee\u5f55\u6309\u4e1a\u52a1\u9891\u7387\u51b3\u5b9a\uff0c\u53ef\u4ee5\u6bcf\u5929\u6216\u6bcf 6 \u5c0f\u65f6\u540c\u6b65\u4e00\u6b21\u3002\u6062\u590d\u6f14\u7ec3\u540c\u6837\u91cd\u8981\uff0c\u81f3\u5c11\u6bcf\u6708\u5728\u6d4b\u8bd5\u73af\u5883\u6267\u884c\u4e00\u6b21\u5bfc\u5165\uff0c\u786e\u8ba4\u5907\u4efd\u6587\u4ef6\u4e0d\u662f\u7a7a\u5305\u6216\u635f\u574f\u6587\u4ef6\u3002<\/p>\n
\u5f53\u78c1\u76d8\u7a7a\u95f4\u4e0d\u8db3\u65f6\uff0c\u5148\u7528 docker system df<\/code> \u5224\u65ad\u955c\u50cf\u3001\u6784\u5efa\u7f13\u5b58\u548c\u65e5\u5fd7\u5360\u7528\uff0c\u4e0d\u8981\u76f4\u63a5\u5220\u9664\u672a\u77e5\u6570\u636e\u5377\u3002\u6e05\u7406\u524d\u53ef\u4ee5\u6267\u884c\uff1a<\/p>\n
\ndocker system prune -af\n\nlogging:\n  driver: json-file\n  options:\n    max-size: \"20m\"\n    max-file: \"5\"\n<\/pre>\n
\"Docker<\/p>\n
\u7f51\u7edc\u3001DNS \u548c\u73af\u5883\u53d8\u91cf\uff1a\u6392\u67e5\u670d\u52a1\u95f4\u8fde\u63a5\u5931\u8d25<\/h2>\n
Compose \u7f51\u7edc\u5185\u7684\u670d\u52a1\u540d\u53ef\u4ee5\u76f4\u63a5\u4f5c\u4e3a DNS\uff08\u57df\u540d\u7cfb\u7edf\uff09\u4e3b\u673a\u540d\u4f7f\u7528\u3002\u4f8b\u5982\u5e94\u7528\u8fde\u63a5\u6570\u636e\u5e93\u65f6\u5e94\u5199 DB_HOST=db<\/code>\uff0c\u800c\u4e0d\u662f localhost<\/code>\u3002\u5728\u5bb9\u5668\u91cc\uff0clocalhost<\/code> \u6307\u5411\u5bb9\u5668\u81ea\u5df1\uff0c\u8fd9\u4e5f\u662f\u6570\u636e\u5e93\u8fde\u63a5\u5931\u8d25\u7684\u5e38\u89c1\u539f\u56e0\u3002<\/p>\n
\ndocker compose exec app getent hosts db\n\ndocker compose exec app nc -zv db 3306\n\ndocker compose exec app env | grep -E 'DB_HOST|DB_PORT|REDIS'\n<\/pre>\n
\u5982\u679c\u670d\u52a1\u540d\u65e0\u6cd5\u89e3\u6790\uff0c\u68c0\u67e5\u4e24\u4e2a\u670d\u52a1\u662f\u5426\u52a0\u5165\u540c\u4e00\u4e2a network\uff1b\u5982\u679c\u7aef\u53e3\u4e0d\u901a\uff0c\u68c0\u67e5\u6570\u636e\u5e93\u662f\u5426\u76d1\u542c\u5728\u5bb9\u5668\u5185\u90e8\u7aef\u53e3\uff1b\u5982\u679c\u73af\u5883\u53d8\u91cf\u4e3a\u7a7a\uff0c\u91cd\u70b9\u6392\u67e5 .env<\/code>\u3001env_file<\/code> \u548c CI\/CD \u6ce8\u5165\u53d8\u91cf\u662f\u5426\u4e00\u81f4\u3002\u751f\u4ea7\u73af\u5883\u4e0d\u8981\u628a\u5f00\u53d1\u73af\u5883\u7684 .env<\/code> \u76f4\u63a5\u590d\u5236\u5230\u670d\u52a1\u5668\uff0c\u5426\u5219\u5f88\u5bb9\u6613\u51fa\u73b0\u8fde\u63a5\u6d4b\u8bd5\u5e93\u3001\u8c03\u8bd5\u5f00\u5173\u672a\u5173\u95ed\u3001\u5bc6\u94a5\u6cc4\u9732\u7b49\u95ee\u9898\u3002<\/p>\n
\u4e0a\u7ebf\u524d\u7a33\u5b9a\u6027\u6e05\u5355<\/h2>\n
\u628a\u4e0a\u9762\u7684\u6392\u67e5\u7ecf\u9a8c\u524d\u79fb\u5230\u4e0a\u7ebf\u524d\uff0c\u53ef\u4ee5\u51cf\u5c11\u5927\u90e8\u5206\u91cd\u590d\u6545\u969c\u3002\u4e0b\u9762\u8fd9\u4efd\u6e05\u5355\u9002\u5408\u5728\u9996\u6b21\u90e8\u7f72\u3001\u7248\u672c\u66f4\u65b0\u548c\u670d\u52a1\u5668\u8fc1\u79fb\u524d\u6267\u884c\u3002<\/p>\n