configuration

配置参考

适用版本见版本与验证范围。后端配置在 server/.env，前端配置在 sandadmin-artd/.env 及对应模式环境文件。Vite 环境变量会进入前端产物；不要把数据库密码或服务端密钥放入 VITE_*。

后端

以下是 server/.env.example 与安装器生成配置的字段；示例值不是生产凭据。

字段	用途与示例
DB_TYPE	PostgreSQL 使用 pgsql
DB_HOST / DB_PORT	数据库管理员提供的地址与端口，示例 localhost / 5432
DB_NAME / DB_USER / DB_PASSWORD	已存在的数据库及用户凭据；root、change-me 仅是示例
DB_PREFIX	示例为空，不应凭更名自行改写已有表名
DB_CHARSET	PostgreSQL 示例为 utf8
CACHE_MODE	默认安装生成 file，缓存驱动按锁定核心包配置核对
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD / REDIS_DB	Redis 连接参考；示例 127.0.0.1 / 6379 / 空密码 / 0，不要直接用于暴露的生产 Redis
CAPTCHA_MODE	安装生成 cache
FRONTEND_DIR	sandadmin-artd，用于管理前端源码位置
SANDADMIN_SERVER_PORT	HTTP 默认 8787；宿主监听 0.0.0.0，由防火墙和代理约束访问
SANDADMIN_CHANNEL_PORT	Channel 示例 2206，不是浏览器访问端口

安装器会生成 .env；首次交互安装前不要先创建它。已有实例改配置后按自身服务管理流程生效，不能把文件保存等同于运行进程已经加载。不要在日志、截图或问题报告中公开完整 .env。

前端

字段	含义与示例
VITE_PORT	开发端口 3006，实际使用地址以 Vite 输出为准
VITE_BASE_URL	静态资源基础路径，示例 /；非根路径部署须同时核对路由与代理
VITE_API_URL	开发示例 /api，生产示例 /prod
VITE_API_PROXY_URL	开发代理目标 http://127.0.0.1:8787
VITE_ACCESS_MODE	示例 backend，菜单使用后端访问模式
VITE_WITH_CREDENTIALS	示例 false；跨域部署不能只修改这一项而忽略服务端策略
VITE_LOCK_ENCRYPT_KEY	示例 change-me，按实例设置；它是客户端配置，不能当作服务端保密密钥

开发代理定义在 Vite 配置中，只服务开发模式。VITE_API_URL=/prod 不会自动创建生产代理；生产 Web 服务器须将 /prod/core/... 转给后端 /core/...，且按实际插件路径转发。修改前端环境文件后重新构建并发布，旧 dist/ 不会自动改变。

来源：环境示例、前端开发示例、生产示例、Vite 代理。