goshs进阶技巧:只读、仅上传、静默模式与TTL自毁等5种服务器模式详解
goshs进阶技巧:只读、仅上传、静默模式与TTL自毁等5种服务器模式详解
goshs 是一款功能丰富的单二进制文件服务器,也是 python3 -m http.server 的强力替代品。除了支持 HTTP/S、WebDAV、FTP/SFTP、SMB 等多种协议外,它内置了 只读、仅上传、禁删除、静默、TTL 自毁 共 5 种服务器模式,通过几个简单的命令行参数即可切换。本文将从零讲透这 5 种模式的用法、底层行为与实战组合技巧,帮助你把 goshs 文件服务器玩出专业水准。
goshs 五种服务器模式速览
这 5 种模式对应 goshs 帮助文档(options/options.go)中的 5 个开关参数,默认全部关闭,按需启用即可:
| 模式 | 短参数 | 长参数 | 核心行为 | 典型场景 |
|---|---|---|---|---|
| 只读模式 | -ro |
--read-only |
禁止上传、建目录、删除 | 安全分发文件 |
| 仅上传模式 | -uo |
--upload-only |
禁止一切下载 | 收集文件/证据 |
| 禁删除模式 | -nd |
--no-delete |
只禁删除,上传下载照常 | 文件落地留痕 |
| 静默模式 | -si |
--silent |
无目录列表、错误页不泄信息 | 低可观测分发 |
| TTL 自毁 | --ttl |
--ttl 2h |
到时自动优雅关机 | 临时传输不留痕迹 |
1️⃣ 只读模式(-ro):访客只能看,不能动
启动命令:
goshs -ro -d /path/to/share
开启后,访客仍然可以浏览目录、下载文件,但所有"写操作"都会被拒绝:
- 上传被禁用:Web 界面的上传按钮、拖拽上传区域会自动隐藏(模板中通过
{{if not .ReadOnly}}判断,见 httpserver/static/templates/index.html); - 建目录被拒绝:
mkdir请求直接返回403 Forbidden,响应体为read only or upload only mode(httpserver/handler.go); - 聊天区文件上传同步关闭:团队聊天中粘贴图片、上传附件的功能也会被一并禁用(httpserver/chat.go)。
💡 适用场景:把工具包、文档、payload 模板分发给团队或目标时,防止目录被覆盖或塞入垃圾文件。
2️⃣ 仅上传模式(-uo):只收文件,拒绝下载
启动命令:
goshs -uo -p 8000
这是只读模式的"镜像":页面可以打开,但任何文件下载请求都会被直接拒绝,返回 403 状态码,错误信息为 Download not allowed due to 'upload only' option(httpserver/handler.go)。
也就是说,访客只能往服务器里"放"文件,拿不走任何东西。
💡 适用场景:搭一个文件收集点,让目标或队友把需要的文件传上来;也适合做单向证据收集。可配合
-uf指定独立的上传目录,例如:goshs -uo -uf /tmp/dropbox
3️⃣ 禁删除模式(-nd):可传可下,但删不掉
启动命令:
goshs -nd
与只读模式不同,-nd 只关掉"删除"这一个动作:上传、下载、浏览全部正常,但文件一旦落地就无法被任何人从 Web 界面删掉,删除按钮在列表中直接不显示(httpserver/handler.go 将 NoDelete 标志注入每个文件条目)。
💡 适用场景:文件落地后需要保留原始状态用于取证或审计,避免误删或恶意清理。
4️⃣ 静默模式(-si):没有目录列表,错误也不泄密
启动命令:
goshs -si -d /path/to/share
静默模式是 goshs 中最"低调"的模式,访问时你会看到:
- 打开任意目录,不会看到文件列表,只渲染一个极简卡片页面,提示"Running in silent mode"(模板:httpserver/static/templates/silent.html);
?json目录列表接口同样被封死,返回404(httpserver/handler.go);- 更关键的是错误信息脱敏:即使请求了不存在的资源,错误页也不会暴露具体原因,只显示
No detailed error message due to silent mode(httpserver/error.go); - 但已知 URL 的文件依然可以直接下载,服务本身完全正常工作。
💡 适用场景:分发特定文件时不希望对方通过目录探测得知服务器上还有哪些文件,最大化降低可观测性。
5️⃣ TTL 自毁模式(--ttl):到期自动关机,不留痕迹
启动命令:
goshs --ttl 2h # 运行 2 小时后自动关闭
goshs --ttl 30m # 参数支持 Go 的时长格式:30s / 30m / 2h 等
--ttl 参数在 main.go 中通过 time.After 挂起一个定时器,到期后服务器会在 15 秒的宽限期内优雅关闭所有服务并退出,日志会明确提示:
Self-destruct armed: shutting down automatically in 2h0m0s
0(默认值)表示关闭自毁功能。TTL 与 TUI 仪表盘(--tui)兼容,仪表盘界面同样能感知倒计时。
💡 适用场景:临时文件交换、一次性数据投递。用完自动销毁,无需人工记得关服务,天然避免端口长期暴露。
🧩 组合技巧:真实任务中的常用配方
这 5 种模式可以任意叠加,威力远超单独使用:
# 低可观测只读分发,2小时后自动销毁
goshs -ro -si --ttl 2h -d /path/to/share
# 静默上传收集点:只收不发、删不掉、1小时后自毁
goshs -uo -nd -si --ttl 1h -uf /tmp/evidence
# 生产级只读分发:HTTPS + 基础认证 + 只读 + 自毁
goshs -s -ss -b 'user:password' -ro --ttl 24h
如果偏好配置文件而非命令行参数,这些开关同样可以写入 JSON 配置文件,通过 -C 加载,样例见 example/goshs.json.example:
goshs -C /path/to/goshs.json
总结
| 你的需求 | 推荐模式 |
|---|---|
| 分发文件、防篡改 | -ro 只读 |
| 收集文件、防外泄 | -uo 仅上传 |
| 文件必须留存 | -nd 禁删除 |
| 隐藏服务器结构 | -si 静默 |
| 用完即走 | --ttl 自毁 |
goshs 的这 5 种服务器模式覆盖了"谁能看、谁能写、要不要留、活多久"四个核心问题。掌握它们后,你只需一条命令,就能把一台临时文件服务器配置得既安全又干净。更多协议特性(SMB 抓哈希、DNS/SMTP 回调、LDAP 等)可参考项目 README.md 中的功能列表。
