RelaxHub
PROJECT

项目档案

这个站是什么、怎么搭的、怎么变成现在这样。
一份写给未来的自己看的说明。

一、这是什么

RelaxHub 是一个个人技术主页,服务于「记录 + 导航 + 展示」三件事。

  • 记录 更新日志、技术笔记、未来计划
  • 导航 67 个常用网站,按 8 个分类整理,支持搜索
  • 展示 自己服务器的实时监控,以及每次迭代留下的痕迹

它不是一个博客,也不是一个作品集。定位更接近一块个人的数字门牌——别人点进来,能一眼看到你是谁、在做什么、平时用什么工具。

一个网络工程在读学生的个人技术空间,包含笔记、工具导航、服务器监控和更新日志。
二、基本信息
名称RelaxHub
副标题Explore · Create · Connect
线上地址https://relaxhub.top
规划域名https://relaxthink.com(备案通过后迁移)
作者Relax
起始时间2026-11-08
当前版本v1.32
累计迭代43 个版本
三、技术架构
浏览器
  │
  ├── HTTPS → Cloudflare(Full strict,回源走 HTTPS:443)
  │
  ▼
Nginx  (Ubuntu 24.04, /opt/relaxhub-web/site)
  │
  ├── /            静态文件(HTML / CSS / JS / 图片 / PWA)
  └── /api/        反向代理 → 127.0.0.1:5000
                        │
                        ▼
                   Gunicorn + Flask
                        │
        ┌───────────────┼────────────────┐
        ▼               ▼                ▼
   SQLite 时序库   内容 JSON 目录    阿里云 CloudMonitor
   (监控数据)    /opt/relaxhub-content/current
前端
  • 纯静态,无框架、无构建步骤
  • 原生 HTML + CSS + JavaScript
  • 图表手写 Canvas 绘制,不依赖第三方图表库
  • 字体、图标、背景全部本地化,不引外部 CDN
  • PWA:manifest + 11 个 iPhone 尺寸启动图
后端
  • Flask + Gunicorn(单 worker,127.0.0.1:5000)
  • 只提供 JSON 接口,不渲染任何页面
  • 所有接口挂在主域名根路径 /api/,迁移域名时前端无需改动
接口作用
/api/metrics监控时序数据,支持小时区间
/api/changelog更新日志
/api/future未来计划
/api/notes笔记列表与正文
/api/sites网站导航分类与链接
/api/explore随机探索全集
/api/explore/random随机抽一个
/api/messages/quote每日一言
/api/messages/idle待机提示
/api/messages/avatar头像彩蛋
数据分层

项目刻意把数据分成两类,走两条完全不同的路:

类型存储特点
时序数据SQLite每分钟一条,写多读少,需要聚合
文字内容纯 txt + git人来写的,需要版本管理和历史
主机指标SQLite(LOCAL_MODE)每分钟读一次本机 /proc,非模拟
内容层

文字内容不写在代码里,而是独立的 git 仓库:

content/独立 git 仓库
├── README.txt格式说明
├── changelog.txt更新日志 · 40 条
├── quotes.txt每日一言 · 100 条
├── idle.txt待机提示 · 50 条
├── avatar.txt头像彩蛋 · 50 条
├── sites.txt网站导航 · 8 类 67 个
├── explore.txt随机探索 · 65 条
├── docs/项目档案 · 9 篇
└── notes/笔记 · 3 篇
├── windows.txt
├── cloudflare.txt
└── vps.txt

网站跑在 relax-prod-02 上,对应结构:

/opt/relax-prod-02
├── git/裸仓库
│ └── relaxhub-content.git收内容推送
├── relaxhub-content/内容工作区
│ ├── work/工作副本
│ ├── releases/每次构建一个版本
│ ├── current → releases/xxx正在使用
│ └── previous → releases/xxx上一版
├── relaxhub-web/程序代码
│ ├── site/静态页面(Nginx 根目录)
│ ├── monitor/Flask + 采集 + 构建
│ ├── ops/运维脚本
│ └── venv/Python 虚拟环境
└── relaxhub-web.zip部署包

代码仓库不在这里,单独放在阿里云 ECS 上——它是备份和历史,不参与网站运行:

ECS /opt/git/代码历史与备份
├── relax-code.git个人代码 + 网站代码(root:root 700)
└── relax-team.git团队仓库(git 用户,独立密钥)
代码和内容彻底分离:更新代码不会碰内容,推送内容不会碰代码。
四、功能清单
顶部
名字、英文副标题、4 个社交入口
时间栏
实时时钟、农历、节气和节日、每日一言
日历
可点选日期,显示选中日的星期、农历、节日
随机探索
65 个技术方向随机抽取,「今天可以」做什么
服务器监控
CPU、内存、公网出带宽、连接人数,读的是这台服务器自己的 /proc
网站
8 个分类 67 个链接,搜索框支持 / 快捷键
笔记
横向滑动卡片,待写笔记置灰不可点
更新日志
横向滑动,带版本号,点击展开详情
未来计划
阶段性目标
细节设计
  • 按 / 聚焦搜索,按 Esc 清空并退出
  • 页脚年份自动跟随系统时间
  • 手机端 2×2 压缩布局,桌面端 1.5 : 1 双栏
  • 监控图表量程:CPU、内存固定 0–100%,带宽按当前区间峰值自适应,连接数 0–30(超 75% 弹性扩容)
  • 监控面板显示的是数据自带的时间,切换区间不会变化,只有新数据入库才往前走
  • 监控按整分触发轮询,拿到新数据就停;页面不在前台时不查询,切回来再查一次
  • 无数据时走兜底文案,接口失败不白屏
五、内容管理流程

这是整个项目里最值得记住的一条链路。

写作流程(人这一侧)
改 txt  →  提交  →  同步更改

VSCode 的「同步更改」自带先拉取后推送,所以日常不需要单独 pull。格式规则写在 content/README.txt 里,不用 Markdown,不用图片,不用改一行代码。

自动化流程(服务器这一侧)
git push
   │
   ▼
post-receive 钩子
   │
   ▼
content-build.sh
   │
   ├─ [1/4] git pull --ff-only
   ├─ [2/4] 校验并生成 JSON
   │        └─ 失败 → 保留上一版 + 发邮件 → 退出
   ├─ [3/4] 切换 current / previous 符号链接(原子操作)
   └─ [4/4] 清理旧版本,只留最近 5 个
核心保证:内容坏了,线上不会坏。

校验不通过时,current 指针一动不动,网站继续用上一版,作者收到一封邮件:

主题:RelaxHub 内容检查未通过(提交 abc1234)

原因:
changelog.txt:1: 版本号格式应为 v1.23 → 1.23

校验规则包括:时间格式、版本号格式(必须 v1.23)、链接格式、笔记状态只能是「已发布 / 待写」、必填字段是否齐全。

六、部署与更新

代码不走 git 发布,走同步上传;git 只负责历史和备份:

# Mac 端,脚本在 02-relaxhub-top/deploy.sh
bash deploy.sh                 # rsync 同步 + 远程执行 update.sh
DRY_RUN=1 bash deploy.sh       # 预览,不实际改服务器

# 或手动
cd /opt && unzip -oq relaxhub-web.zip && bash /opt/relaxhub-web/update.sh

update.sh 的关键设计:

  • 先算项目文件指纹(sha256 汇总,排除 venv、缓存、数据库)
  • 指纹没变且服务正常 → 直接跳过重启
  • requirements.txt 没变 → 跳过 pip
  • Nginx 配置没变 → 不重复覆盖
  • 自动安装推送钩子、运维短命令、日志轮转
运维短命令
命令作用
rh-status服务、端口、磁盘、内存、接口、版本、采集、安全,一次看完
rh-log最近 3 次巡检记录
rh-check手动触发一次巡检
rh-content手动触发一次内容构建
定时任务
*/10 * * * * root /opt/relaxhub-web/ops/check.sh

每 10 分钟巡检一次,异常自动重启并记录恢复结果,日志保留 2000 行。

七、两台服务器

一台在跑网站,一台在等备案兼做代码仓库。

relax-prod-02(现在跑网站)
位置美国加州圣何塞
配置1 核 / 961MB / 19GB / 3TB 月流量
系统Ubuntu 24.04.5 LTS,1G swap
服务状态relaxhub-web active、nginx active
登录方式仅密钥,密码登录已关闭
内容版本保留最近 5 个 release
费用15.98 美元 / 年

2026-11-20 从洛杉矶整体迁来:代码、内容仓库、五个历史版本一起搬,DNS 切换后没有中断。因为直连丢包严重,日常管理走阿里云 ECS 做跳板。

已退役:原先在洛杉矶的 Cloudzy(1 核 / 458MB)跑了一周多的 .top 站点,2026-11-20 迁移完成后销毁。

阿里云 ECS(备案通过后接班)
位置华北 2(北京)
主机名relax-prod-01
配置2 核 / 1740MB / 40GB / 3 Mbps
系统Ubuntu 24.04.5 LTS,2G swap
端口只开 22,80 / 443 关着
现在在做什么git 服务器,放 relax-code 和 relax-team
云监控内存、磁盘、CPU 三条短信报警,含主机失联
云监控报警

服务器出事不会自己说话,所以把三条阈值规则接到手机上:

规则条件说明
内存> 90%,连续 5 分钟同时开了无数据报警,主机失联或 agent 停了都会响
磁盘> 85%,连续 5 分钟只看根分区,不盯 /boot/efi
CPU> 95%,连续 3 分钟阈值放高,滤掉编译、备份这类正常尖峰

通知走短信和邮件,同一条规则一小时内不重复发;恢复后另发一条「恢复正常」。

为什么要两台:阿里云 ECS 正在走备案流程,备案期间公网不能出现网站内容。所以站点临时放在海外 VPS 上跑,relaxhub.top 先上线,relaxthink.com 等备案通过后再切回国内。

关于源站地址:这里不公开服务器的公网 IP。域名走 Cloudflare,直接暴露源站只会招来无意义的端口扫描和暴力破解,没有任何好处。

八、开发历史

全部 43 个版本,从 2026-11-08 20:00 至今。

阶段一立项 11-08

v0.1 单页布局与网站导航,v0.2 买下域名与 ECS 并定下双域名方案,v0.3 进入备案等待并验证阿里云云监控 API。这一阶段确立了两件影响深远的事:双域名方案,以及监控要用真实云监控数据。

阶段二迁移上线 11-09 上午

v0.4 静态主页与 Flask 合并,v0.5 站点临时迁到洛杉矶 VPS,v0.6 定位 Cloudflare 521 是回源 443 而 Nginx 只听 80,SSL 改为 Flexible 恢复 HTTPS。那是第一个真正的坑。

阶段三界面成型 11-09 全天

v0.7 到 v1.2,监控嵌入首页、横向更新日志、实时日历、收藏夹、曲线自动缩放。这一阶段是纯设计驱动的迭代,几乎每个版本都在调布局:标题什么时候和控件同行、日历怎么压缩、曲线怎么不贴底。

阶段四内容与打磨 11-09 晚

v1.3 探索组件重做,v1.4 让探索卡片绝对填满日历高度而不参与撑高整行,v1.5 时间间距调成 1:1:1、副标题定为 Explore · Create · Connect、探索扩充到 30 条。

阶段五工程化 11-12 至 11-13

v1.16 起重心从「做什么」转向「怎么维护」:巡检脚本、日志轮转、关闭密码登录、每 10 分钟自动巡检、文件指纹增量更新,最后把备份交给云厂商快照。期间踩了三个真实的坑:journalctl 的 -- No entries -- 被算成 1 条错误;软链调用时项目目录解析成 /usr/local;sed 改 sshd_config 不生效,因为 OpenSSH 用的是首次出现的值。

阶段六内容仓库 11-14

v1.23 文字全部改为 txt + git,构建时校验并生成 JSON,失败保留上一版;v1.24 加上 post-receive 自动上线与邮件提醒,笔记改为独立详情页。这是架构上最大的一次变化,也是整个项目的收尾。

阶段七迁移准备 11-16 至 11-20

网站进入稳定期,重心转向备案后的迁移:ECS 重装 Ubuntu 24.04、关掉密码登录、建 git 用户和两个代码仓库,把个人代码从海外 VPS 搬到国内。同时把仓库命名统一成 relax- 前缀,与域名品牌解绑。最后接上云监控短信报警——内存、磁盘、CPU 三条阈值规则,另外给内存那条挂了无数据报警,用来抓主机失联。11-20 黑五买了一台圣何塞的小机器,把整站从洛杉矶整体迁过去,DNS 切换零中断。

展开全部 43 个版本
版本标题时间
v1.33文档收尾11-20
v1.32真实监控11-20
v1.31新服务器11-20
v1.30档案更新与云监控11-19
v1.29档案目录树11-16
v1.28监控按整分刷新11-15
v1.27数据时间11-15
v1.26笔记组件统一11-14
v1.25项目介绍页11-14
v1.24自动构建与笔记页11-14
v1.23内容仓库11-14
v1.22移除自带备份11-13
v1.21版本化与增量更新11-13
v1.20运维脚本路径修复11-13
v1.19定时巡检与备份11-13
v1.18SSH 加固与巡检修正11-13
v1.17巡检误报修复11-13
v1.16服务器运维脚本11-13
v1.15小细节优化11-12
v1.14公网出带宽11-11
v1.13监控刻度固定11-11
v1.12一键更新脚本11-10
v1.11彩蛋内容上云11-10
v1.10API 迁到根路径11-10
v1.9应用启动画面11-10
v1.8删除旧监控页11-10
v1.7日志标题修复11-10
v1.6网站改为选择卡11-10
v1.5收尾与内容整理11-09
v1.4日历与探索高度固定11-09
v1.3探索组件重做11-09
v1.2标题与图表真实度11-09
v1.1日历选择与随机探索11-09
v1.0图表与层级细化11-09
v0.9日历与收藏夹11-09
v0.8文档与品牌统一11-09
v0.7监控与更新日志11-09
v0.6DNS 与 HTTPS11-09
v0.5Cloudzy 部署11-09
v0.4监控面板与项目合并11-09
v0.3备案与云监控11-08
v0.2域名与 ECS11-08
v0.1RelaxHub 第一版11-08
九、踩过的坑
问题原因解法
Cloudflare 521回源 443,源站只听 80SSL 模式改 Flexible
更新日志标题串联渲染时只追加不清空先清空节点再渲染
巡检天天报 1 条错误-- No entries -- 被计数过滤掉该行
运维脚本找不到项目软链调用时路径解析错用 readlink -f
SSH 密码没关掉配置用「首次出现的值」加 01- 前缀的 drop-in
备份打包了 /usr/local上一条的副作用删除并加目录校验
笔记接口返回空当前版本不存在时没兜底回退到默认数据目录
「跳过重启」看着没生效测试时管道触发 SIGPIPE行为本身正确,改用完整输出验证
更新日志时间写成未来没取真实时间写日志前先跑 date
改完代码却不重启同步删掉了服务器上的指纹文件排除 .deploy.sha256
Windows 克隆后 11 个文件「已修改」CRLF 换行符core.autocrlf false + .gitattributes
云监控磁盘规则永不触发维度选错分区确认根分区是 /dev/vda3
监控插件显示「已停止」控制台展示滞后看日志的 send msg success
十、下一步
事项前置条件
迁移到 relaxthink.com + 阿里云 ECSICP 备案通过
站点标题改为「放松思考个人技术笔记」同上
页面展示 ICP 备案号同上
30 天内完成公安备案ICP 通过后
内容仓库迁到 ECS,改名 relax-contentICP 通过后
手机与 Windows 的仓库地址切到 ECS迁移时
补齐 Cloudflare / VPS 两篇笔记待写状态,随时可写
十一、这个项目教会了什么

如果用一句话总结这段过程:

先让它能跑,再让它好看,最后让它坏不了。
  • 前 15 个版本在解决「好不好看」
  • 中间 7 个版本在解决「好不好维护」
  • 最后几个版本在解决「改坏了怎么办」和「人不在的时候怎么办」

第三条是最不容易想到的。写内容的人一定会写错格式,所以系统必须有拒绝上线的能力,而不是靠人小心。

这也是为什么内容仓库要有校验、要保留上一版、要发邮件。不是因为不信任自己,是因为人会累。