189 lines
4.3 KiB
Markdown
189 lines
4.3 KiB
Markdown
# 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容器中就能正确加载支付证书了！
|