图床是集市各平台共用的图片托管服务,为站内业务提供图片地址与访问控制。它用集市账号登录,同时服务网页与脚本上传。代码是 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 | // server/service/oauth_service.go |
sign 的密钥取 cfg.OAuth.AppSecret,为空时退化成常量 imagebed-oauth-state——等于没有签名。生产必须配好 AppSecret,启动时应对空值直接报错。
流程涉及的接口:
1 | GET /api/oauth/login-url → { url } 生成带 state 的授权地址 |
拿到 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 | // server/service/upload_service.go |
嗅探本身在 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 | // server/blob/store.go |
路径校验做两次:拒绝 ..,再比对 filepath.Clean 后的前缀。只做前者,符号链接与编码绕过仍可能越界。
落库的元数据包括 user_id、存储键、MIME、宽高、字节数、visibility 与缩略图键。按 YYYY/MM/DD 分目录,避免单目录文件数失控。
图片管理与可见性
列表走 ImageService.List(userID, keyword, visibility, page, pageSize),按用户隔离,支持关键词与可见性过滤、分页;返回前由 fillURLs 拼好直链和缩略图地址。
切换公开/私有只接受两个枚举值,且先按 userID 找图:
1 | img, err := s.images.FindByID(userID, id) // 条件里必须带 userID |
FindByID(userID, id) 必须把 userID 放进查询条件。若先按 id 查出记录再比 user_id,返回 403 就等于确认了资源存在。
删除先删存储对象、再删库记录;存储失败不阻断,只记日志,避免「库里没了、文件还在」的反复重试。
缩略图在保存时生成,原图与缩略图分目录。/i/<rel> 与 /i/thumbs/<rel> 都能命中,分别由 FindByPathForServe 和 FindByThumbPathForServe 解析路径。
访问控制:私有图越权一律 404
直链 /i/*filepath 由一个 handler 处理完:校验路径 → 按路径找图(找不到再找缩略图)→ 私有则解析用户 → 从存储读流返回。
1 | // server/core/static.go |
凭证解析优先读 Authorization: Bearer,其次读 ?token=——原生 <img> 带不了请求头。先按 JWT 解析,失败再当个人 Token 解析:
1 | func resolveUser(c *gin.Context, authSvc *service.AuthService, tokenSvc *service.TokenService) (uint, bool) { |
鉴权放在「找到记录之后、读存储之前」,否则会白白多读一次对象。私有图越权返回 404 而不是 403:403 等于告诉对方「这张图存在,只是不归你」。?token= 会进浏览器历史、代理日志和 Referer,只能作为 <img> 场景的兜底,且令牌应短期、可吊销。
路径穿越由 serveImage 和 localStore.abs 双重拦截。
个人 Token
设置页创建 Token,过期时间可选 1h / 1d / 7d / 30d / 永久,原文只显示一次。库里只存 SHA-256,Create 的响应是唯一一次返回原文的机会。认证时先哈希、按哈希查记录、检查过期、更新 last_used_at。
1 | // server/service/token_service.go |
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:六平台与九种产物





