【技术教程】开源实时新闻聚合器NewsNow-深圳市維司達科技有限公司

NewsNow 开源项目详解

NewsNow 是一个由开发者ourongxing创建的开源实时新闻聚合器，旨在将分散在各个平台的热点信息统一到一个简洁优雅的界面中，帮助用户高效获取有价值的信息，摆脱传统资讯平台的算法绑架和信息茧房。

⚠️重要区分：请勿与英国商业新闻网站 newsnow.co.uk 混淆，二者完全无关。

访问与体验方式

1. GitHub 项目仓库（研究代码 / 自部署）

地址：https://github.com/ourongxing/newsnow
用途：查看源代码、详细文档、功能特性、部署指南。可 Fork 仓库进行二次开发或自建部署。

2. 官方公开演示站点（直接在线体验）

地址：https://newsnow.busiyi.world
用途：无需部署即可完整体验所有核心功能。

演示站点使用提示：

初次访问默认显示“欢迎”和“实时”栏目。
点击顶部“更多”按钮。
在弹窗中为感兴趣的新闻源（如知乎、微博、GitHub 等）点星星进行关注。
返回首页，切换到“关注”栏目，即可查看个性化聚合新闻流。

核心理念与价值

NewsNow 主打用户主权和反算法绑架：

在一个界面追踪全网热点。
通过自定义关注，完全由用户决定信息来源和呈现顺序。
解决信息过载与碎片化问题，让用户主动获取信息而非被动接受推荐。

技术架构与设计模式

技术栈概览

前端：React 19 + TypeScript + Vite 6
后端：Nitro（Nuxt.js 服务端框架）
状态管理：Jotai（轻量级）
样式与交互：UnoCSS（原子化 CSS）、Framer Motion（动画）

整体架构图

核心设计模式

适配器模式：server/sources/目录中每个新闻源独立实现适配器，将不同平台的数据结构统一为内部NewsItem格式，便于扩展新源。
策略模式：智能抓取调度器根据配置的interval、type（hottest/latest）等动态调整抓取策略。
观察者模式：前端通过自定义 Hooks 监听数据变化，实现刷新、缓存过期时的自动更新。

核心功能

多源聚合：默认支持 40+ 新闻源，覆盖科技、社交、财经、新闻等领域。
优雅交互：卡片式布局，支持拖拽排序、深浅色模式切换、流畅动画。
智能数据管理：默认 30 分钟缓存，登录用户可强制刷新；内置智能重试机制避免 IP 封禁。
个性化与同步：支持 GitHub OAuth 登录，跨设备同步关注列表和阅读偏好。

快速部署

推荐使用 Docker，最简方式：

# docker-compose.ymlservices:newsnow:image:ghcr.io/ourongxing/newsnow:latestcontainer_name:newsnowrestart:alwaysports:-'4444:4444'

执行docker-compose up -d后，访问http://localhost:4444即可。

远程访问建议：配合内网穿透工具（如 cpolar）可获得公网地址，实现随时随地访问。

扩展性：自定义新闻源

NewsNow 最强大的特性之一是极易添加自定义新闻源。

适用场景

学术领域追踪论文网站
开发者监控小众技术论坛
市场人员聚合竞品动态
个人兴趣整合博客、漫画更新等

示例：添加 GitHub Trending

在shared/sources.json中添加配置：

{"github-trending":{"name":"GitHub Trending","type":"hottest","column":"tech","home":"https://github.com/trending","color":"gray","interval":600000,"title":"今日热门仓库"}}

在server/sources/创建github.ts：

import*ascheeriofrom'cheerio';import{myFetch}from'../utils/fetch';exportdefaultdefineSource({'github-trending':async()=>{consturl='https://github.com/trending';consthtml=awaitmyFetch(url);const$=cheerio.load(html);constitems=[];$('article.Box-row').each((_,element)=>{consttitle=$(element).find('h2 a').text().trim();constrelativeUrl=$(element).find('h2 a').attr('href');constdescription=$(element).find('p.pr-4').text().trim();if(title&&relativeUrl){items.push({id:relativeUrl,title:title.replace(/\s+/g,' '),url:`https://github.com${relativeUrl}`,extra:{description:description||''}});}});returnitems.slice(0,10);}});