GeekIt

SeaweedFS命令速查

部署启动、集群状态、卷管理、filer 与挂载、S3 接口、副本与纠删码、备份迁移、扩容下线、监控安全与报错排查等 139 条命令

共 139 条命令 · 12 类场景 · 点击右侧图标可复制

命令说明复制
weed version查看版本,各组件版本必须一致
weed server -dir=/data -ip=10.0.0.11 -s3 -filer单机一体化启动:master + volume + filer + s3
weed master -mdir=/data/master -ip=10.0.0.11 -port=9333单独启动 master,指定元数据目录与端口
weed volume -dir=/data/vol -max=0 -ip=10.0.0.11 -port=8080 -master=10.0.0.11:9333单独启动 volume server,-max=0 表示不限卷数
weed filer -ip=10.0.0.11 -port=8888 -master=10.0.0.11:9333启动 filer,提供目录语义与 HTTP 接口
weed s3 -filer=10.0.0.11:8888 -port=8333启动 S3 网关,对外提供 S3 兼容接口
weed webdav -filer=10.0.0.11:8888 -port=7333启动 WebDAV 服务
weed scaffold -config=master > master.toml生成 master 配置文件模板
weed master -config=/etc/seaweedfs/master.toml用配置文件启动,生产推荐统一配置
weed server -dir=/data -volume.max=200限制单节点卷数量,便于容量规划
ss -lntp | grep -E "9333|8080|8888|8333"确认 master/volume/filer/s3 端口监听
默认端口:9333 master、8080 volume、8888 filer、8333 s3排查连接问题时先核对端口
systemctl restart seaweedfssystemd 部署方式重启
weed -v=4 master提高日志级别,排查启动与选举问题
命令说明复制
curl http://10.0.0.11:9333/cluster/status?pretty=y集群状态:master 与 volume 节点汇总
curl http://10.0.0.11:9333/dir/status?pretty=y目录与卷分布统计
curl http://10.0.0.11:9333/vol/status?pretty=y卷的容量与使用情况
curl http://10.0.0.11:9333/dir/assign申请一个可写入的 fid(volume 与文件 id)
curl "http://10.0.0.11:9333/dir/lookup?volumeId=3"按 volumeId 查所在 volume server
curl http://10.0.0.11:8080/status?pretty=y查看单个 volume server 的卷与磁盘
curl http://10.0.0.11:8888/查看 filer 的目录列表接口
echo "cluster.check" | weed shell -master=10.0.0.11:9333集群一致性检查,输出异常卷
echo "cluster.ps" | weed shell -master=10.0.0.11:9333查看集群进程与节点信息
echo "volume.list" | weed shell -master=10.0.0.11:9333列出全部卷及所在节点
echo "volume.status" | weed shell -master=10.0.0.11:9333卷的整体状态与容量
weed shell -master=10.0.0.11:9333进入交互式 shell,逐条执行运维命令
命令说明复制
echo "volume.balance -force" | weed shell -master=10.0.0.11:9333强制重平衡卷分布,节点容量不均时使用
echo "volume.fix.replication" | weed shell -master=10.0.0.11:9333修复副本数不足的卷
echo "volume.configure.replication -replication=001" | weed shell -master=10.0.0.11:9333调整卷的副本策略
echo "volume.move -source=10.0.0.11:8080 -target=10.0.0.12:8080" | weed shell -master=10.0.0.11:9333把卷从一台 volume server 迁到另一台
echo "volume.unmount -volumeId=3" | weed shell -master=10.0.0.11:9333卸载卷,迁移前使用
echo "volume.delete -volumeId=3" | weed shell -master=10.0.0.11:9333删除指定卷(危险)
echo "volume.mark -volumeId=3 -readonly=true" | weed shell -master=10.0.0.11:9333把卷标记为只读,停止新写入
echo "volume.vacuum" | weed shell -master=10.0.0.11:9333回收卷内已删除文件占用的空间
echo "volume.check.disk" | weed shell -master=10.0.0.11:9333校验磁盘上的卷与元数据一致性
echo "volume.fsck" | weed shell -master=10.0.0.11:9333检查 chunk 与卷的引用关系
echo "volume.grow -count=5 -collection=logs" | weed shell -master=10.0.0.11:9333预创建卷,避免高峰时 volume 不够分配
echo "volumeServer.evacuate -node=10.0.0.11:8080" | weed shell -master=10.0.0.11:9333迁移节点上全部卷,准备下线节点
卷数不足会报 no free volumes left提前 volume.grow 或扩容 volume server
命令说明复制
curl http://10.0.0.11:8888/path/to/dir/?pretty=y列出目录内容(JSON)
curl -F file=@a.txt http://10.0.0.11:8888/path/to/a.txt通过 filer HTTP 上传文件
curl http://10.0.0.11:8888/path/to/a.txt通过 filer 下载文件
curl -X DELETE http://10.0.0.11:8888/path/to/a.txt删除文件或空目录
curl -X POST "http://10.0.0.11:8888/path/?mkdir=true"创建目录
weed mount -filer=10.0.0.11:8888 -dir=/mnt/seaweedfsFUSE 挂载 filer 目录到本地
weed mount -filer=10.0.0.11:8888 -filer.path=/data -dir=/mnt/data -readOnly只挂载子目录且只读,适合数据分发
weed mount -filer=10.0.0.11:8888 -dir=/mnt/sfs -cacheDir=/data/cache -cacheSizeMB=10240指定缓存目录与容量,改善小文件性能
weed mount -filer=10.0.0.11:8888 -dir=/mnt/sfs -allowOthers允许其他用户访问挂载点
weed webdav -filer=10.0.0.11:8888 -port=7333以 WebDAV 方式访问 filer 目录
filer 的目录元数据存于 filer storefiler store 常用 Redis/MySQL/PostgreSQL/LevelDB,生产建议外部数据库
filer 单点会影响目录访问生产部署多个 filer 并共享同一 filer store
命令说明复制
weed s3 -filer=10.0.0.11:8888 -port=8333启动 S3 网关
weed s3 -filer=10.0.0.11:8888 -config=/etc/seaweedfs/s3.json使用配置文件管理身份与权限
aws --endpoint-url http://10.0.0.11:8333 s3 ls用 aws cli 验证 S3 接口
aws --endpoint-url http://10.0.0.11:8333 s3 mb s3://bucket1创建桶(也可用 weed shell)
echo "s3.bucket.list" | weed shell -master=10.0.0.11:9333列出所有桶
echo "s3.bucket.create -name=bucket1" | weed shell -master=10.0.0.11:9333创建桶
echo "s3.bucket.delete -name=bucket1" | weed shell -master=10.0.0.11:9333删除桶
echo "s3.configure -user=app -access_key=AK -secret_key=SK -actions=Read,Write,List,Tagging -buckets=bucket1" | weed shell -master=10.0.0.11:9333创建 S3 身份并授权指定桶
echo "s3.configure -user=app -actions=Read -buckets=bucket1 -apply" | weed shell -master=10.0.0.11:9333调整已有身份的权限
echo "s3.clean.uploads" | weed shell -master=10.0.0.11:9333清理未完成的分片上传,释放空间
S3 身份默认无权限必须显式配置 actions 与 buckets,否则返回 AccessDenied
只给业务需要的桶与动作避免使用 Admin 全量权限
命令说明复制
curl http://10.0.0.11:9333/dir/assign?collection=logs申请 fid 并指定 collection(逻辑分组)
curl "http://10.0.0.11:9333/dir/assign?ttl=7d"申请带 TTL 的 fid,到期自动清理
curl -X PUT -F file=@a.txt "http://10.0.0.12:8080/3,01a2b3c4d5"按 fid 直接写入文件到 volume server
curl "http://10.0.0.12:8080/3,01a2b3c4d5"按 fid 读取文件
curl -X DELETE "http://10.0.0.12:8080/3,01a2b3c4d5"按 fid 删除文件
curl -I "http://10.0.0.12:8080/3,01a2b3c4d5"只查文件头,判断是否存在
fid 由 volumeId 与 fileKey 组成volumeId 定位节点,fileKey 定位文件,需自行保存映射
对业务更推荐 filer 或 S3 接口直接操作 fid 需要自己维护元数据
命令说明复制
-replication=000单副本,无冗余
-replication=001同机架两副本
-replication=010跨机架两副本
-replication=100跨机房两副本
-replication=200跨机房三副本,可靠性最高
weed volume -dir=/data/vol -master=... -rack=rack1 -dataCenter=dc1为节点打上机架与机房标签,副本策略依赖拓扑
echo "volume.fix.replication" | weed shell -master=10.0.0.11:9333按策略补齐缺失副本
echo "volume.configure.replication -replication=010" | weed shell -master=10.0.0.11:9333修改已有卷的副本策略
echo "ec.encode -collection=logs -fullPercent=95 -quietFor=5m" | weed shell -master=10.0.0.11:9333对冷数据启用纠删码,节省空间
echo "ec.decode -collection=logs" | weed shell -master=10.0.0.11:9333把纠删码卷还原为普通副本
echo "ec.balance" | weed shell -master=10.0.0.11:9333重平衡纠删码分片
echo "ec.check" | weed shell -master=10.0.0.11:9333检查纠删码数据完整性
纠删码牺牲部分性能换空间适合归档与冷数据,热数据不建议开启
命令说明复制
echo "fs.meta.save" | weed shell -master=10.0.0.11:9333导出 filer 元数据为本地快照文件
echo "fs.meta.save -o /backup/meta" | weed shell -master=10.0.0.11:9333指定元数据备份路径
echo "fs.meta.load /backup/meta" | weed shell -master=10.0.0.11:9333从元数据快照恢复目录结构
weed filer.backup -filer=10.0.0.11:8888 -dir=/backup/filer持续备份 filer 元数据变更到本地
备份 volume 数据目录前先 volume.mark -readonly=true避免备份期间写入造成不一致
tar -czf /backup/master.tgz /data/master备份 master 元数据(卷分配信息)
迁移:新集群建好后用 filer 同步或 S3 工具搬运推荐 rclone/mc 走 S3 接口迁移数据
echo "remote.configure -name=backup -type=s3 -s3.access_key=AK -s3.secret_key=SK -s3.endpoint=http://minio:9000 -s3.bucket=backup" | weed shell -master=10.0.0.11:9333配置远端存储,做云端分层
echo "remote.mount -dir=/backup -remote=backup/bucket/path" | weed shell -master=10.0.0.11:9333把远端桶挂载到 filer 目录下
echo "remote.meta.sync -dir=/backup" | weed shell -master=10.0.0.11:9333同步远端元数据缓存
元数据与数据要一起备份只备份 volume 目录会丢失目录结构与文件映射
命令说明复制
weed volume -dir=/data2/vol -ip=10.0.0.13 -port=8080 -master=10.0.0.11:9333 -rack=rack2扩容新 volume server,启动即自动注册
curl http://10.0.0.11:9333/cluster/status?pretty=y确认新节点已加入集群
echo "volume.balance -force" | weed shell -master=10.0.0.11:9333把旧节点部分卷迁到新节点
echo "volumeServer.evacuate -node=10.0.0.11:8080" | weed shell -master=10.0.0.11:9333迁移节点全部卷后下线
echo "volume.unmount -volumeId=3" | weed shell -master=10.0.0.11:9333下线前先卸载卷,避免客户端写入失败
多 master 部署使用 -peers 指定种子节点master 三节点可容忍单点故障
filer 多实例共享同一 filer store避免把元数据放在本地 LevelDB 上做高可用
扩容后观察 volume.list 分布确认卷均匀分布且无节点过载
命令说明复制
curl http://10.0.0.11:9333/cluster/status?pretty=y基础集群指标,可对接监控采集
curl http://10.0.0.11:8080/status?pretty=yvolume server 磁盘与卷指标
weed master -metricsPort=9327开启 Prometheus 指标端口
weed volume -metricsPort=9328volume server 指标端口
weed filer -metricsPort=9329filer 指标端口
curl http://10.0.0.11:9328/metrics | head验证指标输出
tail -f /var/log/seaweedfs/master.logmaster 日志,卷分配失败看这里
tail -f /var/log/seaweedfs/volume.logvolume 日志,写入失败与磁盘问题看这里
weed -v=4 volume临时提高日志级别排查细节
echo "volume.vacuum" | weed shell -master=10.0.0.11:9333回收已删除文件空间,磁盘涨得快时定期执行
echo "volume.check.disk" | weed shell -master=10.0.0.11:9333排查磁盘与卷元数据不一致
ulimit -n 65535提高文件句柄,海量小文件场景必调
命令说明复制
weed s3 -filer=10.0.0.11:8888 -cert.file=/etc/ssl/s3.crt -key.file=/etc/ssl/s3.keyS3 网关启用 TLS
weed filer -disableHttp=false -port=8888如需限制 HTTP 访问可关闭或改端口
weed s3 -filer=... -config=/etc/seaweedfs/s3.json用配置文件集中管理多身份与桶权限
echo "s3.configure -user=readonly -actions=Read,List -buckets=bucket1" | weed shell -master=...创建只读身份
weed mount -filer=... -dir=/mnt/sfs -readOnly只读挂载,防止误删
weed webdav -filer=... -port=7333WebDAV 无内置鉴权,需前置反向代理做认证
master 9333 与 filer 8888 不要直接暴露公网这两个端口没有认证,暴露等于开放全部数据
按业务划分 bucket 与 collection便于权限隔离与容量统计
定期轮换 S3 身份的 access/secret key凭据泄露时及时 s3.configure 覆盖
命令说明复制
no free volumes left没有可写卷:volume.grow 预创建或扩容 volume server
failed to assign volumevolume 不足或节点不可用,看 master 日志与 cluster/status
master not found / connection refused 9333master 未启动或端口不通
filer not found (8888)filer 未启动或 filer store 不可用
volume is full / No space left on device磁盘满:清理或扩容,注意副本策略需要多节点空间
replication 001 not possible拓扑缺少同机架节点,调整 rack 标签或改副本策略
AccessDenied(S3)身份未配置或 actions/buckets 不匹配
SignatureDoesNotMatchAK/SK 错误或系统时间偏差
mount failed: fusermount not found缺少 fuse3 工具
read-only file system(挂载点)卷被标记只读或挂载参数含 -readOnly
too many open files句柄耗尽,调大 ulimit 并检查连接泄漏
chunk not found / 读取 404volume 数据缺失或被 gc,用 volume.fsck 检查
写入很慢检查 volume 磁盘 IO、副本策略与是否开启 EC
filer 目录列表很慢filer store 性能不足,换 MySQL/Redis 并加索引
集群状态显示节点 downvolume server 心跳丢失,检查 9333 连通性与进程

运维常用组合

单机试用weed server -dir=/data -s3 -filer → curl :9333/cluster/status → aws s3 ls → weed mount 挂载
生产部署weed master(3 节点) → weed volume 打 rack/dc 标签 → weed filer + MySQL store → weed s3 → 监控 9327+
扩容启动新 volume 节点 → cluster/status 确认注册 → volume.balance -force → volume.list 复核
下线节点volume.mark -readonly → volumeServer.evacuate → 确认卷已迁走 → 停进程
空间回收volume.vacuum → s3.clean.uploads → volume.fsck → ec.encode 冷数据
故障排查cluster/status → volume.list → volume.check.disk → 看 volume.log → volume.fix.replication

常见问题排查

1. 先分清四个端口

9333 master 管卷分配、8080 volume 存数据、8888 filer 管目录、8333 是 S3 网关

2. filer store 决定目录性能

默认本地 LevelDB 只适合单机,生产用 MySQL/Redis/PostgreSQL 并做高可用

3. 副本策略依赖拓扑标签

001 同机架、010 跨机架、100/200 跨机房,节点不打 rack/dc 标签策略无法生效

4. 卷要提前预创建

高峰写入前 volume.grow,避免 no free volumes left 打断业务

5. 纠删码适合冷数据

EC 能省空间但读放大明显,热数据仍建议多副本

6. 元数据与数据一起备份

fs.meta.save 备目录结构,volume 目录备数据,缺一不可

共 139 条 SeaweedFS 命令 · 示例中的节点 IP、端口与卷 ID 请替换为实际环境

关于SeaweedFS命令速查

在线 SeaweedFS 命令速查手册,按部署与启动、主节点与状态查询、卷管理、Filer 与目录、S3 接口、直接读写 API、副本策略与纠删码、备份恢复与迁移、集群扩容与下线、监控日志与性能、安全与访问控制、常见报错与排查等 12 类场景整理 150+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 weed version 与 weed server -dir/-ip/-s3/-filer 与 weed master -mdir/-port 与 weed volume -dir/-max/-rack/-dataCenter 与 weed filer 与 weed s3 与 weed webdav 与 scaffold 生成配置、9333 master/8080 volume/8888 filer/8333 s3 端口、/cluster/status 与 /dir/status 与 /vol/status 与 /dir/assign 与 /dir/lookup 与 /status?pretty=y、weed shell 的 cluster.check/cluster.ps/volume.list/volume.status/volume.balance -force/volume.fix.replication/volume.configure.replication/volume.move/volume.unmount/volume.delete/volume.mark/volume.vacuum/volume.check.disk/volume.fsck/volume.grow/volumeServer.evacuate、filer 的 HTTP 上传下载删除与 mkdir 与 weed mount 的 -filer.path/-cacheDir/-cacheSizeMB/-readOnly/-allowOthers 与 webdav、S3 的 aws cli 验证与 s3.bucket.list/create/delete 与 s3.configure 的 access_key/secret_key/actions/buckets 与 s3.clean.uploads、fid 直接 PUT/GET/DELETE 与 collection/ttl 参数、replication 000/001/010/100/200 与 rack/dataCenter 标签与 volume.fix.replication 与 ec.encode/ec.decode/ec.balance/ec.check、fs.meta.save/fs.meta.load 与 filer.backup 与 master 元数据备份与 remote.configure/remote.mount/remote.meta.sync 云端分层、扩容新 volume 节点与 cluster/status 确认与 volume.balance/evacuate 下线、metricsPort 9327/9328/9329 与日志与 volume.vacuum 与 ulimit、S3 TLS 与 s3.configure 只读身份与 -readOnly 挂载与端口暴露风险,以及 no free volumes left、failed to assign volume、master not found、volume is full、replication 001 not possible、AccessDenied、SignatureDoesNotMatch、fusermount not found、too many open files、chunk not found 等报错排查。适用于 SeaweedFS 分布式对象存储部署、海量小文件存储、filer 目录挂载与 WebDAV 访问、S3 兼容接口接入、多副本与纠删码容量规划、元数据备份与云上分层、集群扩容与节点下线、监控与故障定位,以及存储运维与面试复习。

核心能力

  • 涵盖 weed version 与 weed server -dir/-ip/-s3/-filer 与 weed master -mdir/-port 与 weed volume -dir/-max/-rack/-dataCenter 与 weed filer 与 weed s3 与 weed webdav 与 scaffold 生成配置、9333 master/8080 volume/8888 filer/8333 s3 端口、/cluster/status 与 /dir/status 与 /vol/status 与 /dir/assign 与 /dir/lookup 与 /status?pretty=y、weed shell 的 cluster.check/cluster.ps/volume.list/volume.status/volume.balance -force/volume.fix.replication/volume.configure.replication/volume.move/volume.unmount/volume.delete/volume.mark/volume.vacuum/volume.check.disk/volume.fsck/volume.grow/volumeServer.evacuate、filer 的 HTTP 上传下载删除与 mkdir 与 weed mount 的 -filer.path/-cacheDir/-cacheSizeMB/-readOnly/-allowOthers 与 webdav、S3 的 aws cli 验证与 s3.bucket.list/create/delete 与 s3.configure 的 access_key/secret_key/actions/buckets 与 s3.clean.uploads、fid 直接 PUT/GET/DELETE 与 collection/ttl 参数、replication 000/001/010/100/200 与 rack/dataCenter 标签与 volume.fix.replication 与 ec.encode/ec.decode/ec.balance/ec.check、fs.meta.save/fs.meta.load 与 filer.backup 与 master 元数据备份与 remote.configure/remote.mount/remote.meta.sync 云端分层、扩容新 volume 节点与 cluster/status 确认与 volume.balance/evacuate 下线、metricsPort 9327/9328/9329 与日志与 volume.vacuum 与 ulimit、S3 TLS 与 s3.configure 只读身份与 -readOnly 挂载与端口暴露风险,以及 no free volumes left、failed to assign volume、master not found、volume is full、replication 001 not possible、AccessDenied、SignatureDoesNotMatch、fusermount not found、too many open files、chunk not found 等报错排查

适用场景

适用于 SeaweedFS 分布式对象存储部署、海量小文件存储、filer 目录挂载与 WebDAV 访问、S3 兼容接口接入、多副本与纠删码容量规划、元数据备份与云上分层、集群扩容与节点下线、监控与故障定位,以及存储运维与面试复习。SeaweedFS命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

SeaweedFS命令速查是免费的吗?需要注册或安装吗?
SeaweedFS命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
SeaweedFS命令速查支持哪些功能?
涵盖 weed version 与 weed server -dir/-ip/-s3/-filer 与 weed master -mdir/-port 与 weed volume -dir/-max/-rack/-dataCenter 与 weed filer 与 weed s3 与 weed webdav 与 scaffold 生成配置、9333 master/8080 volume/8888 filer/8333 s3 端口、/cluster/status 与 /dir/status 与 /vol/status 与 /dir/assign 与 /dir/lookup 与 /status?pretty=y、weed shell 的 cluster.check/cluster.ps/volume.list/volume.status/volume.balance -force/volume.fix.replication/volume.configure.replication/volume.move/volume.unmount/volume.delete/volume.mark/volume.vacuum/volume.check.disk/volume.fsck/volume.grow/volumeServer.evacuate、filer 的 HTTP 上传下载删除与 mkdir 与 weed mount 的 -filer.path/-cacheDir/-cacheSizeMB/-readOnly/-allowOthers 与 webdav、S3 的 aws cli 验证与 s3.bucket.list/create/delete 与 s3.configure 的 access_key/secret_key/actions/buckets 与 s3.clean.uploads、fid 直接 PUT/GET/DELETE 与 collection/ttl 参数、replication 000/001/010/100/200 与 rack/dataCenter 标签与 volume.fix.replication 与 ec.encode/ec.decode/ec.balance/ec.check、fs.meta.save/fs.meta.load 与 filer.backup 与 master 元数据备份与 remote.configure/remote.mount/remote.meta.sync 云端分层、扩容新 volume 节点与 cluster/status 确认与 volume.balance/evacuate 下线、metricsPort 9327/9328/9329 与日志与 volume.vacuum 与 ulimit、S3 TLS 与 s3.configure 只读身份与 -readOnly 挂载与端口暴露风险,以及 no free volumes left、failed to assign volume、master not found、volume is full、replication 001 not possible、AccessDenied、SignatureDoesNotMatch、fusermount not found、too many open files、chunk not found 等报错排查。
SeaweedFS命令速查适合哪些场景使用?
适用于 SeaweedFS 分布式对象存储部署、海量小文件存储、filer 目录挂载与 WebDAV 访问、S3 兼容接口接入、多副本与纠删码容量规划、元数据备份与云上分层、集群扩容与节点下线、监控与故障定位,以及存储运维与面试复习。