Sakurasan
34f0faedcc
存储抽象（internal/storage，新包）
- BlobStore 接口（Put / Open / Delete）+ 两个实现：R2（aws-sdk-go-v2 走
R2 的 S3 兼容 API，path-style、region auto）与本地磁盘（DataDir/uploads，
零配置兜底）。选择：Endpoint / S3Api / Bucket / AccessKey / SecretAccessKey
齐全 → R2，缺任一项回落本地并在启动日志提示缺失的字段名（只报名字不报值）
- 端点 URL 里的路径段不交给 SDK：path-style 下它会被折进对象 key，
导致「数据库 key」和「实际对象 key」对不上（直链 404，实测复现）。
EndpointKeyPrefix 提取路径段给上传 handler 拼进 key，StripEndpointPath
只取 scheme://host 给 SDK——数据库 / 存储端 / 直链三方一致
数据与 API
- files 表：id / key(唯一) / name / mime / size / sha256 / store(r2|local) /
created_at；URL 不入库，按「store 来源 + PublicBase」响应时解析，
切存储端不破坏存量链接
- POST /api/admin/files：multipart 多文件，单文件 ≤50MB（MaxBytesReader 64MB）；
类型白名单 = 图片（jpg/png/webp/gif/avif）+ 附件（pdf/zip/txt），
扩展名 + http.DetectContentType 双重校验（实测拦截随机字节改名 .png），
SVG 拒绝（同源脚本）；内容 sha256 做 key（2026/09/{哈希前12位}{扩展名}），
同内容重复上传自动去重复用
- GET /api/admin/files（分页 + 文件名搜索）、DELETE /{id}（先删对象再删行，
存储端失败保留行可重试）
- 公开路由 GET /uploads/{key}（main.go 挂载）：按 key 查行、存储层流式返回，
Cache-Control immutable + ETag 304；R2 + PublicBase 时 302 直链（后端不出流量）
- URL 解析：FileURL(store, key, PublicBase)——R2 且配了公开域名走直链，
否则 /uploads/ 流式
后台文件管理页（FilesView，「工作台 → 文件」）
- 点击 / 拖拽多选上传（uploadFiles 走 FormData 裸 fetch，401 广播与
request() 一致）；缩略图卡片网格（图片出图、其他出类型占位）；
复制链接（clipboard，非 https 回落 prompt）/ 打开 / 删除（确认提示）；
分页、loading/empty 沿用既有模式
编辑器联动（EditorView）
- 封面：URL 输入框旁「上传」按钮，选图自动填 cover_url
- wysiwyg：Crepe ImageBlock 官方 onUpload 钩子——粘贴 / 拖拽 / 插图
全部走上传，返回 URL 后由 Crepe 插节点
- Markdown 模式：插图弹层加「上传」按钮 + 编辑器粘贴 / 拖拽图片，
上传后在原光标处插入 （异步上传先记光标位，逐张追踪偏移）
.env.example
- 模板入库（无敏感值）：Endpoint = 公开访问域名（直链）、S3Api = 上传端点、
Bucket / AccessKey / SecretAccessKey
验证
- 本地兜底全流程：上传 201、同内容去重复用、随机字节改名 .png 被
内容嗅探拒绝、.svg 拒绝、公开路由 immutable 缓存头 + 内容一致、
删除后存储与公开路由双清 404
- R2 真实链路（站主 .env）：上传 store=r2、直链 200（过程中定位并修复
S3Api 路径段折进 key 导致的直链 404，见 EndpointKeyPrefix）
- 后端 go build/test/vet 全绿；前端构建通过
80 lines
1.7 KiB
Go
80 lines
1.7 KiB
Go
package storage
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"io"
|
|
"os"
|
|
"path/filepath"
|
|
"strings"
|
|
)
|
|
|
|
// LocalStore 把文件落在本地磁盘（DataDir/uploads），零配置兜底。
|
|
// key 允许带「2026/09/」这类前缀，实现里做路径清洗防目录穿越。
|
|
type LocalStore struct {
|
|
Root string
|
|
}
|
|
|
|
func NewLocal(root string) *LocalStore {
|
|
return &LocalStore{Root: root}
|
|
}
|
|
|
|
func (s *LocalStore) path(key string) (string, error) {
|
|
clean := filepath.Clean("/" + strings.TrimPrefix(key, "/"))[1:] // 锚到根再去掉，防 ../
|
|
if clean == "" || strings.HasPrefix(clean, "..") {
|
|
return "", fmt.Errorf("bad key: %q", key)
|
|
}
|
|
return filepath.Join(s.Root, filepath.FromSlash(clean)), nil
|
|
}
|
|
|
|
func (s *LocalStore) Put(ctx context.Context, key string, r io.Reader, size int64, contentType string) error {
|
|
dst, err := s.path(key)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if err := os.MkdirAll(filepath.Dir(dst), 0o755); err != nil {
|
|
return err
|
|
}
|
|
tmp, err := os.CreateTemp(filepath.Dir(dst), ".upload-*")
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer os.Remove(tmp.Name())
|
|
if _, err := io.Copy(tmp, r); err != nil {
|
|
tmp.Close()
|
|
return err
|
|
}
|
|
if err := tmp.Close(); err != nil {
|
|
return err
|
|
}
|
|
return os.Rename(tmp.Name(), dst)
|
|
}
|
|
|
|
func (s *LocalStore) Open(ctx context.Context, key string) (io.ReadCloser, int64, error) {
|
|
dst, err := s.path(key)
|
|
if err != nil {
|
|
return nil, 0, err
|
|
}
|
|
f, err := os.Open(dst)
|
|
if err != nil {
|
|
return nil, 0, err
|
|
}
|
|
st, err := f.Stat()
|
|
if err != nil {
|
|
f.Close()
|
|
return nil, 0, err
|
|
}
|
|
return f, st.Size(), nil
|
|
}
|
|
|
|
func (s *LocalStore) Delete(ctx context.Context, key string) error {
|
|
dst, err := s.path(key)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if err := os.Remove(dst); err != nil && !os.IsNotExist(err) {
|
|
return err
|
|
}
|
|
return nil
|
|
}
|