快速开始

环境要求

Docker + Docker Compose
端口：8002（Web）/ 13306（MySQL）/ 18888（phpMyAdmin）

开发环境部署

cd docker/dev
docker compose up -d

# 首次：初始化数据库
docker exec uldisk-dev-uldisk-1 php think migrate:run
docker exec uldisk-dev-uldisk-1 php think seed:run

访问入口

服务	URL	凭据
管理后台	http://localhost:8002/admin	admin / admin123
WebDAV	http://localhost:8002/dav	admin / admin123（Basic Auth）
S3 兼容 API	http://localhost:8002/s3	Access Key（后台生成，SigV4 鉴权）
公开访问	http://localhost:8002/raw/{space}/{path}	无认证（按空间策略）
phpMyAdmin	http://localhost:18888	root / root

生产环境部署

cd docker/prod
cp .env.example .env    # 编辑 DB_*（MySQL 是外部的）
docker compose up -d    # 端口 8001

生产栈不含 MySQL，必须外部提供。

最简上手路径

启动 Docker → docker compose up -d
种子初始化 → php think migrate:run && php think seed:run
后台添加存储位置 → 管理后台 → 存储位置 → 新建
上传文件 → WebDAV / S3 API / 管理后台文件浏览器
完成

配置体系

ul-disk 采用配置双轨制：

.env 仅放数据库连接（DB_HOST / DB_NAME / DB_USER / DB_PASS / DB_PORT）
其他配置存数据库 config 表，通过管理后台编辑，代码内通过 ConfigService::get('group.key') 读取

配置键格式：group.key（如 system.domain、storage.replica_count、encryption.enabled）

PHP 运行时配置

开发环境针对大文件上传优化，不要随意收紧：

参数	值	说明
`memory_limit`	-1	无限制（4MB chunk 处理需要）
`upload_max_filesize`	-1	无限制
`max_execution_time`	0	无限制
`nginx client_max_body_size`	8192m	支持 4MB chunk 大文件上传

必装 PHP 扩展

gmp（Hamming 路由核心）、bcmath、fileinfo、gd、zip、apcu（限流共享内存）、openssl（加密）、zlib（压缩）