# 五岁热榜

> 全网热榜一站聚合，热门资讯尽收眼底

## 概述

五岁热榜是一个全网热榜聚合站点，聚合了 40+ 主流平台的热榜数据。站点使用 Go + Gin + MySQL + Redis 构建，前端采用 SSR + 原生 JS 的轻量方案。

## 技术架构

- 后端：Go 1.23 + Gin
- 数据库：MySQL 8.0（热榜数据存储）
- 缓存：Redis（仅做分布式锁）
- 前端：Go HTML Templates + 原生 JS
- 抓取：定时任务 + 并发抓取 + 三级缓存（Redis → MySQL → 第三方）

## 功能列表

### 核心页面
- 首页（综合热榜）
- 分类页（/:category）
- 单源详情页（/s/:source）
- 搜索页（/search?q=xxx）
- 全站合榜（/ranking）
- 关于页（/about）
- 隐私政策（/privacy-policy）
- 服务条款（/terms-of-service）

### 搜索功能
搜索功能已改为 SSR 模式，通过 `/search?q=xxx` 页面直接渲染结果。

### 数据源（40+）
微博热搜、知乎热榜、B站热门、GitHub Trending、V2EX、36氪、少数派、掘金、IT之家、虎嗅、豆瓣电影、百度热搜、今日头条、腾讯新闻、网易新闻、小红书、雪球、爱范儿、豆瓣书影音、什么值得买、百度贴吧、吾爱破解、观风闻、蓝点网、小众软件、反斗限免、直播吧、抖音、小米有品、游民星空、掘金技术、期刊 等

### 分类
- 综合（all）
- 热门（hot）
- 新闻资讯（news）
- 科技（tech）
- 开发者（dev）
- 社区（social）
- 视频（video）
- 财经（finance）
- 娱乐（ent）
- 购物（shopping）
- 游戏（game）

## 安全特性

- Referer/Origin 白名单
- 双层限流（全局 + 单IP）
- CSRF Token（Double-Submit Cookie）
- CORS 严格白名单
- Security Headers
- Admin Token 鉴权

## 缓存策略

- Redis 缓存热数据，TTL 按源配置
- MySQL 归档历史数据，每天保留最新快照
- 防穿透：空值缓存 30s
- 防击穿：redsync 分布式锁 + singleflight
- 防雪崩：TTL ±10% 随机抖动