Skip to content

Latest commit

 

History

History
152 lines (98 loc) · 4.82 KB

README.md

File metadata and controls

152 lines (98 loc) · 4.82 KB

dandanplay-resource-service

GitHub release GitHub All Releases

API implementations for "dandanplay" resource search service.
弹弹play 资源搜索节点的 API 实现。

提供基于 Cloudflare Workers 和 Golang 的两种实现。

Cloudflare Workers

注册一个 Cloudflare 免费账户即可部署，无需 远程服务器 或 常驻任何本地程序 。

部署

复制 worker.js 内容到 workers.dev 脚本编辑页面 中，部署即可。

  • 可在搜索引擎中搜索 "Cloudflare Workers部署教程" ，参照进行。
  • 由于暂未实现 缓存机制 ，且 Cloudflare Workers 免费版账户有每日 100,000 的请求次数限制，目前暂不提供演示站点。可以自行部署体验。

开发

若需修改源码，可以依照以下步骤自行生成 worker.js :

  1. 安装 wrangler 。

    若为 Windows 系统，建议选择 二进制文件安装 。

  2. 修改源码并重新构建：

    $ git clone https://github.com/LussacZheng/dandanplay-resource-service.git
$ cd dandanplay-resource-service/cf-worker

# 按需修改源码

$ wrangler build
# or
$ npm run build

  3. 输出文件位于 cf-worker/dist/worker.js 。

Golang

部署

从 Releases 页面 下载预编译的可执行文件到 本地 或 服务器 ，运行即可。

或直接部署到 Heroku :
Deploy to Heroku

运行

$ dandanplay-resource-service -h
API implementations for "dandanplay" resource search service, in Golang.

Usage:
  dandanplay-resource-service [flags]

Flags:
  -h, --help           help for dandanplay-resource-service
  -H, --host string    IP address the API listens on, such as "0.0.0.0", "127.0.0.1", or "192.168.0.100" (default "localhost")
  -P, --port string    Listen port of the API (default "8080")
  -x, --proxy string   Proxy address for web scraper, "http" and "socks5" are supported
  -V, --version        Print the version number of dandanplay-resource-service

例如：

# 无参数，默认运行在 localhost:8080
$ dandanplay-resource-service

# 自定义端口 和 代理地址(可省略 "http://")
$ dandanplay-resource-service -P 9000 -x 127.0.0.1:10809

# 运行在 34543 端口并暴露服务到公网
$ dandanplay-resource-service -H 0.0.0.0 -P 34543

访问根路径可以看到简易的测试页面。

开发

若需修改源码或自行编译，则需要 Go 语言 开发环境。

$ git clone https://github.com/LussacZheng/dandanplay-resource-service.git
$ cd dandanplay-resource-service/golang

# go env -w GO111MODULE=on
# go env -w GOPROXY=https://goproxy.cn,direct

# 直接编译
$ go build

# 优化可执行文件大小
$ go build -ldflags="-s -w"
$ upx --lzma --best dandanplay-resource-service*

相关项目

Python

个人推荐使用 poetry 进行依赖管理。 
$ cd python

# 安装依赖
$ poetry install
# 或
$ poetry install --no-dev

# 运行脚本，如
$ poetry run python dandanplay-resource-service.py proxy=http://127.0.0.1:10809
# 或
$ poetry run python dandanplay-resource-service.py host=0.0.0.0 port=34543 proxy=""

# 打包
$ poetry run poe build

PHP

参考资料

  1. API Specification - 弹弹play资源搜索节点API规范
  2. 关于“资源搜索”功能即将下线的通知
  3. 资源搜索相关问题的解答

Contributing

Issues, pull requests, and discussions are always welcome.

License

This project is licensed under the Apache-2.0 License.