## 功能特性 - S3 兼容 API：支持标准 AWS SigV4 鉴权，可直接给 AWS CLI、SDK 和常见开发工具使用。 - 内置 Web Console：可在浏览器里管理 bucket、上传文件、预览文本与图片、删除对象。 - 默认登录方式清晰直接：Web Console 使用浏览器 Basic Auth，直接填写安装时配置的 `s3_access_key_id` / `s3_secret_access_key` 即可进入。 - 单服务双入口：默认域名打开 Console，`api-` 前缀域名暴露 S3 API，避免把浏览器入口和客户端入口混在一起。 - 数据持久化：对象数据统一落到 `/lzcapp/var/data`，重启或升级后仍会保留。 ### 首次打开应用 1. 打开应用，进入懒猫配置向导。 2. 在向导里填写 `S3 Access Key ID`、`S3 Secret Access Key` 和可选的 `Initial Buckets`，例如 `smoke-demo`，然后点击开始部署。 3. 部署完成后会跳转到懒猫地址，然后会先弹浏览器 Basic Auth 登录框。 4. 用户名填写 `S3 Access Key ID`，密码填写 `S3 Secret Access Key`，登录后进入 S2 Web Console。 5. 登录后首页默认显示 `Storage Overview / No Bucket Selected`；这是正常现象，表示 Console 已打开，但还没有选中任何 bucket。 6. 点击左侧 bucket 列表里的目标 bucket，进入对象列表页面后再继续上传、预览或删除文件。 7. 如果需要给脚本、SDK 或 AWS CLI 使用 S3 API，请把 endpoint 指向 `https://api-s2.你的盒子名.heiyu.space`。 ### 配置向导参数填写建议 1. `S3 Access Key ID` 推荐使用字母、数字、连字符 `-` 和下划线 `_`，例如 `s2admin`、`s2test-20260518-b`。 2. `S3 Access Key ID` 不建议包含空格、中文或 `: / @ ? #` 这类特殊字符，以免在浏览器、CLI 或 SDK 里触发兼容性问题。 3. `S3 Secret Access Key` 推荐使用至少 `16` 位的随机高强度字符串，长度更长会更稳妥。 4. 如果 `S3 Secret Access Key` 包含特殊字符，在 shell、环境变量或脚本里使用时要注意引号与转义。 ### 使用 AWS CLI 访问 S3 API | 1 | 配置环境变量 | `AWS_ACCESS_KEY_ID=<安装时填写的 s3_access_key_id>` `AWS_SECRET_ACCESS_KEY=<安装时填写的 s3_secret_access_key>` | 凭据准备完成 | | 2 | 列出 bucket | `aws --endpoint-url https://api-s2.你的盒子名.heiyu.space s3 ls` | 能看到 `smoke-demo` 等 bucket | | 3 | 上传对象 | `aws --endpoint-url https://api-s2.你的盒子名.heiyu.space s3 cp ./api-test-2026.txt s3://smoke-demo/api-test-2026.txt` | 上传成功 | | 4 | 下载对象 | `aws --endpoint-url https://api-s2.你的盒子名.heiyu.space s3 cp s3://smoke-demo/api-test-2026.txt ./api-test-2026-downloaded.txt` | 下载成功，文件内容一致 |