配置说明

本文档详细说明 MISEB 系统的所有配置项。

环境变量配置

所有配置项在 .env 文件中设置。

Docker镜像配置

配置项	默认值	说明
`DOCKER_REGISTRY`	`docker.cdiwit.com/miseb-multi-mer`	Docker镜像仓库地址
`IMAGE_TAG`	`1.0.0`	镜像版本标签

MySQL配置

配置项	默认值	说明
`MYSQL_HOST`	`mysql`	MySQL主机地址
`MYSQL_PORT`	`3306`	MySQL端口
`MYSQL_DATABASE`	`miseb`	数据库名称
`MYSQL_USERNAME`	`miseb`	数据库用户名
`MYSQL_PASSWORD`	`Miseb@2024`	数据库密码（必须修改）
`MYSQL_ROOT_PASSWORD`	`Root@2024`	Root密码（必须修改）
`MYSQL_VERSION`	`8.0`	MySQL版本

安全警告

生产环境必须修改默认密码！

Redis配置

配置项	默认值	说明
`REDIS_HOST`	`redis`	Redis主机地址
`REDIS_PORT`	`6379`	Redis端口
`REDIS_PASSWORD`	`Redis@2024`	Redis密码（必须修改）
`REDIS_DATABASE`	`0`	Redis数据库编号

Elasticsearch配置

配置项	默认值	说明
`ES_HOST`	`elasticsearch`	ES主机地址
`ES_PORT`	`9200`	ES端口
`ES_VERSION`	`9.2.2`	ES版本
`ES_JAVA_OPTS`	`"-Xms512m -Xmx512m"`	ES JVM配置

Logstash配置

配置项	默认值	说明
`LOGSTASH_HOST`	`logstash`	Logstash主机地址
`LOGSTASH_PORT`	`4560`	Logstash端口
`LS_JAVA_OPTS`	`"-Xms256m -Xmx256m"`	Logstash JVM配置

MinIO配置

配置项	默认值	说明
`MINIO_ROOT_USER`	`minioadmin`	MinIO用户名
`MINIO_ROOT_PASSWORD`	`Minio@2024`	MinIO密码（必须修改）
`MINIO_API_PORT`	`9000`	API端口
`MINIO_CONSOLE_PORT`	`9001`	控制台端口
`MINIO_VERSION`	`2024.08`	MinIO版本

后端服务配置

配置项	默认值	说明
`ADMIN_JAVA_OPTS`	`"-Xms512m -Xmx1024m -XX:+UseG1GC"`	Admin服务JVM配置
`FRONT_JAVA_OPTS`	`"-Xms512m -Xmx1024m -XX:+UseG1GC"`	Front服务JVM配置
`LOG_LEVEL`	`info`	日志级别

Nginx端口配置

配置项	默认值	说明
`HTTP_PORT`	`80`	HTTP端口
`HTTPS_PORT`	`443`	HTTPS端口

域名配置

配置项	默认值	说明
`MISEB_DOMAIN`	`localhost`	主域名（用于nginx server_name）
`API_DOMAIN`	空	API域名（如API独立部署，否则留空使用主域名）
`STATIC_DOMAIN`	空	静态资源域名/CDN（如使用CDN，否则留空使用主域名）

商品图片配置

配置项	默认值	说明
`IMAGE_DOMAIN`	空	图片访问域名（用于商品图片URL生成），示例：`https://img.example.com`
`IMAGE_STORAGE_TYPE`	`local`	图片存储类型：`local`(本地)、`minio`(MinIO)、`oss`(阿里云OSS)、`cos`(腾讯云COS)
`IMAGE_LOCAL_PATH`	`/data/miseb/images`	本地图片存储路径（容器内路径）

MinIO对象存储配置

当 IMAGE_STORAGE_TYPE=minio 时使用：

配置项	默认值	说明
`MINIO_ENDPOINT`	`http://localhost:9000`	MinIO外网访问域名（用于生成图片URL）
`MINIO_BUCKET`	`miseb`	MinIO存储桶名称

应用配置

配置项	默认值	说明
`WECHAT_API_URL`	空	微信API地址
`SWAGGER_ENABLE`	`false`	Swagger开关
`SWAGGER_CHECK`	`true`	Swagger验证开关
`SWAGGER_USERNAME`	`admin`	Swagger用户名
`SWAGGER_PASSWORD`	`admin123`	Swagger密码

SSL证书配置

配置项	默认值	说明
`SSL_ENABLE`	`false`	是否启用HTTPS
`SSL_CERTIFICATE`	`server.crt`	SSL证书文件名（放在`nginx/ssl/`目录下）
`SSL_CERTIFICATE_KEY`	`server.key`	SSL私钥文件名（放在`nginx/ssl/`目录下）

JVM配置建议

内存分配

根据服务器内存调整JVM参数：

服务器内存	ES_JAVA_OPTS	ADMIN_JAVA_OPTS	FRONT_JAVA_OPTS
4GB	`-Xms256m -Xmx256m`	`-Xms256m -Xmx512m`	`-Xms256m -Xmx512m`
8GB	`-Xms512m -Xmx512m`	`-Xms512m -Xmx1024m`	`-Xms512m -Xmx1024m`
16GB	`-Xms1g -Xmx1g`	`-Xms1g -Xmx2g`	`-Xms1g -Xmx2g`
32GB+	`-Xms2g -Xmx2g`	`-Xms2g -Xmx4g`	`-Xms2g -Xmx4g`

GC配置

推荐使用G1垃圾收集器：

bash

-XX:+UseG1GC -XX:MaxGCPauseMillis=200

完整示例

8GB内存服务器配置：

bash

ADMIN_JAVA_OPTS=-Xms512m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:+HeapDumpOnOutOfMemoryError
FRONT_JAVA_OPTS=-Xms512m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:+HeapDumpOnOutOfMemoryError
ES_JAVA_OPTS=-Xms512m -Xmx512m

Nginx配置

默认配置位置

deploy/nginx/conf.d/default.conf

主要路由规则

nginx

# 静态资源
location / {
    root /usr/share/nginx/html;
    try_files $uri $uri/ /index.html;
}

# Admin API代理
location /adminapi/ {
    proxy_pass http://miseb-admin:8080/;
}

# Front API代理
location /api/ {
    proxy_pass http://miseb-front:8081/;
}

# 图片资源
location /crmebimage/ {
    proxy_pass http://miseb-admin:8080/crmebimage/;
}

自定义Nginx配置

如需自定义配置，编辑 nginx/conf.d/default.conf 后重启Nginx：

bash

docker exec miseb-nginx nginx -s reload

日志配置

日志级别

可选值：debug, info, warn, error

bash

LOG_LEVEL=info

日志文件位置

服务	日志位置
Admin后端	`./logs/admin/`
Front后端	`./logs/front/`
Nginx	`./logs/nginx/`

Docker日志配置

已在Docker daemon中配置日志轮转：

json

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}

SSL证书配置

证书文件位置

deploy/nginx/ssl/
├── server.crt    # SSL证书
└── server.key    # SSL私钥

启用HTTPS

将证书文件放入 nginx/ssl/ 目录
修改Nginx配置启用SSL
重启Nginx服务

外部服务配置

连接外部MySQL

bash

MYSQL_HOST=192.168.1.100  # 外部MySQL IP
MYSQL_PORT=3306
MYSQL_DATABASE=miseb
MYSQL_USERNAME=miseb
MYSQL_PASSWORD=your_password

连接外部Redis

bash

REDIS_HOST=192.168.1.101
REDIS_PORT=6379
REDIS_PASSWORD=your_password

连接外部Elasticsearch

bash

ES_HOST=192.168.1.102
ES_PORT=9200

配置文件示例

生产环境配置示例

bash

# Docker镜像
DOCKER_REGISTRY=docker.cdiwit.com/miseb-multi-mer
IMAGE_TAG=1.0.0

# MySQL
MYSQL_HOST=mysql
MYSQL_PORT=3306
MYSQL_DATABASE=miseb
MYSQL_USERNAME=miseb
MYSQL_PASSWORD=StrongPassword123!
MYSQL_ROOT_PASSWORD=RootStrongPassword123!
MYSQL_VERSION=8.0

# Redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=RedisStrongPassword123!
REDIS_DATABASE=0

# Elasticsearch
ES_HOST=elasticsearch
ES_PORT=9200
ES_VERSION=9.2.2
ES_JAVA_OPTS="-Xms1g -Xmx1g"

# Logstash
LOGSTASH_HOST=logstash
LOGSTASH_PORT=4560
LS_JAVA_OPTS="-Xms256m -Xmx256m"

# MinIO
MINIO_ROOT_USER=minioadmin
MINIO_ROOT_PASSWORD=MinioStrongPassword123!
MINIO_API_PORT=9000
MINIO_CONSOLE_PORT=9001
MINIO_VERSION=2024.08

# JVM配置（8GB服务器）
ADMIN_JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
FRONT_JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
LOG_LEVEL=info

# 端口
HTTP_PORT=80
HTTPS_PORT=443

# 域名配置
MISEB_DOMAIN=www.example.com
API_DOMAIN=
STATIC_DOMAIN=

# 商品图片配置
IMAGE_DOMAIN=https://www.example.com
IMAGE_STORAGE_TYPE=local
IMAGE_LOCAL_PATH=/data/miseb/images

# MinIO对象存储配置（如使用MinIO存储图片）
# MINIO_ENDPOINT=http://minio.example.com:9000
# MINIO_BUCKET=miseb

# 应用配置
WECHAT_API_URL=
SWAGGER_ENABLE=false
SWAGGER_CHECK=true
SWAGGER_USERNAME=admin
SWAGGER_PASSWORD=admin123

# SSL证书配置
SSL_ENABLE=true
SSL_CERTIFICATE=server.crt
SSL_CERTIFICATE_KEY=server.key

配置说明 ​

环境变量配置 ​

Docker镜像配置 ​

MySQL配置 ​

Redis配置 ​

Elasticsearch配置 ​

Logstash配置 ​

MinIO配置 ​

后端服务配置 ​

Nginx端口配置 ​

域名配置 ​

商品图片配置 ​

MinIO对象存储配置 ​

应用配置 ​

SSL证书配置 ​

JVM配置建议 ​

内存分配 ​

GC配置 ​

完整示例 ​

Nginx配置 ​

默认配置位置 ​

主要路由规则 ​

自定义Nginx配置 ​

日志配置 ​

日志级别 ​

日志文件位置 ​

Docker日志配置 ​

SSL证书配置 ​

证书文件位置 ​

启用HTTPS ​

外部服务配置 ​

连接外部MySQL ​

连接外部Redis ​

连接外部Elasticsearch ​

配置文件示例 ​

生产环境配置示例 ​

配置说明

环境变量配置

Docker镜像配置

MySQL配置

Redis配置

Elasticsearch配置

Logstash配置

MinIO配置

后端服务配置

Nginx端口配置

域名配置

商品图片配置

MinIO对象存储配置

应用配置

SSL证书配置

JVM配置建议

内存分配

GC配置

完整示例

Nginx配置

默认配置位置

主要路由规则

自定义Nginx配置

日志配置

日志级别

日志文件位置

Docker日志配置

SSL证书配置

证书文件位置

启用HTTPS

外部服务配置

连接外部MySQL

连接外部Redis

连接外部Elasticsearch

配置文件示例

生产环境配置示例