个人门户(Personal Portal)是连接数字生活与日常生产力工具的枢纽。本文记录如何基于 Cloudflare Pages 与原生 Web 技术栈,从零设计并部署一套高颜值、轻量无依赖的清新扁平旅行手帐风导航页。

📦 项目现已开源:shali10/forest-nav · 欢迎 Star 与 Fork 定制属于你自己的个人门户。

林间随笔导航页桌面端全景预览


🎯 目标

  1. 视觉美学升级:告别千篇一律的暗黑运维后台或厚重手帐风,采用大面积奶油米白(#FAF7EE)与青绿(#2D5A46)为主色调,点缀天蓝与杏橙,打造呼吸感十足的清新插画质感。
  2. 高频工具一站集成:分类聚合服务器管理、AI 生产力、博客图床、云存储及日常数字生活入口。
  3. 动态组件与内容聚合:集成 Open-Meteo 实时天气、本地时间、每日随笔,并通过 Cloudflare Pages Functions 自动汇聚 Note 与 Halo 最新文章流。
  4. 全球极速秒开与零成本维护:依托 Cloudflare 全球边缘网络托管,源码无本地冗余残留,实现秒级冷启动与 100% 免费高可用。

💻 实操与核心实现

1. 视觉设计规范与调色盘

在设计之初,明确色彩语义与网格比例,杜绝低饱和度灰暗或刺眼高饱和纯色:

视觉元素取色 Hex设计语义与应用场景
页面主底色#FAF7EE温暖柔和的奶油米白,提供长时间浏览的舒适背景
主强调色(Forest Green)#2D5A46青绿/松石绿,用于核心标题、卡片边框高亮与主要按钮
次强调色(Sky Blue)#4A90E2天蓝,用于云服务/API类卡片装饰与状态徽标
点缀色(Warm Apricot)#F5A623暖杏橙,用于天气、标签与高亮指示器
文字主色#2C3E50深灰青墨色,提供比纯黑更柔和的高对比度阅读体验

💡 设计提示:避免大面积使用粗重投影或强立体拟物。建议卡片采用 border: 1.5px solid rgba(45, 90, 70, 0.12) 搭配浅阴影 box-shadow: 0 4px 12px rgba(45, 90, 70, 0.05),在保持扁平规整的同时营造通透的微浮雕感。


2. 动态天气与智能组件集成

页面顶部集成 Open-Meteo 无 Key 免费全球天气 API 与本地时间,避免注册第三方收费平台的繁琐:

src/components/WeatherWidget.js

JAVASCRIPT
async function fetchWeather(lat = 31.2304, lon = 121.4737) {
  try {
    const url = `https://api.open-meteo.com/v1/forecast?latitude=${lat}&longitude=${lon}&current=temperature_2m,relative_humidity_2m,weather_code&timezone=auto`;
    const res = await fetch(url);
    if (!res.ok) throw new Error('Weather API unreachable');
    const data = await res.json();
    const temp = Math.round(data.current.temperature_2m);
    const code = data.current.weather_code;
    return { temp: `${temp}°C`, desc: parseWmoCode(code) };
  } catch (err) {
    return { temp: '--°C', desc: '晴朗' };
  }
}

3. 基于 Cloudflare Pages Functions 的动态文章聚合

通过 functions/api/posts.js 在边缘实时抓取并解析 Note 与 Halo 博客的 RSS/Atom 源,实现主页“最近文章”的自动化更新与边缘缓存:

functions/api/posts.js

JAVASCRIPT
export async function onRequestGet({ request }) {
  const noteFeed = "https://note.0000996.xyz/feed.xml";
  const haloFeed = "https://blog.0000996.xyz/atom.xml";
  
  // 边缘并发请求并解析最新文章条目
  const [noteItems, haloItems] = await Promise.all([
    fetchFeed(noteFeed, "Note"),
    fetchFeed(haloFeed, "Halo")
  ]);
  
  const posts = [...noteItems, ...haloItems].sort((a, b) => (b.date > a.date ? 1 : -1)).slice(0, 6);
  
  return new Response(JSON.stringify(posts), {
    headers: { "Content-Type": "application/json", "Cache-Control": "public, max-age=300" }
  });
}

4. 移动端自适应与排版设计

移动端视口(375px ~ 414px)采用自适应双列卡片流,确保单手操作与信息密度平衡:

林间随笔导航页移动端响应式布局展示


5. 自动化构建与 Cloudflare Pages 部署

通过 Wrangler CLI 一键发布构建产物至 Cloudflare 边缘网络:

BASH
# 1. 本地打包验证
npm run build

# 2. 部署到 Cloudflare Pages 生产分支
npx wrangler pages deploy dist --project-name=nav-0000996 --branch=main

🔍 验证

完成部署后,对线上站点进行全维度验收:

验证维度验证指标 / 测试项实测表现结论
首屏加载 (TTFB)全球 CDN 边缘解析与冷启动< 120ms⚡ 秒开无白屏
移动端自适应375px ~ 414px 手机视口排版无横向滚动条,网格自动收缩为双列📱 完美响应
文章聚合流Note + Halo 博客更新自动同步秒级获取并展示最新 6 篇手记📰 同步顺畅
深色模式切换系统偏好与手动切换双向联动柔和墨绿暗色调,文字对比度清晰🌙 切换顺滑

📌 总结与开源仓库

通过将个人导航页部署在 Cloudflare Pages 边缘节点上,不仅实现了零服务器运维成本和全球超快访问体验,更借助清新扁平的手帐视觉与动态组件,打造了一个纯粹、美观且高效的个人数字生活入口。