16 lines
1.5 KiB
Markdown
16 lines
1.5 KiB
Markdown
# 通用签名读取
|
||
|
||
```sh
|
||
go run ./examples/signedRead
|
||
# 或执行真实 HTTP 检查并退出
|
||
go run ./examples/signedRead -check
|
||
```
|
||
|
||
示例自动创建临时私有存储、一页 PDF 和随机签名密钥，监听随机 loopback 端口。打开终端显示的首页，可预览或下载带中文文件名的 PDF；两条链接从签发起 30 分钟有效。首页显示签名内的实际到期时间，不会通过刷新延长链接；重启会生成新的文件和密钥。Ctrl+C 清理临时目录。
|
||
|
||
示例使用 `storage.ReadPresigner` 对应的 `PresignGetWithOptions` 能力，本地 `Signer` 与 S3/R2、OSS 适配器采用同一组 `ReadOptions`。省略 Disposition 默认 attachment，inline 请求浏览器内联展示；实际展示仍由浏览器设置和文件格式支持决定。原 `PresignGet` 接口与既有下载链接保持兼容。
|
||
|
||
本地支持 GET、HEAD、Range、206/416，响应范围只包含文件内容。云端由原生存储地址响应，GET 签名不通用于 HEAD；OSS 默认域名可能强制下载，应在 SDK 签名前配置自己的域名。详见 [存储接入说明](../../storage/README.md#签名预览与下载)。
|
||
|
||
这只是回环地址上的固定测试文件演示。实际项目先检查权限，再签发指定对象的链接；配置公开签名入口，不能从请求 Host 或转发头猜测。文件路径、权限、审计和页面状态由项目维护。不要记录 URL 查询参数，不公开存储目录。链接到期仅阻止后续读取，不收回已获得的内容；重新签发不会撤销旧链接。
|