JavBus API

一个自我托管的 JavBus API 服务

用途

可以用来搭建自己的视频信息网站
可以作为 App 的 API 服务
可以作为爬虫的数据源
可以用来制作 iOS/macOS 快捷指令
可以用来开发 Telegram 机器人
等等...

部署与启动

注意：本程序仅仅是 JavBus 的一个在线转换服务，因此不依赖数据库服务，每个请求会实时请求 JavBus 对应的网页，解析之后返回对应的 json 数据。因此，如果 JavBus 网站无法访问，本程序也无法正常工作

Note

目前使用美国 IP 代理或者部署在美国地区 VPS 上，JavBus 会跳转到登录页面，导致本程序无法获取数据，请使用其他地区的 IP 代理或者 VPS

Docker 部署（推荐）

Docker Hub 地址

$ docker pull ovnrain/javbus-api
$ docker run -d \
    --name=javbus-api \
    --restart=unless-stopped \
    -p 8922:3000 \
    ovnrain/javbus-api

启动一个 Docker 容器，将其名称设置为 javbus-api，端口设置为 8922，并且自动重启

使用 Docker Compose 配合 NGINX 部署

以下配置仅为示例，具体配置请根据自己的实际情况进行修改

docker-compose.yml:

version: '3.8'

services:
  api:
    image: ovnrain/javbus-api
    restart: unless-stopped
    # 端口可选，不配置端口时，NGINX 依然可以通过容器内部网络访问 API
    # ports:
    #   - '3000:3000'

  nginx:
    image: nginx:stable-alpine
    ports:
      - '8922:80'
    depends_on:
      - api
    volumes:
      - ./html:/usr/share/nginx/html:ro
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./logs:/var/log/nginx
    restart: unless-stopped

nginx.conf:

# 其他配置省略...

http {
  # 其他配置省略...

  server {
    listen 80;
    server_name example.com;

    location /api {
      proxy_pass http://api:3000;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Host $host;

      proxy_hide_header Cache-Control;

      proxy_cache_bypass $http_upgrade;
      proxy_http_version 1.1;
      proxy_redirect off;

      add_header Cache-Control no-cache;
    }

    location / {
      root /usr/share/nginx/html;
      index index.html;
    }
  }
}

启动容器:

$ docker-compose up -d

启用 https 服务器

$ docker run -d \
    --name=javbus-api \
    --restart=unless-stopped \
    -p 8922:3000 \
    -v /path/to/your/cert:/certs \
    -e SSL_CERT=/certs/ssl.crt \
    -e SSL_KEY=/certs/ssl.key \
    ovnrain/javbus-api

注意：-v 和 -e SSL_CERT、-e SSL_KEY 这三个参数必须同时使用，否则无法启用 https 服务器

使用代理

$ docker run -d \
    --name=javbus-api \
    --restart=unless-stopped \
    -p 8922:3000 \
    -e HTTP_PROXY=http://192.168.5.123:1082 \
    ovnrain/javbus-api

HTTP_PROXY 可以设置为 http、https、socks、 socks5 等代理地址

Node.js 部署

$ git clone https://github.com/ovnrain/javbus-api.git
$ cd javbus-api
$ nvm use # 可选，使用 .nvmrc 中指定的 Node.js 版本，关于 nvm 的安装与使用，请参考 https://github.com/nvm-sh/nvm
$ pnpm install # 或者 npm install 或者 yarn install
$ npm run build
$ echo "PORT=8922" > .env # 可选，默认端口为 `3000`
$ npm start

启用 https 服务器

$ SSL_CERT=/path/to/your/cert/ssl.crt SSL_KEY=/path/to/your/cert/ssl.key npm start

或者编辑 .env 文件，添加以下环境变量：

SSL_CERT=/path/to/your/cert/ssl.crt
SSL_KEY=/path/to/your/cert/ssl.key

使用代理

$ HTTP_PROXY=http://192.168.5.123:1082 npm start

或者编辑 .env 文件，添加以下环境变量：

HTTP_PROXY=http://192.168.5.123:1082

HTTP_PROXY 可以设置为 http、https、socks、 socks5 等代理地址

使用 PM2 保持服务后台常驻

$ npm install -g pm2
$ pm2 start npm --name javbus-api -- start

关于 PM2 的详细使用方法，请参考 PM2 官方文档

Vercel 部署

使用 Vercel 部署的优势在于：

无需自己购买服务器
无需配置环境依赖
无需配置代理
无需配置 https 证书
公网访问，即开即用

点击下方按钮，即可将本项目一键部署到 Vercel 上

Note

部署在美国地区的 Vercel 上，JavBus 会跳转到登录页面，导致本程序无法获取数据，请使用其他地区的 Vercel。设置方法：在 Vercel 项目的 Settings -> Functions 中选择除美国以外的地区，如日本、香港等

权限校验

Note

本项目默认不开启权限校验，即任何人都可以访问。如果项目部署在公网上，建议开启权限校验，以防止被恶意访问

权限校验目前有两种方式：

1. 使用用户名密码

设置以下环境变量：

ADMIN_USERNAME=your_username
ADMIN_PASSWORD=your_password
# 可选，用于加密 session
JAVBUS_SESSION_SECRET=your_session_secret

重新部署项目，首页会出现登录按钮，点击进入登录页面，输入用户名密码即可。如果在未登录的情况下访问 API，会跳转到登录页面。这种方式适合在浏览器中访问，如果是在 App 中访问，建议使用第二种方式

2. 使用 Token

这种方式需要在请求头中添加 j-auth-token 字段，值为 your_token

设置以下环境变量：

JAVBUS_AUTH_TOKEN=your_token

重新部署项目，即可使用 Token 访问 API

下面是几个例子：

使用 curl

$ curl -H "j-auth-token: your_token" http://localhost:8922/api/stars/okq

使用 Wget

$ wget --header="j-auth-token: your_token" http://localhost:8922/api/stars/okq

使用 REST Client

GET http://localhost:8922/api/stars/okq HTTP/1.1
j-auth-token: your_token

关于 Docker、Node.js 的环境变量设置方式，请参考上面的部署方法。Vercel 设置环境变量可以在项目的 Settings -> Environment Variables 中设置

Note

只设置 JAVBUS_AUTH_TOKEN 环境变量是不安全的，用户依然可以通过不加 j-auth-token 请求头，或者在浏览器中直接访问 API。因此，应该同时设置 ADMIN_USERNAME 和 ADMIN_PASSWORD 环境变量，以达到双重校验的目的

API 文档

/api/movies

获取影片列表

method

GET

参数

参数	是否必须	可选值	默认值	说明
page	否		`1`	页码
magnet	否	`exist` `all`	`exist`	`exist`: 只返回有磁力链接的影片 `all`: 返回全部影片
filterType	否	`star` `genre` `director` `studio` `label` `series`		筛选类型，必须与 `filterValue` 一起使用 `star`: 演员 `genre`: 类别 `director`: 导演 `studio`: 制作商 `label`: 发行商 `series`: 系列
filterValue	否			筛选值，必须与 `filterType` 一起使用
type	否	`normal` `uncensored`	`normal`	`normal`: 有码影片 `uncensored`: 无码影片

请求举例

/api/movies

返回有磁力链接的第一页影片

/api/movies?filterType=star&filterValue=rsv&magnet=all

返回演员 ID 为 rsv 的影片的第一页，包含有磁力链接和无磁力链接的影片

/api/movies?page=2&filterType=genre&filterValue=4

返回类别 ID 为 4 的影片的第二页，只返回有磁力链接的影片

/api/movies?type=uncensored

返回无码影片的第一页，只返回有磁力链接的影片

返回举例

点击展开

{
  // 影片列表
  "movies": [
    {
      "date": "2023-04-28",
      "id": "YUJ-003",
      "img": "https://www.javbus.com/pics/thumb/9n0d.jpg",
      "title": "夫には言えない三日間。 セックスレスで欲求不満な私は甥っ子に中出しさせています。 岬ななみ",
      "tags": ["高清", "字幕", "3天前新種"]
    }
    // ...
  ],
  // 分页信息
  "pagination": {
    "currentPage": 1,
    "hasNextPage": true,
    "nextPage": 2,
    "pages": [1, 2, 3]
  },
  // 筛选信息，注意：只有在请求参数包含 filterType 和 filterValue 时才会返回
  "filter": {
    "name": "岬ななみ",
    "type": "star",
    "value": "rsv"
  }
}

/api/movies/search

搜索影片

method

GET

参数

参数	是否必须	可选值	默认值	说明
keyword	是			搜索关键字
page	否		`1`	页码
magnet	否	`exist` `all`	`exist`	`exist`: 只返回有磁力链接的影片 `all`: 返回全部影片
type	否	`normal` `uncensored`	`normal`	`normal`: 有码影片 `uncensored`: 无码影片

请求举例

/api/movies/search?keyword=三上

搜索关键词为 三上 的影片的第一页，只返回有磁力链接的影片

/api/movies/search?keyword=三上&magnet=all

搜索关键词为 三上 的影片的第一页，包含有磁力链接和无磁力链接的影片

返回举例

点击展开

{
  // 影片列表
  "movies": [
    {
      "date": "2020-08-15",
      "id": "SSNI-845",
      "img": "https://www.javbus.com/pics/thumb/7t44.jpg",
      "title": "彼女の姉は美人で巨乳しかもドS！大胆M性感プレイでなす術もなくヌキまくられるドMな僕。 三上悠亜",
      "tags": ["高清", "字幕"]
    }
    // ...
  ],
  // 分页信息
  "pagination": {
    "currentPage": 2,
    "hasNextPage": true,
    "nextPage": 3,
    "pages": [1, 2, 3, 4, 5]
  },
  "keyword": "三上"
}

/api/movies/{movieId}

获取影片详情

method

GET

请求举例

/api/movies/SSIS-406

返回番号为 SSIS-406 的影片详情

返回举例

点击展开

{
  "id": "SSIS-406",
  "title": "SSIS-406 才色兼備な女上司が思う存分に羽目を外し僕を連れ回す【週末限定】裏顔デート 葵つかさ",
  "img": "https://www.javbus.com/pics/cover/8xnc_b.jpg",
  // 封面大图尺寸
  "imageSize": {
    "width": 800,
    "height": 538
  },
  "date": "2022-05-20",
  // 影片时长
  "videoLength": 120,
  "director": {
    "id": "hh",
    "name": "五右衛門"
  },
  "producer": {
    "id": "7q",
    "name": "エスワン ナンバーワンスタイル"
  },
  "publisher": {
    "id": "9x",
    "name": "S1 NO.1 STYLE"
  },
  "series": {
    "id": "xx",
    "name": "xx"
  },
  "genres": [
    {
      "id": "e",
      "name": "巨乳"
    }
    // ...
  ],
  // 演员信息，一部影片可能包含多个演员
  "stars": [
    {
      "id": "2xi",
      "name": "葵つかさ"
    }
  ],
  // 影片预览图
  "samples": [
    {
      "alt": "SSIS-406 才色兼備な女上司が思う存分に羽目を外し僕を連れ回す【週末限定】裏顔デート 葵つかさ - 樣品圖像 - 1",
      "id": "8xnc_1",
      // 大图
      "src": "https://pics.dmm.co.jp/digital/video/ssis00406/ssis00406jp-1.jpg",
      // 缩略图
      "thumbnail": "https://www.javbus.com/pics/sample/8xnc_1.jpg"
    }
    // ...
  ],
  // 同类影片
  "similarMovies": [
    {
      "id": "SNIS-477",
      "title": "クレーム処理会社の女社長 土下座とカラダで解決します 夢乃あいか",
      "img": "https://www.javbus.com/pics/thumb/4wml.jpg"
    }
    // ...
  ],
  "gid": "50217160940",
  "uc": "0"
}

/api/magnets/{movieId}

获取影片磁力链接

method

GET

参数

参数	是否必须	可选值	默认值	说明
gid	是			从影片详情获取到的 `gid`
uc	是			从影片详情获取到的 `uc`
sortBy	否	`date` `size`	`size`	按照日期或大小排序，必须与 `sortOrder` 一起使用
sortOrder	否	`asc` `desc`	`desc`	升序或降序，必须与 `sortBy` 一起使用

请求举例

/api/magnets/SSNI-730?gid=42785257471&uc=0

返回番号为 SSNI-730 的影片的磁力链接

/api/magnets/SSNI-730?gid=42785257471&uc=0&sortBy=size&sortOrder=asc

返回番号为 SSNI-730 的影片的磁力链接，并按照大小升序排序

/api/magnets/SSNI-730?gid=42785257471&uc=0&sortBy=date&sortOrder=desc

返回番号为 SSNI-730 的影片的磁力链接，并按照日期降序排序

返回举例

点击展开

[
  {
    "id": "17508BF5C17CBDF7C77E12DAAD1BDAB325116585",
    "link": "magnet:?xt=urn:btih:17508BF5C17CBDF7C77E12DAAD1BDAB325116585&dn=SSNI-730-C",
    // 是否高清
    "isHD": true,
    "title": "SSNI-730-C",
    "size": "6.57GB",
    // bytes
    "numberSize": 7054483783,
    "shareDate": "2021-03-14",
    // 是否包含字幕
    "hasSubtitle": true
  }
  // ...
]

/api/stars/{starId}

获取演员详情

method

GET

参数

参数	是否必须	可选值	默认值	说明
type	否	`normal` `uncensored`	`normal`	`normal`: 有码影片演员详情 `uncensored`: 无码影片演员详情

请求举例

/api/stars/2xi

返回演员 葵つかさ 的详情

/api/stars/2jd?type=uncensored

返回演员 波多野結衣 的详情

返回举例

点击展开

{
  "avatar": "https://www.javbus.com/pics/actress/2xi_a.jpg",
  "id": "2xi",
  "name": "葵つかさ",
  "birthday": "1990-08-14",
  "age": "32",
  "height": "163cm",
  "bust": "88cm",
  "waistline": "58cm",
  "hipline": "86cm",
  "birthplace": "大阪府",
  "hobby": "ジョギング、ジャズ鑑賞、アルトサックス、ピアノ、一輪車"
}

Name		Name	Last commit message	Last commit date
Latest commit History 253 Commits
.github/workflows		.github/workflows
.husky		.husky
.vscode		.vscode
api		api
design		design
public		public
.dockerignore		.dockerignore
.eslintignore		.eslintignore
.eslintrc.commit.json		.eslintrc.commit.json
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
.prettierrc		.prettierrc
Dockerfile		Dockerfile
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
tsconfig.json		tsconfig.json
vercel.json		vercel.json

ovnrain/javbus-api

Folders and files

Latest commit

History

Repository files navigation

JavBus API

目录

用途

部署与启动

Docker 部署（推荐）

使用 Docker Compose 配合 NGINX 部署

启用 https 服务器

使用代理

Node.js 部署

启用 https 服务器

使用代理

使用 PM2 保持服务后台常驻

Vercel 部署

权限校验

1. 使用用户名密码

2. 使用 Token

API 文档

/api/movies

method

参数

请求举例

返回举例

/api/movies/search

method

参数

请求举例

返回举例

/api/movies/{movieId}

method

请求举例

返回举例

/api/magnets/{movieId}

method

参数

请求举例

返回举例

/api/stars/{starId}

method

参数

请求举例

返回举例

Star 趋势

About

Topics

Resources

Stars

Watchers

Forks

Releases 14

Packages 0

Languages

Packages