utarwyn/storage-server
utarwyn
轻量级生产就绪的静态文件存储Web服务器，支持文件上传/删除、缓存、压缩、CORS配置等功能，可自托管用于静态资源服务或文件分享场景。
下载次数: 0状态：社区镜像维护者：utarwyn仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Storage Server
轻量级且生产就绪的静态文件服务，用于对外提供文件访问服务。灵感来源于 https://github.com/PierreZ/goStatic%E3%80%82
镜像概述
Storage Server 是一款自托管的静态文件服务工具，旨在以轻量、无依赖的方式提供文件存储与访问功能。它包含缓存、压缩、日志、安全等核心特性，且配置简单易用。
核心功能
- 基于嵌入式静态Web服务器提供文件访问服务
- 通过受保护的HTTP路由实现文件上传/删除操作
- 支持对特定目录启用缓存或CORS策略
- 将指定目录的文件列表以JSON格式暴露
- 自动对发送的文件进行GZIP压缩
- 轻量高效，无额外依赖
使用场景
- 个人或小型团队的静态资源（如图片、文档）存储与分享
- 小型项目的静态文件服务（如前端资源托管）
- 需要简单文件管理功能的自托管场景
配置说明
可通过命令参数或环境变量配置服务，以下是主要配置项：
| 命令参数 | 环境变量 | 默认值 | 描述 |
|---|---|---|---|
| port | PORT | 8043 | 服务监听端口 |
| base-path | BASE_PATH | /srv/http | 文件存储的根目录 |
| client-secret | CLIENT_SECRET | - | 访问特权路由（上传/删除）的密钥 |
| enable-logging | ENABLE_LOGGING | false | 是否启用请求日志 |
| caching-directories | CACHING_DIRECTORIES | - | 需要启用缓存的目录列表（逗号分隔） |
| expose-directories | EXPOSE_DIRECTORIES | - | 需要以JSON格式暴露文件列表的目录列表（逗号分隔） |
| allow-origins | ALLOW_ORIGINS | - | 允许的CORS源列表（逗号分隔） |
部署示例
Docker Run
bashdocker run -p 80:8080 -e PORT=8080 -v /本地文件路径:/srv/http docker.xuanyuan.run/utarwyn/storage-server
带特权密钥的部署（支持上传/删除）
bashdocker run -p 80:8043 -e CLIENT_SECRET=your_secret_key -v /本地文件路径:/srv/http docker.xuanyuan.run/utarwyn/storage-server
许可证
Storage Server 是开源软件，遵循 https://github.com/utarwyn/storage-server/blob/main/LICENSE%E3%80%82
GitHub https://github.com/utarwyn · *** @Utarwyn
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 storage-server 镜像标签
docker pull docker.xuanyuan.run/utarwyn/storage-server:<标签>
DockerHub 原生拉取命令
docker pull utarwyn/storage-server:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"