bilibili-qr-login

Bilibili QR Login is a tool designed to quickly acquire Bilibili (B站) Cookies via QR code scanning. Key features include:

• QR Code Login: Scan to log in to Bilibili accounts.
• Cookie Acquisition: Automatically retrieves login information.
• Cookie Conversion: Converts Cookies to JSON/TinyDB format.
• RESTful API: Supports programmatic access to conversion services.
• TV Login Support: Supports scanning via the 'Cloud Vision Small TV' (云视听小电视) App to obtain TV-specific Token authentication.
• Embedding Support: Compatible with iframe and window modes for integration into other web applications.
• Multi-language & Themes: Supports multiple languages (CN, EN, JP, etc.) and system/manual dark/light modes.

The service provides three primary capabilities for developers:

1. Embedded Login: Supports two modes for embedding the login interface: iframe and window.
2. Cookie Conversion: Automatically converts Bilibili Cookies into a standardized JSON format.
3. Message Communication: Uses postMessage to securely transmit login results between the service and your application.

The login service provides a TV mode which can be toggled via the UI (clicking the TV icon).

TV Mode Cookie Features

When logging in via TV mode, the returned Cookie string includes additional authentication tokens that are not present in standard Web mode:

postMessage Format

The postMessage structure remains identical to Web mode; only the content of the data field changes to include the extra tokens.

Example data string: SESSDATA=xxx; bili_jct=yyy; DedeUserID=123; access_token=abc; refresh_token=def; mid=456; expires_in=7776000

To run the Bilibili Cookie acquisition tool on your own machine, clone the repository and use yarn to install dependencies and start the service. By default, the service runs on localhost:3000.

# 克隆仓库
git clone https://github.com/WittF/bilibili-qr-login.git

# 进入项目目录
cd bilibili-qr-login

# 运行项目
yarn install
yarn start

The demo/ directory contains several implementation templates for different environments:

• example.html: A full integration example demonstrating embedded login and JSON conversion.
• basic.html: A minimal implementation using standard HTML and JavaScript.
• json-convert-example.html: A specialized demonstration of the JSON conversion API.
• vue-example.vue: An example of integrating the service into a Vue 3 application.
• react-example.jsx: An example of integrating the service into a React application.
• API.md: The authoritative API documentation containing request/response formats and field definitions.

If the server needs to access Bilibili through a proxy, use standard proxy environment variables. These affect only the server's outbound requests to Bilibili, not how client IPs are detected.

Priority Order for HTTPS requests:

1. https_proxy / HTTPS_PROXY
2. http_proxy / HTTP_PROXY
3. all_proxy / ALL_PROXY
4. Direct connection

Note: Lowercase variable names (e.g., https_proxy) take precedence over uppercase ones.

Supported Protocols: http://, https://, socks5://, socks5h:// (where socks5h ensures DNS resolution happens at the proxy side).

# HTTP proxy with credentials
https_proxy=http://user:pass@127.0.0.1:7890

# SOCKS5 proxy
https_proxy=socks5://127.0.0.1:1080

# Fallback proxy
all_proxy=socks5://127.0.0.1:1080

# Exclude specific hosts from proxying
no_proxy=localhost,127.0.0.1,.internal

You can deploy the service using Docker by pulling the official image and running a container. Map port 3000 to access the service.

# 拉取镜像
docker pull wittf/bilibili-qr-login:latest

# 运行容器
docker run -d \
  --name bili-qrlogin \
  -p 3000:3000 \
  wittf/bili-qrlogin:latest

To view the integration examples and see how the Bilibili login service works, you can run the local development server and open the provided HTML files. This requires having yarn installed.

1. Start the local development server from the project root.
2. Open the demo/example.html file in your browser to see the integrated login and JSON conversion features.

# 启动本地服务器
yarn dev

# 打开示例页面
open demo/example.html