目录一、前置环境准备二、一键启动RustFS容器带数据持久化三、访问Web管理控制台四、验证S3接口可用性1. 安装并配置awscli2. 指定自定义端点创建桶3. 上传本地测试文件验证五、日常常用容器运维命令六、简单使用场景小结参考资料之前陆续聊完了 RustFS 和 MinIO 的各项差异不管是开源协议约束、GC 带来的性能抖动还是海量小文件、Iceberg 元数据场景的表现差距不少朋友看完都问能不能出一篇手把手部署教程自己搭个本地环境实际测试对比。刚好借助 Docker 可以做到一行命令启动不用复杂编译配置新手也能快速跑通整套服务并且完整兼容标准 S3 接口后续不管是对接 Iceberg、DuckDB还是自用文件备份、本地开发调试都很合适下面一步步带着大家完整部署。一、前置环境准备整个部署依赖 Docker 环境先确认本机是否已经装好 Docker。打开终端输入下面命令校验版本docker -v如果输出版本号说明环境就绪如果提示命令不存在自行安装 Docker DesktopWindows/Mac或 Docker EngineLinux 服务器即可网上教程非常多这里不再赘述。另外建议预留少量磁盘空间用来持久化存储上传的文件与元数据避免容器删除之后数据全部丢失。二、一键启动RustFS容器带数据持久化最实用的部署方式是挂载本地目录做持久化避免容器重建数据丢失直接复制下面整条命令执行按需修改里面参数即可。docker run -d \ --name rustfs \ -p 9000:9000 \ -p 9001:9001 \ -v /data/rustfs:/data \ -e RUSTFS_ACCESS_KEYadmin \ -e RUSTFS_SECRET_KEYAdmin123456 \ rustfs/rustfs:latest逐行简单解释每个参数含义方便大家自定义修改​--name rustfs​给容器设置名称后续启停、查看日志方便识别​-p 9000:9000​S3 API 服务端口外部客户端连接、程序读写对象都走这个端口​-p 9001:9001​配套管理控制台网页端口浏览器访问可视化管理​-v /data/rustfs:/data​目录挂载容器内部数据映射到本机/data/rustfs​Windows系统可以改成类似D:\rustfs-data:/data​格式​RUSTFS_ACCESS_KEY​访问密钥ID等同于S3的AK客户端连接必填​RUSTFS_SECRET_KEY​密钥字符串等同于S3的SK注意复杂度避免过于简单末尾镜像名自动拉取官方最新镜像版本执行完之后输入查看容器运行状态docker ps列表里能看到 rustfs 容器状态为 Up就代表服务启动成功。三、访问Web管理控制台打开浏览器输入地址http://localhost:9001登录账号就是上面环境变量配置的 AK、SKAccess KeyadminSecret KeyAdmin123456进入后台之后可以直观创建存储桶、上传/删除文件、查看对象列表、修改基础权限操作逻辑和 MinIO 控制台高度接近用过同类产品几乎零学习成本。四、验证S3接口可用性RustFS 完整兼容标准 S3 协议我们可以用 AWS 官方命令行工具 awscli​ 快速测试连通性。1. 安装并配置awscli安装完成后执行配置命令aws configure依次填入内容AWS Access Key ID [None]: admin AWS Secret Access Key [None]: Admin123456 Default region name [None]: local Default output format [None]: json2. 指定自定义端点创建桶对象存储本地部署需要手动指定 Endpoint 地址创建测试桶命令aws s3api create-bucket --bucket test-bucket --endpoint-url http://127.0.0.1:90003. 上传本地测试文件验证aws s3 cp test.txt s3://test-bucket --endpoint-url http://127.0.0.1:9000上传完成后不管用命令行列举对象还是网页控制台进入桶内查看都能看到对应文件说明 S3 服务完全正常可用后续业务代码基于 S3 SDK 接入没有任何适配门槛。五、日常常用容器运维命令日常启停、重启、查看日志整理了几条高频命令收藏备用即可# 停止服务 docker stop rustfs # 重启服务 docker restart rustfs # 查看实时运行日志排查报错用 docker logs -f rustfs # 删除容器数据挂载目录不会被删除 docker rm rustfs如果需要修改 AK、SK、端口等配置停止并删除原有容器重新执行自定义参数的 run 命令启动就行。六、简单使用场景小结本地开发调试替代 MinIO 做项目本地 S3 联调后续迁移线上改动极小Iceberg、DuckLake 测试环境快速搭建底层对象存储验证湖仓读写逻辑个人小型文件备份自建轻量化私有存储不用依赖第三方云存储对比测试搭一套 RustFS 一套 MinIO借助压测工程自行对比两者实际性能表现。结合前面几篇选型内容来看如果后续有私有化交付、海量小文件业务需求这套部署方式也可以稍加调整适配服务器线上部署作为长期可用的底层存储底座。参考资料[1] Docker 安装 RustFS​文档 https://docs.rustfs.com/installation/docker/以下是深入学习 RustFS 的推荐资源RustFS官方文档 RustFS 官方文档- 提供架构、安装指南和 API 参考。GitHub 仓库 GitHub 仓库 - 获取源代码、提交问题或贡献代码。社区支持 GitHub Discussions- 与开发者交流经验和解决方案。​​