ghcr.io/ourongxing/newsnow:v0.0.16

English | 简体中文 | 日本語

[!NOTE] 这是演示版本，目前仅支持中文。后续将发布功能更完善的正式版本，提供更好的自定义选项和英文内容支持。

实时热点新闻，优雅阅读体验

功能特性

• 简洁优雅的UI设计，提供最佳阅读体验
• 实时更新热点新闻
• GitHub OAuth登录及数据同步
• 默认缓存时长30分钟（登录用户可强制刷新）
• 基于来源更新频率的自适应抓取间隔（最低2分钟），优化资源使用并防止IP封禁
• 支持MCP服务器

{
  "mcpServers": {
    "newsnow": {
      "command": "npx",
      "args": [
        "-y",
        "newsnow-mcp-server"
      ],
      "env": {
        "BASE_URL": "https://newsnow.busiyi.world"
      }
    }
  }
}

你可以将BASE_URL更改为自己的域名。

部署指南

基础部署

适用于无需登录和缓存的场景：

1. Fork本仓库
2. 导入至Cloudflare Page或Vercel等平台

Cloudflare Page配置

• 构建命令：pnpm run build
• 输出目录：dist/output/public

GitHub OAuth设置

1. https://github.com/settings/applications/new
2. 无需特殊权限
3. 设置回调URL为：https://your-domain.com/api/oauth/github（将your-domain替换为实际域名）
4. 获取Client ID和Client Secret

环境变量

参考example.env.server。本地开发时，将其重命名为.env.server并配置：

# GitHub客户端ID
G_CLIENT_ID=
# GitHub客户端密钥
G_CLIENT_SECRET=
# JWT密钥，通常与Client Secret相同
JWT_SECRET=
# 初始化数据库，首次运行必须设为true，之后可关闭
INIT_TABLE=true
# 是否启用缓存
ENABLE_CACHE=true

数据库支持

支持的数据库连接器：[***]
推荐使用Cloudflare D1数据库。

1. 在Cloudflare Worker控制台创建D1数据库
2. 在wrangler.toml中配置database_id和database_name
3. 若wrangler.toml不存在，重命名example.wrangler.toml并修改配置
4. 更改将在下次部署时生效

Docker部署

在项目根目录执行：

docker compose up

你也可以在docker-compose.yml中设置环境变量。

开发指南

[!NOTE] 需Node.js >= 20

corepack enable
pnpm i
pnpm dev

添加数据源

参考shared/sources和server/sources目录。项目提供了完整的类型定义和清晰的架构。

有关添加新数据源的详细说明，请参见CONTRIBUTING.md。

开发路线图

• 添加多语言支持（英语、中文，更多语言即将推出）。
• 增强个性化选项（基于分类的新闻、保存偏好设置）。
• 扩展数据源以覆盖多语言全球新闻。

release when ready

贡献指南

欢迎贡献！随时提交拉取请求，或创建issue提出功能需求和bug报告。

有关贡献的详细指南，特别是添加新数据源的方法，请参见CONTRIBUTING.md。

许可证

MIT © ourongxing