docs: README 增加「方式二:Docker Compose部署」(完整 compose yaml + docker compose up -d + 等价 docker run)

This commit is contained in:
3970260761 committed 2026-11-08 01:41:23 +08:00
1 parent dddb53b709
commit 9f0bc85465
1 file changed
+112
+112
View File
@@ -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
```
### 方式二:传统部署
#### 环境要求