owllook
是一个基于其他搜索引擎构建的垂直小说搜索引擎,owllook目的是让阅读更简单、优雅,让每位读者都有舒适的阅读体验,如搜书、阅读、收藏、追更、推荐等功能:
- 演示网址:https://www.owllook.net/
- 公众号:粮草小说,有兴趣的话可以关注下
- 详细安装介绍:详细安装介绍
- 个人公众号:老胡的储物柜
衍生项目:
- 终端看小说: NIYT
- 小说监控工具:owllook_gui
- 小说接口:owllook_api
注意:若将本项目部署并发行,请声明来源,本项目纯属共享学习之用,不得用于商业!
owllook
使用了mongodb储存了用户使用过程中的产生的基本信息,诸如注册信息、搜索小说信息、收藏小说数据等,对于某些必要的缓存,则利用redis进行缓存处理,如小说缓存、session缓存,注意,对于限制数据:都将在24小时删除
对于不同网站的小说,页面规则都不尽相同,我希望能够在代码解析后再统一展示出来,这样方便且美观,而不是仅仅跳转到对应网站就完事,清新简洁的阅读体验才是最重要的
目前采用的是直接在搜索引擎上进行结果检索,我尽量写少量的规则来完成解析,具体见规则定义,遇到自己喜欢的小说网站,你也可以自己添加解析,owllook
目前解析了超过 200+ 网站,追更网站解析了50+
有一些地方需要用到爬虫,比如说排行榜,一些书籍信息等,我不想动用重量级爬虫框架来写,于是我在owllook里面编写了一个很轻量的爬虫框架来做这件事,见 ruia
BTW,sanic写界面确实不是很方便,至于为什么写这个,一是想利用sanic
尽量做成异步服务,二是想就此练习下推荐系统,顺便作为毕业设计
请先装好mongo以及redis,不会安装mongo看这里,owllook
使用pipenv
管理虚拟环境,所以使用前请确保安装一个Python3.6
环境(比如我这里环境路径在/Users/howie/anaconda3/envs/python36/bin/python3.6
),然后安装好pipenv
mongo以及redis装好后,进入项目目录,依照步骤执行:
# 下载代码
git clone https://github.com/howie6879/owllook
cd owllook
pip install pipenv
pipenv install --python /Users/howie/anaconda3/envs/python36/bin/python3.6
# 进入虚拟环境
pipenv shell
# 方案一
# 运行:
cd owllook
python server.py
# 或者
gunicorn --bind 127.0.0.1:8001 --worker-class sanic.worker.GunicornWorker server:app
# 方案二 推荐
# 直接下载镜像
docker pull howie6879/owllook
# 创建dev_owllook.env文件
vim dev_owllook.env
# 写入一些环境变量
# start ===============
# 需要设置就填写 不需要就删掉
MODE=DEV
REDIS_ENDPOINT= ip
REDIS_PORT= port
REDIS_PASSWORD=''
MONGO_HOST= ip
MONGO_PORT= port
MONGO_USERNAME=''
MONGO_PASSWORD=''
# end ===============
# 运行 在dev_owllook.env里面填上数据库配置 数据库ip需要注意 请将连接ip设置为ifconfig显示的ip
docker run --env-file ./dev_owllook.env -d -p 8001:8001 howie6879/owllook:latest
# 也可以自己打包
docker build -t owllook:0.1 .
# 运行
docker run --env-file ./dev_owllook.env -d -p 8001:8001 owllook:0.1
- 多搜索源
- 丰富的解析源
- 界面统一解析
- 完善的阅读体验
- 搜索记录
- 缓存
- 书架
- 书签
- 登录
- 初步兼容手机(后续跟进)
- 注册(开放注册)
- 上次阅读记录
- 最新章节
- 书友推荐(简单地基于相似度进行推荐)
- 目录获取
- 翻页
- 搜索排行
- 章节异步加载 感谢@mscststs
- 排行榜 - 起点+owllook
- 自带爬虫框架,统一爬虫规范,对爬虫感兴趣的可以看看 - ruia
- 评分
- 阅读书单
- 推荐
- 小说圈 - 小说界的消息
首页:
搜索:
榜单:
书架:
目录解析页:
阅读:
为什么首页榜单为空白?
这个是根据小说搜索次数显示的,每天刷新一次,使用多了就会有
为什么会出现302跳转?
为了防止直接运行服务被恶意域名绑定,所以作出如下修改:
vim config/config.py
# 将 true 改为 false
VAL_HOST = os.getenv('VAL_HOST', 'true')
VAL_HOST = os.getenv('VAL_HOST', 'false')
小说榜单页面为什么没有内容?
需要运行owllook/spiders/spider_console.py
,
目前代码中是设定60分钟运行一次,运行的时候请酌情更改,
os.environ['MODE'] = 'PRO'
这段代码也请注释掉
owllook使用了以下第三方包:
-
sanic:基于Python 3.5+的异步web服务器
-
motor:异步的mongodb驱动
-
Jinja2:基于python的模板引擎
-
aiohttp:异步请求
-
caddy:基于go的web服务器
…...更多见Pipfile,感谢开发者
web框架:
- bootstrap:Sleek, intuitive, and powerful front-end framework for faster and easier web development.
- mdui:MDUI 是一个基于 Material Design 的前端框架
owllook
is offered under the Apache 2 license.
捐赠:
美酒加咖啡,我只要喝一杯~
感谢以下捐赠者,具体见捐赠名单 ^_^