环境变量参考

HTTP 服务

变量	默认	说明
SERVER_ADDR	:8080	监听地址
SERVER_MODE	release	运行模式：debug / release / test
GIN_MODE	release	Gin 框架模式，Docker 镜像中默认设为 release

数据库

变量	说明
DATABASE_DRIVER	mysql / postgresql / sqlite
DATABASE_HOST	MySQL/PG 主机名
DATABASE_PORT	MySQL/PG 端口
DATABASE_NAME	数据库名
DATABASE_USERNAME	用户名
DATABASE_PASSWORD	密码
DATABASE_FILEPATH	SQLite 文件路径（仅 sqlite 需要）

缓存与 ID 生成

变量	说明
CACHE_DRIVER	redis / local
ID_GENERATOR_DRIVER	redis / local

Redis

变量	默认	说明
REDIS_HOST	localhost	Redis 主机
REDIS_PORT	6379	端口
REDIS_PASSWORD	``	密码（无密码留空）
REDIS_DB	0	数据库编号

JWT

变量	说明
JWT_SECRET	JWT 签名密钥（生产必须修改）
JWT_EXPIRE_HOURS	Token 过期时间，单位小时

短链接

变量	默认	说明
SHORTLINK_DOMAIN	http://localhost:8080	短链接对外域名，影响返回给前端的完整 URL
SHORTLINK_LENGTH	6	默认短码长度
SHORTLINK_CUSTOM_LENGTH	true	是否允许自定义长度

品牌与上传

变量	默认	说明
WEBSITE_NAME	短网址服务	内置站点名称与品牌名兜底。未配置系统品牌名时，公开页、登录页和后台标题会使用该值。
WEBSITE_COPYRIGHT	空	产品版权/署名文案兜底。CE 不开放关闭或修改版权的后台入口；EE 可在品牌设置中覆盖。
BRANDING_UPLOAD_DIR	data/uploads/branding	CE 品牌 Logo 上传目录。Docker 部署时建议挂载 ./data:/app/data，让默认目录对应 /app/data/uploads/branding。
BRANDING_UPLOAD_MAX_LOGO_BYTES	2097152	CE Logo 上传大小上限，默认 2MB。
EE_UPLOAD_DIR	data/uploads/branding	EE 品牌 Logo 上传目录。EE 版本优先使用该配置。
EE_UPLOAD_MAX_LOGO_BYTES	2097152	EE Logo 上传大小上限，默认 2MB。

品牌配置说明：

• CE 支持系统级 Logo 和站点/品牌名称配置，不支持关闭或修改版权信息，也不支持按工作区或域名分别覆盖品牌。
• EE 支持系统品牌、工作区品牌、域名品牌覆盖，并支持版权/署名显示开关和文案配置。
• 公开页、登录页和后台运行时会读取公开品牌接口返回的 brand_name 和 logo_url；VITE_APP_TITLE 只作为前端构建期兜底。
• Logo 上传成功后访问路径为 /uploads/branding/<hash>.<ext>，实际文件保存在上传目录中。

示例

export SERVER_ADDR=:9090
export DATABASE_DRIVER=mysql
export DATABASE_HOST=db.internal
export DATABASE_USERNAME=dwz
export DATABASE_PASSWORD=secret
export DATABASE_NAME=dwz_db
export CACHE_DRIVER=redis
export REDIS_HOST=cache.internal
export JWT_SECRET=$(openssl rand -hex 32)
export SHORTLINK_DOMAIN=https://s.example.com
export WEBSITE_NAME=我的短网址
export BRANDING_UPLOAD_DIR=data/uploads/branding
./dwz-server