项目档案
这个站是什么、怎么搭的、怎么变成现在这样。
一份写给未来的自己看的说明。
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 仓库:
网站跑在 relax-prod-02 上,对应结构:
代码仓库不在这里,单独放在阿里云 ECS 上——它是备份和历史,不参与网站运行:
代码和内容彻底分离:更新代码不会碰内容,推送内容不会碰代码。
- 按
/聚焦搜索,按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 行。
一台在跑网站,一台在等备案兼做代码仓库。
| 位置 | 美国加州圣何塞 |
|---|---|
| 配置 | 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 迁移完成后销毁。
| 位置 | 华北 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 至今。
v0.1 单页布局与网站导航,v0.2 买下域名与 ECS 并定下双域名方案,v0.3 进入备案等待并验证阿里云云监控 API。这一阶段确立了两件影响深远的事:双域名方案,以及监控要用真实云监控数据。
v0.4 静态主页与 Flask 合并,v0.5 站点临时迁到洛杉矶 VPS,v0.6 定位 Cloudflare 521 是回源 443 而 Nginx 只听 80,SSL 改为 Flexible 恢复 HTTPS。那是第一个真正的坑。
v0.7 到 v1.2,监控嵌入首页、横向更新日志、实时日历、收藏夹、曲线自动缩放。这一阶段是纯设计驱动的迭代,几乎每个版本都在调布局:标题什么时候和控件同行、日历怎么压缩、曲线怎么不贴底。
v1.3 探索组件重做,v1.4 让探索卡片绝对填满日历高度而不参与撑高整行,v1.5 时间间距调成 1:1:1、副标题定为 Explore · Create · Connect、探索扩充到 30 条。
v1.16 起重心从「做什么」转向「怎么维护」:巡检脚本、日志轮转、关闭密码登录、每 10 分钟自动巡检、文件指纹增量更新,最后把备份交给云厂商快照。期间踩了三个真实的坑:journalctl 的 -- No entries -- 被算成 1 条错误;软链调用时项目目录解析成 /usr/local;sed 改 sshd_config 不生效,因为 OpenSSH 用的是首次出现的值。
v1.23 文字全部改为 txt + git,构建时校验并生成 JSON,失败保留上一版;v1.24 加上 post-receive 自动上线与邮件提醒,笔记改为独立详情页。这是架构上最大的一次变化,也是整个项目的收尾。
网站进入稳定期,重心转向备案后的迁移: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.18 | SSH 加固与巡检修正 | 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.10 | API 迁到根路径 | 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.6 | DNS 与 HTTPS | 11-09 |
| v0.5 | Cloudzy 部署 | 11-09 |
| v0.4 | 监控面板与项目合并 | 11-09 |
| v0.3 | 备案与云监控 | 11-08 |
| v0.2 | 域名与 ECS | 11-08 |
| v0.1 | RelaxHub 第一版 | 11-08 |
| 问题 | 原因 | 解法 |
|---|---|---|
| Cloudflare 521 | 回源 443,源站只听 80 | SSL 模式改 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 + 阿里云 ECS | ICP 备案通过 |
| 站点标题改为「放松思考个人技术笔记」 | 同上 |
| 页面展示 ICP 备案号 | 同上 |
| 30 天内完成公安备案 | ICP 通过后 |
| 内容仓库迁到 ECS,改名 relax-content | ICP 通过后 |
| 手机与 Windows 的仓库地址切到 ECS | 迁移时 |
| 补齐 Cloudflare / VPS 两篇笔记 | 待写状态,随时可写 |
如果用一句话总结这段过程:
先让它能跑,再让它好看,最后让它坏不了。
- 前 15 个版本在解决「好不好看」
- 中间 7 个版本在解决「好不好维护」
- 最后几个版本在解决「改坏了怎么办」和「人不在的时候怎么办」
第三条是最不容易想到的。写内容的人一定会写错格式,所以系统必须有拒绝上线的能力,而不是靠人小心。
这也是为什么内容仓库要有校验、要保留上一版、要发邮件。不是因为不信任自己,是因为人会累。