环境配置

配置入口：src/config/index.ts（dotenv，override: true）。模板文件：.env.example。

服务

变量	说明	默认
PORT	HTTP 端口	3990

上传

变量	说明	默认
UPLOAD_PATH	本地上传根目录	项目下 upload/
UPLOAD_URL_PREFIX	静态访问前缀	/files

Redis

变量	说明	默认
REDIS_HOST	主机	127.0.0.1
REDIS_PORT	端口	6379
REDIS_PASSWORD	密码	空
REDIS_DB	库序号	0
REDIS_KEY_PREFIX	key 前缀	pangza:

限流、防重复提交依赖 Redis；Auth 会话默认仍为内存，多实例请 Auth({ redis: Redis })。

MySQL

变量	说明	默认
MYSQL_HOST	主机	127.0.0.1
MYSQL_PORT	端口	3306
MYSQL_USER	用户	root
MYSQL_PASSWORD	密码	空
MYSQL_DATABASE	库名	pangza
MYSQL_CONNECTION_LIMIT	连接池大小	10

库表可用项目提供的 pangza_admin.sql 初始化。

ORM

变量	说明	默认
ORM_LOGIC_DELETE	全局逻辑删除	false
ORM_LOGIC_DELETE_FIELD	删除标记字段	delete_flag
ORM_LOGIC_DELETE_VALUE	已删取值	1
ORM_LOGIC_NOT_DELETE_VALUE	未删取值	0
ORM_OPTIMISTIC_LOCK	全局乐观锁	false
ORM_VERSION_FIELD	版本字段	version
ORM_FILL_CREATE_TIME	创建时间列名	create_time
ORM_FILL_UPDATE_TIME	更新时间列名	update_time
ORM_FILL_CREATE_BY	创建人列名	create_by
ORM_FILL_UPDATE_BY	更新人列名	update_by

表级 @Mapper(Entity, { logicDelete, fill, ... }) 可覆盖全局行为。

示例 .env

PORT=3990

UPLOAD_PATH=
UPLOAD_URL_PREFIX=/files

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
REDIS_KEY_PREFIX=pangza:

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=pangza
MYSQL_CONNECTION_LIMIT=10

ORM_LOGIC_DELETE=false

修改后需重启服务生效。