================================================================================ LionWebsite 项目总结 ================================================================================ 一、项目概况 ────────────────────────────────────────────────────────────────────────────── 名称: LionWebsite 技术栈: Spring Boot 3.3.2, Java 21, Maven, SQLite, MyBatis, Netty 定位: 个人/私有 Web 应用，兼具 E-Hentai 画廊下载管理、个人文件服务、 代理订阅管理等功能。 运行端口: 8888 数据库: 双 SQLite 数据库 — LionWebsite.db (主库) + cache.db (缓存库) 构建目标: 支持 GraalVM Native Image (AOT 编译) 二、项目结构 ────────────────────────────────────────────────────────────────────────────── src/main/java/com/lion/lionwebsite/ ├── LionWebsiteApplication.java 主启动类 (@EnableScheduling, 双数据源 MapperScan) │ ├── Configuration/ │ ├── SqlConfiguration.java 双数据源 (main + cache) SQLite 配置 │ ├── MyBatisNativeConfiguration.java GraalVM Native 适配 (AOT hints) │ ├── WebsocketConfiguration.java WebSocket 注册 (/ws/) │ ├── InterceptorConfiguration.java 拦截器链注册 │ ├── CorsConfig.java CORS 全开放 │ └── CustomBean.java Telegram Bot Bean + Native 反射注册 │ ├── Controller/ │ ├── GalleryManageController.java 画廊任务 CRUD、收藏、图片在线缓存 /GalleryManage │ ├── QueryController.java E-Hentai 搜索代理 /query │ ├── PublicController.java 根路由、IP、订阅、文件分享、验证 /、/ip、/sub/、/GetFile/、/validate │ ├── PersonalController.java 个人文件管理 /personal/ │ ├── SubController.java 订阅绑定管理 /personal/subBind/ │ └── UserController.java 用户管理 /personal/user │ ├── Service/ │ ├── GalleryManageService.java 核心画廊管理 (任务创建/查询/删除/图片缓存/在线图片) │ ├── RemoteService.java Netty TCP 客户端连接远程存储节点 (5.255.110.45:26321+) │ ├── WebSocketService.java WebSocket 推送下载进度给前端 │ ├── PushService.java Telegram Bot 通知 (admin 告警) │ ├── QueryService.java E-Hentai 搜索 + 缩略图代理缓存 (转 AVIF) │ ├── LocalServiceImpl.java 定时任务 (连接检测/额度重置/Cookie验证/订阅更新/缩略图清理) │ ├── PublicServiceImpl.java IP 记录、分享码文件获取、授权码修改 │ ├── PersonalServiceImpl.java 文件管理 (浏览/上传/下载/分享/压缩/删除/TAR打包) │ ├── SubService.java 代理订阅绑定/重置/查询/更新记录 │ ├── CollectService.java 画廊收藏/取消收藏 │ └── UserServiceImpl.java 用户 CRUD + 授权码管理 │ ├── Dao/ │ ├── normal/ 主库 Mapper │ │ ├── GalleryMapper.java gallery 表 CRUD │ │ ├── UserMapper.java user 表 CRUD │ │ ├── CollectMapper.java collect 表 CRUD │ │ ├── ShareFileMapper.java ShareFile 表 CRUD │ │ ├── CustomConfigurationMapper.java 配置键值对读写 │ │ └── SubMapper.java 订阅绑定 & 更新记录 │ └── cache/ 缓存库 Mapper │ └── ImageCacheMapper.java 图片 key 缓存 (gidToKey + ImageKeyCache) │ ├── Domain/ 实体类 (Lombok @Data) │ ├── Gallery.java 画廊 (gid, name, link, pages, status, resolution, ...) │ ├── GalleryForQuery.java 搜索结果的画廊精简信息 │ ├── GalleryTask.java 下载任务状态 (下载中/下载完成/压缩中/压缩完成) │ ├── User.java 用户 (id, AuthCode, username, isEnable) │ ├── GidToKey.java 画廊 GID → MPV Key 映射 │ ├── ImageKeyCache.java 图片 key 缓存 (gid, page, imgkey) │ ├── CustomConfiguration.java 配置键常量定义 │ ├── ShareFile.java 文件分享 (ShareCode, FilePath, ExpireTime) │ ├── SubBind.java 订阅绑定 (key, user) │ ├── SubUpdateRecord.java 订阅更新记录 (ip, UA, time, location) │ └── PageNameCache.java 页面名缓存 (gid, page, pageName) │ ├── Message/ 自定义 TCP 消息协议 (Netty) │ ├── AbstractMessage.java 消息基类 (定义了 7 种消息类型常量) │ ├── MessageCodec.java Netty ByteToMessageCodec 编解码器 │ ├── DownloadPostMessage.java 下发下载任务 │ ├── DownloadStatusMessage.java 下载进度状态上报 │ ├── ResponseMessage.java 通用响应 │ ├── DeleteGalleryMessage.java 删除画廊指令 │ ├── IdentityMessage.java 身份认证 │ ├── MaintainMessage.java 维护/心跳消息 │ └── AvailableCheckMessage.java 可用性检测 │ ├── Interceptor/ │ ├── TaskHandlerInterceptor.java 验证 AuthCode 是否有效 (用于 /GalleryManage, /validate) │ ├── PersonalInterceptor.java 限制 /personal/**, /remote/** 仅 AuthCode="alone" │ └── HumanInterceptor.java 拦截无 User-Agent 的请求 (机器人防护) │ ├── Filter/ │ ├── AdaptorFilter.java UA 检测: 移动端重定向到 /mobile, 桌面端放行; 日志记录 │ └── AccessFilter.java 更新用户最后访问时间 (/validate 接口) │ ├── Util/ │ ├── Response.java 通用 JSON 响应封装 ({result, data}) │ ├── CustomUtil.java 工具类 (文件大小格式化/时间/空闲端口/404) │ ├── GalleryUtil.java E-Hentai 网页解析/图片下载/MPV key 管理/图片格式转换 │ └── FileDownload.java 支持断点续传的文件下载工具 (Range) │ ├── Error/ │ └── ErrorCode.java 错误码常量 (IO_ERROR=1, FILE_NOT_FOUND=2, COMPRESS_ERROR=3) │ └── Exception/ └── ResolutionNotMatchException.java 分辨率不匹配异常 三、核心功能模块 ────────────────────────────────────────────────────────────────────────────── 1. E-Hentai 画廊下载管理 - 用户通过 AuthCode 提交 E-Hentai 画廊链接，指定目标分辨率 - GalleryUtil 解析页面 (Jsoup) 获取: 名称/语言/页数/文件大小/可选分辨率 - 通过 Netty TCP 将下载任务发往远程存储节点 (RemoteService) - RemoteService 维护与存储节点的长连接 (自动重连+端口探测) - 存储节点实时回传下载进度 (DownloadStatusMessage)，通过 WebSocket 推送给前端 - 支持图片在线预览: 缓存 MPV key → 按需下载单页 → 转为 AVIF 格式 - 画廊收藏/取消收藏 2. 个人文件服务 - 文件浏览器: 按路径浏览文件/文件夹，显示大小、分享状态 - 上传: MultipartFile 上传到指定路径 - 下载: 支持 HTTP Range 断点续传 - 分享: 生成 8 位随机分享码，设置过期时间，可延长/取消 - 压缩: 异步 TAR 打包目录 - 删除文件/文件夹 3. E-Hentai 搜索代理 - 代理搜索 exhentai.org，返回格式化结果 (含缩略图 URL) - 缩略图代理: 下载 → ImageMagick 转 AVIF → 本地缓存 → 返回 4. 代理订阅管理 - 定时从外部链接拉取 V2Ray/Clash 订阅配置 - 过滤高倍率节点 (流量倍率 > 2) - 为每个用户生成唯一订阅 Key，记录更新 IP/UA/时间/位置 5. Telegram 通知 - 通过 Telegram Bot 向 admin 推送: 任务提交/完成/失败、存储节点上下线、 Cookie 过期、订阅异常等 四、定时任务 (@Scheduled) ────────────────────────────────────────────────────────────────────────────── - 每 30 分钟: 检测存储节点连接，断开则自动重连 - 每周一 4:00: 重置每周下载额度 - 每天 0:00: 验证 E-Hentai Cookie 有效性 - 每天 4:00: 清理过期分享码 - 每 24 小时: 更新代理订阅配置文件 - 每周一 4:00: 清理缩略图缓存 (保留最近 10000 个) 五、安全机制 ────────────────────────────────────────────────────────────────────────────── - 所有管理接口需 AuthCode 参数 (TaskHandlerInterceptor 校验) - /personal 和 /remote 路径限 AuthCode="alone" 用户 - HumanInterceptor 拒绝无 User-Agent 请求 - AdaptorFilter 记录所有请求日志 (IP/路径/UA/时间) - 分享码失败黑名单 (连续失败则屏蔽) 六、依赖 ────────────────────────────────────────────────────────────────────────────── spring-boot-starter-web, spring-boot-starter-websocket, mybatis-spring-boot-starter jsoup (HTML 解析), hutool-all (工具集), sqlite-jdbc (数据库) httpclient + httpmime (HTTP 请求), commons-compress (TAR 打包) commons-io, commons-lang3, netty-all (TCP 通信) java-telegram-bot-api (Telegram Bot), graalvm native-maven-plugin (AOT) ================================================================================ End of Summary ================================================================================