JAVClub
JAVClub

因架构调整,本项目已不再维护并将存档。新项目将支持泛媒体文件管理,相关开发工作将迁移至 @UsagiHouse 进行,请知悉
⚠️ 因 Google Drive 相关服务近期进行转型升级,无限存储空间可能将不再对个人/教育提供,故本项目暂时停止更新。若后续 Google 仍决定以任意一种可承受的方式提供无限存储空间,项目可能将继续更新。若不会继续提供,则项目可能会 archive 或者支持 OneDrive 等其他网盘平台,敬请谅解

Features

简介

这是一个涩情系列 Repos, 包含三个子项目, 分别是 fetcherweb 还有这个项目

稍微逛了一下 GitHub, 发现现有的 JAV 数据库都仅限于存储 Metadata(JAV 元数据[车牌号、cover 等等]) 及没啥用的种子信息, 没法做到在线观看, 所以这就是一个集搜集、下载、存储、观看、管理为一体的东西了

项目应该已经差不多进入了稳定期, 各种 TODO 应该有空有兴趣了会填坑, bugfixs 正常, issues 回复期在一至两周左右, 还请见谅

往下看之前请先确保你已满 18 周岁

Are you 18

TODO

DEMO

感谢某位 dalao 为项目提供非官方演示站, 站点地址在这, 目前开放注册, 数据继承自原演示站(70k+), 欢迎体验 (附: 不提供在线时间保证, 有问题/赞助请联系这里)

因为项目的特殊性就不提供在线 DEMO 了, 仅放一些图片 #SFW

页面截图 (点击展开) ![Home](https://github.com/JAVClub/core/raw/master/docs/Home.png) ![Metadata List](https://github.com/JAVClub/core/raw/master/docs/MetadataList.png) ![Metadata Info Top](https://github.com/JAVClub/core/raw/master/docs/MetadataInfoTop.png) ![Metadata Info Bottom](https://github.com/JAVClub/core/raw/master/docs/MetadataInfoBottom.png) ![Bookmark List](https://github.com/JAVClub/core/raw/master/docs/BookmarkList.png) ![Bookmark Info](https://github.com/JAVClub/core/raw/master/docs/BookmarkInfo.png) ![Tag List](https://github.com/JAVClub/core/raw/master/docs/TagList.png) ![Star List](https://github.com/JAVClub/core/raw/master/docs/StarList.png) ![Series List](https://github.com/JAVClub/core/raw/master/docs/SeriesList.png) ![Profile](https://github.com/JAVClub/core/raw/master/docs/Profile.png)

部署

下面的信息可能有一些繁琐枯燥甚至还有错误, 希望还可见谅, 套用某位 dalao 的话来讲就是一劳永逸, 一旦理解了就没什么困难的了

Docker 部署方式请看这里

部署之前请确保你拥有/完成以下能力/事情:

要正常工作的话总共需要部署几样东西, 它们之间关系是这样的:

fetcher: 抓取种子->推送 qBittorrent 下载->处理->上传 Google Drive
↑
| 通过 Google Drive 相互联系
↓
core: 读取 Google Drive 文件列表->导入本地数据库
↑
| 通过 API 读取数据库中的内容
↓
web: 展示信息
↑
| 用户请求
|
Vercel: 为 Workers 提供 access token
|
| 302 跳转
↓
Workers: 代理 Google Drive 文件及 JAVBus 封面

Fetcher 部署

参照 JAVClub/fetcher

代理部署

参照 JAVClub/proxy

Core&Web 部署

Docker

参照 core - JAVClub/docker

非 Docker

拉取

请确保主机已安装 Node.js 环境 (版本 12.0+), 如未安装可使用 nvm 进行安装

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
nvm install node # "node" is an alias for the latest version

拉取项目

git clone https://github.com/JAVClub/core.git JAVClub_core
cd JAVClub_core
cp config/dev.example.json config/dev.json
npm i
配置文件
配置文件 (点击展开) ```json { "system": { "logLevel": "debug", "port": 3000, "path": "/api", "allowChangeUsername": false, "userMaxBookmarkNum": 10, "userMaxBookmarkItemNum": 100, "corsDomain": [ "https://yourdomain.com" ], "searchParmaNum": 3, "allowSignup": false, "defaultGroup": 2 }, "database": { "dialect": "mysql", "connectionLimit": 5, "host": "mysql", "port": 3306, "username": "javclub", "password": "javclub", "database": "javclub" }, "importer": { "settings": { "googleDrive": { "queueNum": 1 } }, "cron": [ { "driveId": 1, "interval": 36000000, "doFull": true } ] }, "proxy": [ "https://proxy.xiaolin.in/" ] } ```

按照提示修改 config/dev.json 并更改相关配置即可

数据库

因程序不打算弄太复杂, 所以没有安装界面, 请自行导入数据表

在最新版本中终于用上了 migration, 所以现在数据表在启动时会自动创建, 默认的用户名 / 密码为 admin / admin, 请及时修改

配置 Google Drive 相关

core 中的数据来源是 fetcher 上传至 Google Drive 中的数据, 请在使用前 1-2 天部署好 fetcher 以获取足够的数据 (当然你要是想部署完 core 再部署 fetcher 也是没问题的)

首先要做的是往数据库里添加有关 Google Drive 的信息, 样例 SQL 命令如下

INSERT INTO `drivers` (`id`, `name`, `driverType`, `driverData`, `isEnable`, `createTime`, `updateTime`) VALUES
(1, 'My first drive', 'gd', '{\"oAuth\":{\"client_id\":\"【your_client_here】\",\"client_secret\":\"【your_client_secret_here】\",\"redirect_uri\":\"urn:ietf:wg:oauth:2.0:oob\",\"token\":{\"access_token\":\"【your_access_token_here_optional】\",\"refresh_token\":\"【your_refresh_token_here】\",\"scope\":\"https://www.googleapis.com/auth/drive\",\"token_type\":\"Bearer\",\"expiry_date\":1583679345619}},\"drive\":{\"driveId\":\"【your_drive_or_folder_id_here】\"},\"encryption\":{\"secret\":\"【path_ase_secret】\",\"server\":\"【your_gd_proxy_server_here】"}}', 1, '1583679345619', '1583679345619');

driverData 是这部分的核心, 看起来挺乱的, 这里给一个格式化后的方便理解

{
    "oAuth":{
        "client_id":"xxx.apps.googleusercontent.com",
        "client_secret":"",
        "redirect_uri":"urn:ietf:wg:oauth:2.0:oob",
        "token":{
            "access_token":"",
            "refresh_token":"",
            "scope":"https://www.googleapis.com/auth/drive",
            "token_type":"Bearer",
            "expiry_date":1583679345619
        }
    },
    "drive":{
        "driveId":"987b3d98q7deuiedsr",
        "type": "shared"
    },
    "encryption":{
        "secret":"secret",
        "server":"https://proxy.abc.workers.dev,https://proxy.def.workers.dev"
    }
}

更改完后将上面一段 JSON 复制到这里压缩后照本节开头格式插入数据表即可

下一步就是要告诉程序你添加了这个硬盘并且希望扫描/导入这个硬盘中的内容

还记得上文中提到的 cron 部分吗? 那里的 id 便是这里数据表中自动生成的 id

那么就只需要在 dev.json 中的 cron 字段按中所述添加相应内容即可

到现在 core 应该已经配置完成并可以工作了

配置 WebUI

到现在只剩下 WebUI 程序就可以正常工作了, 为了正常工作需要将 core 的 /api 路径代理到你域名下的 /api 路径并将静态资源放置于该域名对应目录的根目录下, 请使用你熟悉的 HTTP 服务端软件来执行此操作(如 Nginx, Caddy 等)

首先是拉取并构建 Web UI

git clone https://github.com/JAVClub/web.git JAVClub_web
cd JAVClub_web
cp src/config.example.js src/config.js
npm i && npm run build

运行完成之后前端资源就已经构建完成了, 位于 ./dist 目录下 这时候只需要在服务端软件中将除 /api 以外的请求重定向至 ./dist 目录即可

启动:
NODE_ENV=dev node src/app.js
# 以及你服务端的启动命令

没有意外的话现在 Web UI 和 API 服务器应该已经启动并正常工作了, 可以观察一下输出日志中有没有错误 (如果有务必将错误日志提交至 Issue

如果有任何不明白的欢迎开 issue 提问

完成

现在 JAVClub 已经成功运行起来了

那么在这里祝你身体健康

其余配置

权限组

新版本新增了权限系统, 数据库由 id name rule time 四个部分组成

其中 id 是权限组 ID, name 是权限组名, rule 是权限组的权限列表, 为 JSON 格式, 如下所示

{
    "admin":true, // 是否为管理员
    "title":"Admin",
    "banned":false, // 是否被封禁
    "invitationNum":-1, // 可以创建的邀请码数量
    "invitationGroup":2 // 邀请码使用者注册到的权限组
}

程序启动时会自动创建 Admin Group User Group Banned Group 三个组, 可按需调整参数

后续

先感谢看完这篇废话连篇的使用文档, 有很多东西可能没有说明白, 如果有问题请尽管开 IS 来轰炸我吧

正常来讲现在整套系统应该已经在正常工作了, 如果没有请再次检查是否漏掉了任何一个步骤

FAQ

可以先参考一下 core#11 core#12 fetcher#3 这里是被踩的最多的坑, 可以看看有没有自己遇到的问题

有关 Docker 部署的任何问题请提交 Issue 或者直接发送邮件询问

现在重写后的 fetcher 也已经支持 OneJAV 了, 所以不需要任何账号都可以正常使用了

说实话我也不知道, 我已经尽最大努力简化安装过程&写说明文档了, 如果还是有不懂的可以提交 Issue

免责声明

本程序仅供学习了解, 请于下载后 24 小时内删除, 不得用作任何商业用途, 文字、数据及图片均有所属版权, 如转载须注明来源

使用本程序必循遵守部署服务器所在地、所在国家和用户所在国家的法律法规, 程序作者不对使用者任何不当行为负责