本页目录展开
  1. 登录:access_token 不进浏览器
  2. 上传:三条入口,一个 Save
  3. 存储后端与元数据
  4. 图片管理与可见性
  5. 访问控制:私有图越权一律 404
  6. 个人 Token
  7. 前端托管
  8. 面试速答

图床是集市各平台共用的图片托管服务,为站内业务提供图片地址与访问控制。它用集市账号登录,同时服务网页与脚本上传。代码是 Go + Gin + GORM,server/ 约 2700 行,前端在 web/,仓库见 SysuMirror/imagebed。

登录:access_token 不进浏览器

用户点「集市账号登录」→ 授权 → 回到图床,走的是标准 OAuth 授权码流程。图床不把 access_token 交给前端:回调阶段换取后只存在服务端内存(带 TTL),返回一次性 sessionId,前端再用它换本域 JWT。

state 由 24 字节随机 nonce(48 hex)+ HMAC-SHA256(nonce) 的前 16 个 hex 字符拼成。截断到 64 bit,URL 短一些,仍足以抵抗伪造;回调时先校验长度与 hex 形态,再比签名。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// server/service/oauth_service.go
func (s *OAuthService) CreateState() (string, error) {
nonce, err := util.RandomHex(stateNonceLen / 2) // 48 hex 字符
if err != nil {
return "", err
}
return nonce + s.sign(nonce), nil
}

func (s *OAuthService) ConsumeState(state string) bool {
if len(state) != stateNonceLen+stateSigLen || !isHex(state) {
return false
}
...
}

sign 的密钥取 cfg.OAuth.AppSecret,为空时退化成常量 imagebed-oauth-state——等于没有签名。生产必须配好 AppSecret,启动时应对空值直接报错。

流程涉及的接口:

1
2
3
4
GET  /api/oauth/login-url  → { url }                  生成带 state 的授权地址
POST /api/oauth/callback → { sessionId } 校验 state,用 code 换 token
POST /api/oauth/userinfo → { token, user } 用 sessionId 拉 userinfo 并签本域 JWT
GET /api/auth/me → 当前用户(需 JWT)

拿到 userinfo 后,按 OAuthID upsert 本地用户再签发 JWT。

坑在会话存储:sessions 是进程内 map,多实例部署时回调落在 A、userinfo 打到 B 就取不到,需要 Redis 或会话粘性。一次性会话还必须「取出即删」、TTL 在分钟级,可重复使用就退化成长期令牌。

上传:三条入口,一个 Save

上传入口最终都归一成 []byte 调 UploadService.Save:POST /api/auth/images 供网页(JWT),收 multipart、原始二进制或 JSON base64;POST /api/upload 供脚本(个人 Token),同样吃这三种编码。

Save 的顺序是:判空 → 判大小 → 内容嗅探。嗅探结果决定落盘的 MIME 与扩展名,扩展名只在「内容无法识别」时兜底。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// server/service/upload_service.go
if len(data) == 0 {
return nil, errors.New("空文件")
}
if int64(len(data)) > s.cfg.MaxUploadBytes() {
return nil, errors.New("文件超过大小限制")
}
mime, err := util.ValidateImage(data, filepath.Ext(originalName))
if err != nil {
return nil, err
}
ext := util.MimeToExt(mime) // 落盘扩展名以嗅探结果为准
relPath := "images/" + time.Now().Format("2006/01/02") + "/" + uuid.NewString() + ext
err = s.store.Put(ctx, relPath, bytes.NewReader(data), int64(len(data)), mime)

嗅探本身在 server/util/imageutil.go:http.DetectContentType 命中白名单就采用;SVG 常被识别成 text/xml,需要结合 .svg 扩展名单独放行;两者都不中才退回扩展名判定。

两个安全点:落盘扩展名按嗅探结果重写,保留用户传来的 .php,静态服务一旦按扩展名执行就是 RCE;SVG 是 XML、可内嵌脚本,放行就必须在响应头加 Content-Security-Policy 或强制下载,不能直接渲染。

存储后端与元数据

blob.Store 接口抽象 Put/Get/Delete,实现有本地目录和 MinIO。本地实现的所有对象键先过 abs():

1
2
3
4
5
6
7
8
9
10
11
12
// server/blob/store.go
func (s *localStore) abs(key string) (string, error) {
key = strings.TrimPrefix(filepath.ToSlash(key), "/")
if key == "" || strings.Contains(key, "..") {
return "", fmt.Errorf("非法对象键")
}
full := filepath.Join(s.root, filepath.FromSlash(key))
if !strings.HasPrefix(filepath.Clean(full), filepath.Clean(s.root)) {
return "", fmt.Errorf("路径越界")
}
return full, nil
}

路径校验做两次:拒绝 ..,再比对 filepath.Clean 后的前缀。只做前者,符号链接与编码绕过仍可能越界。

落库的元数据包括 user_id、存储键、MIME、宽高、字节数、visibility 与缩略图键。按 YYYY/MM/DD 分目录,避免单目录文件数失控。

图片管理与可见性

列表走 ImageService.List(userID, keyword, visibility, page, pageSize),按用户隔离,支持关键词与可见性过滤、分页;返回前由 fillURLs 拼好直链和缩略图地址。

切换公开/私有只接受两个枚举值,且先按 userID 找图:

1
2
3
4
5
6
7
img, err := s.images.FindByID(userID, id) // 条件里必须带 userID
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, ErrImageNotFound
}
if visibility != model.VisibilityPublic && visibility != model.VisibilityPrivate {
return nil, errors.New("非法的可见性")
}

FindByID(userID, id) 必须把 userID 放进查询条件。若先按 id 查出记录再比 user_id,返回 403 就等于确认了资源存在。

删除先删存储对象、再删库记录;存储失败不阻断,只记日志,避免「库里没了、文件还在」的反复重试。

缩略图在保存时生成,原图与缩略图分目录。/i/<rel> 与 /i/thumbs/<rel> 都能命中,分别由 FindByPathForServe 和 FindByThumbPathForServe 解析路径。

访问控制:私有图越权一律 404

直链 /i/*filepath 由一个 handler 处理完:校验路径 → 按路径找图(找不到再找缩略图)→ 私有则解析用户 → 从存储读流返回。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// server/core/static.go
rel := strings.TrimPrefix(c.Param("filepath"), "/")
if rel == "" || strings.Contains(rel, "..") {
c.AbortWithStatus(http.StatusNotFound)
return
}
img, err := imageSvc.FindByPathForServe(rel)
if err != nil {
if img, err = imageSvc.FindByThumbPathForServe(rel); err != nil {
c.AbortWithStatus(http.StatusNotFound)
return
}
}
if img.Visibility == model.VisibilityPrivate {
uid, ok := resolveUser(c, authSvc, tokenSvc)
if !ok || uid != img.UserID {
c.AbortWithStatus(http.StatusNotFound) // 越权一律 404,不暴露存在性
return
}
}

凭证解析优先读 Authorization: Bearer,其次读 ?token=——原生 <img> 带不了请求头。先按 JWT 解析,失败再当个人 Token 解析:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
func resolveUser(c *gin.Context, authSvc *service.AuthService, tokenSvc *service.TokenService) (uint, bool) {
raw := middleware.BearerToken(c)
if raw == "" {
raw = c.Query("token")
}
if raw == "" {
return 0, false
}
if uid, err := authSvc.ParseToken(raw); err == nil {
return uid, true
}
if t, err := tokenSvc.Authenticate(raw); err == nil {
return t.UserID, true
}
return 0, false
}

鉴权放在「找到记录之后、读存储之前」,否则会白白多读一次对象。私有图越权返回 404 而不是 403:403 等于告诉对方「这张图存在,只是不归你」。?token= 会进浏览器历史、代理日志和 Referer,只能作为 <img> 场景的兜底,且令牌应短期、可吊销。

路径穿越由 serveImage 和 localStore.abs 双重拦截。

个人 Token

设置页创建 Token,过期时间可选 1h / 1d / 7d / 30d / 永久,原文只显示一次。库里只存 SHA-256,Create 的响应是唯一一次返回原文的机会。认证时先哈希、按哈希查记录、检查过期、更新 last_used_at。

1
2
3
4
5
6
7
8
9
10
11
12
13
// server/service/token_service.go
raw, _ := randomToken()
// 入库:TokenHash = SHA256(raw),原文不落库
...
hash := util.SHA256Bytes([]byte(raw))
t, err := s.tokens.FindByHash(hash)
if err != nil {
return nil, ErrTokenNotFound
}
if t.ExpiresAt != nil && t.ExpiresAt.Before(time.Now()) {
return nil, ErrTokenExpired
}
_ = s.tokens.TouchLastUsed(t.ID, time.Now())

Token 用 SHA-256、密码用 bcrypt:Token 是服务端生成的高熵随机串,没有字典攻击面;慢哈希只会让每次上传多花几十毫秒。

吊销就是删记录:DELETE /api/auth/tokens/:id,按 (userID, id) 定位,跨账号删除返回未找到。

前端托管

mountFrontend 托管构建产物,looksLikeStaticAsset 区分静态资源请求与前端路由:静态资源 404 不回落,路由才回落到 index.html。SPA 回落必须排除静态资源后缀,否则请求一个不存在的 .js 会拿到 index.html,浏览器按 JS 解析直接语法报错,排查方向全被带偏。

面试速答

  • 登录:state = nonce + 截断 HMAC;access_token 留在服务端,前端用一次性 sessionId 换本域 JWT。
  • 上传:内容嗅探为准、扩展名兜底;落盘扩展名按嗅探结果重写;SVG 需额外 CSP。
  • 存储:blob.Store 抽象本地与 MinIO,对象键两次校验(拒 ..、比前缀)。
  • 权限:私有图越权返回 404;鉴权放在找到记录之后、读存储之前。
  • Token:只存 SHA-256,创建时返回一次原文,认证时写 last_used_at。
  • 静态:SPA 回落要排除静态资源,避免把 404 变成语法错误。

→ 下一篇:App:六平台与九种产物