service.xpcool.com/manifest/config/config.dev.yaml
夏犀麟 582485ba2b feat(wallpaper): 壁纸模块后端(开源平台插件 + 自建图库 + 前后台接口)
需求:前台壁纸站支持切换到开源壁纸平台,并能展示后台上传的自家图库,
保留原有「浏览器实时生成」能力(扩展而非替换),PC / 移动双端一致。

设计要点(受服务器 5M 出口带宽约束):
- 开源平台图片一律走官方 CDN 直链,后端只代理元数据,零带宽消耗。
- 自建图库落盘到 /data/www/wallpaper,由 nginx 的 /wallpaper/ 直出,
  Go 服务不参与传图;三档尺寸(480 缩略 / 1920 预览 / 原图仅供下载)。
- 内存缓存平台响应(Bing 1h、搜索类 10min),避免撞第三方配额。

内容:
- 平台插件:Bing 每日一图、Picsum、Unsplash、Pexels、Wallhaven。
  新增平台 = 写一个 provider_xxx.go 并在 allProviders() 加一行,
  刻意不用 init() 自注册,避免隐式副作用。所有适配器支持 config.baseUrl
  覆盖,用于绕开 DNS 污染(实测 wallhaven.cc 解析到境外无关 IP)。
- 自建图库:上传(MD5 秒传去重 / 尺寸前置校验 / 失败清理孤儿文件)、
  元信息编辑、删除、统计;随机取图用「数总数 → 随机偏移」而非 ORDER BY RAND()。
- 接口:open 组 4 个(sources / list / random / download-track),
  admin 组 8 个(list / upload / save / delete / stats / source.list|save|test)。
  全部 POST 且 URL 无参数,符合工作空间接口规范;上传走 multipart 例外。
- 安全:purity 默认锁死 SFW;apiKey 只回传布尔不回传明文;
  保存时留空表示保留旧值;open 组错误信息对外脱敏。
- 配置:clientMaxBodySize 提到 64M(gf 默认 8M 会截断 20MB 原图);
  wallpaper.root / baseUrl 支持环境变量注入并在占位符未替换时兜底。

依赖:golang.org/x/image@v0.23.0(仅用于缩略图缩放,保持 go 1.23.0 不变)。
2026-09-14 01:39:09 +08:00

35 lines
1.0 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

server:
address: ":10100"
openapiPath: "/api.json"
swaggerPath: "/swagger"
logger:
level: "all"
stdout: true
# 日志落盘目录服务器日志管理功能读取此目录
path: "log"
database:
default:
link: "${DB_DSN}"
recruitment:
link: "${RECRUITMENT_DB_DSN}"
jwt:
# 生产环境必须通过 JWT_SECRET 覆盖该值
secret: "${JWT_SECRET}"
accessExpire: "2h"
refreshExpire: "720h"
bark:
baseUrl: "${BARK_BASE_URL}"
deviceKey: "${BARK_DEVICE_KEY}"
pushTime: "${BARK_PUSH_TIME}"
# 登录密码混合加密RSA + AES-GCM私钥留空自动生成并持久化allowPlain 仅本地联调开启
# fullBody 保持 false开发环境仅加密密码字段便于抓包联调
encrypt:
privateKey: "${ENCRYPT_PRIVATE_KEY}"
allowPlain: true
fullBody: false
# 壁纸图库本地默认落在仓库内的 data/wallpaperdata/ gitignore
# baseUrl 指向前端 dev server便于本地联调时 <img> 能直接取到图
wallpaper:
root: "${WALLPAPER_ROOT}"
baseUrl: "${WALLPAPER_BASE_URL}"