11

2025-09-06 11:58:18 +08:00
commit 8d34972119
1483 changed files with 141190 additions and 0 deletions
--- a/docker-deploy-guide.md
+++ b/docker-deploy-guide.md
@@ -0,0 +1,188 @@
+# Docker容器化部署指南
+
+## 支付证书问题解决方案
+
+本项目已经解决了Docker容器中支付证书路径失效的问题，支持多种证书加载方式。
+
+## 目录结构
+
+```
+project-root/
+├── Dockerfile
+├── docker-compose.yml
+├── certs/                    # 证书目录（需要手动创建）
+│   ├── wechat/              # 微信支付证书
+│   │   ├── apiclient_key.pem
+│   │   ├── apiclient_cert.pem
+│   │   └── wechatpay_cert.pem
+│   └── alipay/              # 支付宝证书
+│       ├── app_private_key.pem
+│       ├── appCertPublicKey.crt
+│       ├── alipayCertPublicKey.crt
+│       └── alipayRootCert.crt
+├── logs/                    # 日志目录
+├── uploads/                 # 上传文件目录
+└── src/
+```
+
+## 部署步骤
+
+### 1. 准备证书文件
+
+创建证书目录并放置证书文件：
+
+```bash
+# 创建证书目录
+mkdir -p certs/wechat
+mkdir -p certs/alipay
+
+# 复制微信支付证书到对应目录
+cp /path/to/your/apiclient_key.pem certs/wechat/
+cp /path/to/your/apiclient_cert.pem certs/wechat/
+cp /path/to/your/wechatpay_cert.pem certs/wechat/
+
+# 复制支付宝证书到对应目录
+cp /path/to/your/app_private_key.pem certs/alipay/
+cp /path/to/your/appCertPublicKey.crt certs/alipay/
+cp /path/to/your/alipayCertPublicKey.crt certs/alipay/
+cp /path/to/your/alipayRootCert.crt certs/alipay/
+
+# 设置证书文件权限（只读）
+chmod -R 444 certs/
+```
+
+### 2. 配置环境变量
+
+创建 `.env` 文件（可选）：
+
+```bash
+# 应用配置
+SPRING_PROFILES_ACTIVE=prod
+JAVA_OPTS=-Xms512m -Xmx1024m
+
+# 数据库配置
+MYSQL_ROOT_PASSWORD=root123456
+MYSQL_DATABASE=modules
+MYSQL_USER=modules
+MYSQL_PASSWORD=8YdLnk7KsPAyDXGA
+
+# Redis配置
+REDIS_PASSWORD=redis_WSDb88
+```
+
+### 3. 构建和启动
+
+```bash
+# 构建应用
+mvn clean package -DskipTests
+
+# 启动所有服务
+docker-compose up -d
+
+# 查看服务状态
+docker-compose ps
+
+# 查看应用日志
+docker-compose logs -f cms-app
+```
+
+### 4. 验证部署
+
+```bash
+# 检查应用健康状态
+curl http://localhost:9200/actuator/health
+
+# 检查证书是否正确加载
+docker exec cms-java-app ls -la /app/certs/
+```
+
+## 证书加载模式
+
+### 开发环境 (CLASSPATH)
+- 证书文件放在 `src/main/resources/certs/` 目录下
+- 打包时会包含在jar包中
+- 适合开发和测试环境
+
+### 生产环境 (VOLUME)
+- 证书文件通过Docker挂载卷加载
+- 证书文件在宿主机上，挂载到容器的 `/app/certs` 目录
+- 支持证书文件的动态更新（重启容器后生效）
+
+### 文件系统模式 (FILESYSTEM)
+- 直接从文件系统路径加载证书
+- 适合传统部署方式
+
+## 配置说明
+
+### application.yml 配置
+
+```yaml
+certificate:
+  load-mode: VOLUME  # 证书加载模式
+  cert-root-path: /app/certs  # 证书根目录
+  
+  wechat-pay:
+    dev:
+      api-v3-key: "your-api-v3-key"
+      private-key-file: "apiclient_key.pem"
+      apiclient-cert-file: "apiclient_cert.pem"
+      wechatpay-cert-file: "wechatpay_cert.pem"
+```
+
+### 环境特定配置
+
+- **开发环境**: `application-dev.yml` - 使用CLASSPATH模式
+- **生产环境**: `application-prod.yml` - 使用VOLUME模式
+
+## 故障排除
+
+### 1. 证书文件找不到
+
+```bash
+# 检查证书文件是否存在
+docker exec cms-java-app ls -la /app/certs/
+
+# 检查文件权限
+docker exec cms-java-app ls -la /app/certs/wechat/
+```
+
+### 2. 支付接口调用失败
+
+```bash
+# 查看应用日志
+docker-compose logs cms-app | grep -i cert
+
+# 检查证书配置
+docker exec cms-java-app cat /app/application.yml | grep -A 10 certificate
+```
+
+### 3. 容器启动失败
+
+```bash
+# 查看详细错误信息
+docker-compose logs cms-app
+
+# 检查容器状态
+docker-compose ps
+```
+
+## 安全建议
+
+1. **证书文件权限**: 设置为只读权限 (444)
+2. **证书目录权限**: 限制访问权限
+3. **敏感信息**: 使用环境变量或Docker secrets管理敏感配置
+4. **网络安全**: 使用内部网络，限制端口暴露
+
+## 更新证书
+
+1. 停止应用容器：`docker-compose stop cms-app`
+2. 更新证书文件到 `certs/` 目录
+3. 重启应用容器：`docker-compose start cms-app`
+
+## 监控和日志
+
+- 应用日志：`./logs/` 目录
+- 容器日志：`docker-compose logs`
+- 健康检查：访问 `/actuator/health` 端点
+
+通过以上配置，你的应用在Docker容器中就能正确加载支付证书了！