新闻聚合开源工具-NewsNow 幼儿园版使用教材

作为一个程序员的你,还在不断在网站中横跳,找寻最有价值的新闻吗?
NewsNow一款免费全开源的工具,可以打开就整理出当前所有重要新闻。

优雅界面+实时聚合,30分钟缓存机制高效省资源,GitHub登录秒同步数据。支持 Cloudflare/Docker 部署,MIT协议自由定制,轻松打造专属新闻帝国!全球热点一屏掌控,开发者必备神器。

抽奖信息

部署NewsNow

一. Docker的准备

最简单的部署方式就是使用Docker去部署。在安装前我们需要先满足三个工具的安装。

  1. Docker
  2. Docker Compose
  3. git (这个不是必须要有的,有Git是为了Clone项目)

如果你没有Git,也可以直接到Github下载代码。如果你没有Docker,可以直接下载一个Docker Desktop(也就是图形界面的Docker)。

我这里以Windows为例讲一下如何安装Docker。

NewsNow

第 1 步:启用WSL2
直接在左下角的搜索里,搜索powershell, 搜索到之后,直接输入下面的命令。

wsl --install

第 2 步:下载Docker Desktop
直接到Docker官网下载Docker Desktop,下载完成之后,直接安装。

官网地址:https://www.docker.com/products/docker-desktop

第 3 步: 验证安装

docker --version
docker-compose --version

出现版本号说明安装成功了.

二. 下载源代码

如果你安装了Git,可以直接使用git clone的方法克隆整个项目代码。

git clone https://github.com/ourongxing/newsnow.git 

如果你没有安装Git工具,你可以到github上直接下载源码,然后解压。

Github地址:https://github.com/ourongxing/newsnow

有了源代码后,我们可以进入到项目根目录。然后进行配置环境变量。

三. 配置环境变量

创建.env.server 文件,在项目根目录下,可以找到example.env.server文件,然后把这个文件重命名为 .env.server 文件。

然后用记事本打开这个文件,输入下面的配置信息。

# Github Client ID
G_CLIENT_ID=your_github_client_id

# Github Client Secret
G_CLIENT_SECRET=your_github_client_secret

# JWT Secret, 通常可以用 Client Secret
JWT_SECRET=your_jwt_secret

# 初始化数据库(首次运行时设置为 true)
INIT_TABLE=true

# 是否启用缓存
ENABLE_CACHE=true

G_CLIENT_IDG_CLIENT_SECRET:你需要创建一个 GitHub App 来获取这两个值。当然你不填写也是可以用的,只是体验不会很好,如果你要求比较高,建议这两个填写自己的就可以了,后面我也会讲到这个的配置方法。

使用Docker启动服务

打开命令行或者PowerShell,然后进入到项目文件夹下的根目录,执行以下命令启动服务。

docker-compose up -d

第一次运行时,Docker 会自动拉取所需的镜像并构建容器。完成后,你应该能够在浏览器中访问该工具,到时候会给我们运行端口,我这里是4444.
有了这个端口,就可以在浏览器里使用这个NewsNow这个工具库了。

http://localhost:4444

一共四步,我们简单总结一下

  1. 安装Docker
  2. 下载/克隆代码
  3. 修改环境变量
  4. 使用Docker启动服务

使用技巧介绍

安装好了以后,我们就可以在Docker Desktop里关闭或者启用这个工具了。只要点开Docker Desktop后,找到NewsNow,然后开启或关闭服务就可以了。

技巧1:打造自己想要的新闻

刚使用它的时候,会有很多个平台的聚合新闻,但有些信息是我们不感兴趣的。这时候就可以使用更多按钮,然后把自己需要的点上星星。再点击关注,就是我们需要的信息了。

当然你说我想了解最新的新闻,你也可以点击实时,这时候就都是刚刚发生的新闻了。

技巧2:配置Client ID 和 client secret

上面说了不配置也可以使用,但如果你想把这个服务配置到公网,获得更好的体验,建议还是配置一下。下面我就讲一下配置方法。

  1. 登录 GitHub。
  2. 点击右上角头像 ➡️ 选择 Settings (设置)。
  3. 在左侧菜单中点击 Developer settings (开发者设置)。
  4. 在新页面左侧选择 OAuth Apps
  5. 点击 New OAuth App 按钮 创建一个新的 OAuth 应用。

还要配置一下下面的信息:

Application name ———newsnow-login

Homepage URL————http://localhost:4444

Authorization callback URL——http://localhost:4444/api/auth/callback/github

注册完成后,你就会看到Client ID Client Secret,然后修改.env.server文件,得到你的地址。

技巧3:关掉初始化数据库

还有一个要说的点,就是当你第一次初始化仓库结束后,第二次使用前,可以去 .env.server文件里,把初始化数据库的配置改为false.

# 初始化数据库(首次运行时设置为 true)
INIT_TABLE=false

好了,就到这里了,希望你能顺利使用上这个工具,获得不错的体验。


转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。可以在下面评论区评论,也可以邮件至 web0432@126.com