From 9f0bc8546537a85fbaf14059acfa7e08db56a64b Mon Sep 17 00:00:00 2001 From: 3970260761 <3970260761@qq.com> Date: Sun, 8 Nov 2026 01:41:23 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E5=A2=9E=E5=8A=A0=E3=80=8C?= =?UTF-8?q?=E6=96=B9=E5=BC=8F=E4=BA=8C=EF=BC=9ADocker=20Compose=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=E3=80=8D=EF=BC=88=E5=AE=8C=E6=95=B4=20compose=20yaml?= =?UTF-8?q?=20+=20docker=20compose=20up=20-d=20+=20=E7=AD=89=E4=BB=B7=20do?= =?UTF-8?q?cker=20run=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) diff --git a/README.md b/README.md index d0ff6d2..137046b 100644 --- a/README.md +++ b/README.md @@ -117,6 +117,118 @@ http://localhost:8080 首次启动自动完成:前端构建 → 数据库初始化 → Nginx + PHP-FPM 启动。 +### 方式二:Docker Compose部署 + +上面「方式一」使用的仓库根目录 `docker-compose.yml` 完整内容(与仓库文件一致,含全部 ports / volumes / environment): + +```yaml +version: "3.8" + +services: + db: + image: mysql:8.0 + container_name: cardauth-db + restart: unless-stopped + environment: + MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-root_secret_change_me} + MYSQL_DATABASE: ${DB_NAME:-card_auth} + MYSQL_USER: ${DB_USER:-card_auth} + MYSQL_PASSWORD: ${DB_PASS:-card_auth_pass} + volumes: + - mysql_data:/var/lib/mysql + - ./backend/database/schema.sql:/docker-entrypoint-initdb.d/01-schema.sql:ro + command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-time-zone=+08:00 + healthcheck: + test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] + interval: 10s + timeout: 5s + retries: 5 + networks: + - cardauth + + app: + build: . + container_name: cardauth-app + restart: unless-stopped + ports: + - "8881:80" + environment: + APP_ENV: production + APP_DEBUG: "false" + APP_URL: ${APP_URL:-http://localhost:8881} + DB_HOST: db + DB_PORT: "3306" + DB_NAME: ${DB_NAME:-card_auth} + DB_USER: ${DB_USER:-card_auth} + DB_PASS: ${DB_PASS:-card_auth_pass} + DB_PREFIX: ca_ + JWT_SECRET: ${JWT_SECRET:-} + MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-root_secret_change_me} + PAYMENT_TYPE: ${PAYMENT_TYPE:-epay} + PAYMENT_API_URL: ${PAYMENT_API_URL:-} + PAYMENT_APP_ID: ${PAYMENT_APP_ID:-} + PAYMENT_APP_KEY: ${PAYMENT_APP_KEY:-} + depends_on: + db: + condition: service_healthy + networks: + - cardauth + volumes: + # PHP 上传限制:容器内 ini 改动不持久,用挂载固化(容器重建也生效) + - ./php/uploads.ini:/usr/local/etc/php/conf.d/uploads.ini:ro + # 安装包与头像持久化:否则容器重建后已发布版本文件丢失 + - ./backend/public/uploads:/var/www/public/uploads + +volumes: + mysql_data: + driver: local + +networks: + cardauth: + driver: bridge +``` + +启动 / 停止: + +```bash +# 1. 配置环境变量 +cp .env.docker .env +# 编辑 .env,设置 JWT_SECRET 和数据库密码 + +# 2. 启动(与方式一等价) +docker compose up -d + +# 3. 查看状态 / 停止 +docker compose ps +docker compose down +``` + +不使用 Compose 时,等价的最小 `docker run` 启动方式(先建网络与 MySQL,再构建并启动应用): + +```bash +docker network create cardauth + +docker run -d --name cardauth-db --network cardauth \ + -e MYSQL_ROOT_PASSWORD=root_secret_change_me \ + -e MYSQL_DATABASE=card_auth \ + -e MYSQL_USER=card_auth \ + -e MYSQL_PASSWORD=card_auth_pass \ + -v cardauth_mysql_data:/var/lib/mysql \ + -v ./backend/database/schema.sql:/docker-entrypoint-initdb.d/01-schema.sql:ro \ + mysql:8.0 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --default-time-zone=+08:00 + +docker build -t cardauth-app:latest . + +docker run -d --name cardauth-app --network cardauth -p 8881:80 \ + -e APP_ENV=production -e APP_DEBUG=false \ + -e APP_URL=http://localhost:8881 \ + -e DB_HOST=cardauth-db -e DB_PORT=3306 \ + -e DB_NAME=card_auth -e DB_USER=card_auth -e DB_PASS=card_auth_pass \ + -e DB_PREFIX=ca_ -e JWT_SECRET=change_me_to_random_64_chars \ + -v ./backend/public/uploads:/var/www/public/uploads \ + cardauth-app:latest +``` + ### 方式二:传统部署 #### 环境要求