Bilibili-oversea: A Local Adaptive CDN Tool

Download and fully unzip

1. Use the button above to download bilibili-oversea-browser-v2.2.0.zip.
2. Extract the ZIP into a stable folder that will not be cleaned or moved.
3. Open the extracted directory and confirm that manifest.json, src, and assets are directly inside it.

Load it in Chrome or Edge

First run and automatic measurement

1. After installation, refresh any open Bilibili video, anime, or course page, then start playback.
2. The extension watches the player API first. If no media request is captured within 10 seconds, it falls back to scanning video resources on the page.
3. If this network has a valid result from the last 3 hours, the cached winner is applied immediately.
4. After playback has buffered safely for about 12 seconds, the extension performs a light comparison between the current node and the best backup without interrupting playback.

Extension panel and switching modes

Select the toolbar icon to inspect the current target, recent media request, benchmark results, and dynamic-rule status.

Confirm that the extension is working

1. Open the panel and confirm that the current tab, recent media URL, and rule state are visible.
2. A valid measurement normally shows a bilivideo host, an HTTP 206 partial response, and an installed rule beside the winner.
3. Seek to an uncached point or open another video, then confirm that the recent-media and target fields update.

Update and uninstall

Common troubleshooting

Permissions, traffic, and privacy boundaries

• The extension does not request proxy, cookie, browsing-history, webRequest, or all-sites access.
• Its access is limited to relevant Bilibili pages and bilivideo media hosts.
• The full recent-media URL stays only in extension background memory and is not uploaded to telemetry.
• A full benchmark theoretically transfers about 4 MB. Routine light comparison checks only 2 nodes at roughly 256 KB each.
• The extension source is public in the project repository, including permissions, measurement logic, and dynamic rules.

Before you start

• iOS/iPadOS 16.4 or later is recommended for the native “Connect VPN” Shortcuts action.
• Use one of Surge, Shadowrocket, Loon, or Stash. Do not connect multiple VPN tools at once.
• Your network tool must already have a working main configuration. Bili CDN Auto is a module/plugin; it does not provide proxy nodes or subscriptions.

Import Bili CDN Auto

Use the buttons above to import only the configuration for the network tool you actually use.

Generate, install, and trust your own certificate

Video requests use HTTPS. Your network tool can run the CDN-request script only after the device trusts the CA generated locally by that tool.

• Shadowrocket：Settings → Certificate; generate a new CA, then install it.
• Surge：Home/More → MitM; generate a new CA and install the system profile.
• Loon：Configuration/Settings → MitM → Certificate; generate and install it.
• Stash：Home → MitM → CA Certificate → Stash Generated CA → Install.

1. Open Settings → General → VPN & Device Management (or “Profile Downloaded”).
2. Open the downloaded profile and tap Install.
3. Go to Settings → General → About → Certificate Trust Settings.
4. Enable full trust for the certificate you just generated.
5. Return to the network tool and confirm MitM/HTTPS decryption is enabled.

First connection and basic verification

1. Start the connection in your network tool and allow iOS to add its VPN profile.
2. Return here and select “View status” above.
3. A JSON response containing "ok": true means the local control script is loaded.
4. Open Bilibili and play a video that is not fully cached for at least 15–25 seconds.
5. Check status again. Normally, selectedHost is non-empty and scores contains measurements.

If “View status” fails immediately, the network tool is usually disconnected, the module is disabled, or the main profile did not load it.

Install the “Connect VPN” shortcut

1. Select “Install shortcut” above.
2. Inspect it in Shortcuts: it contains only one system action, “Connect VPN.”
3. Tap “Add Shortcut.”
4. If the device has multiple VPNs, edit the VPN field and choose the client carrying Bili CDN Auto.
5. Run it once, allow the connection, and confirm the VPN indicator appears without switching to another app.

The file is signed with the macOS Shortcuts “Anyone” import mode and contains no accounts, API keys, proxy nodes, or remotely executed code.

Create a personal “When Bilibili opens” automation

Apple does not allow a downloaded file to silently create a personal automation, so confirm these steps once on-device:

1. Open Shortcuts and go to Automation.
2. Tap + at the top right, or “New Automation” on first use.
3. Choose “App.”
4. Tap “Choose,” select Bilibili, then confirm.
5. Select “Is Opened,” not “Is Closed.”
6. Choose “Run Immediately”; the run notification can be disabled if offered.
7. Continue and choose “New Blank Automation.”
8. Add the “Run Shortcut” action.
9. Tap the blue Shortcut field and choose BiliCDNAuto-ConnectVPN.
10. Tap Done.

To test, close Bilibili and the network tool, then open the official Bilibili app. The VPN should connect while the app remains visible; CDN selection runs in the background after playback starts.

Daily use and default policy

• Normally, just open Bilibili; there is no need to revisit the network tool or this page.
• After changing Wi-Fi or cellular networks, the old choice expires; the first request uses the original CDN and selection resumes after the safety delay.
• If playback becomes clearly slower, select “Retest,” then seek to uncached content or reopen the video.
• “Original CDN” restores the platform default, “Automatic mode” re-enables selection, and selectedHost in status shows the current node.

iOS network tools cannot read the player's buffer, so they cannot sample it every two seconds like the browser extension. The 15-second safety delay is a conservative request-layer approximation.

Troubleshooting

URL Scheme fallback

If the system “Connect VPN” action cannot identify your client, use an “Open URL” action in the personal automation:

For Surge and Shadowrocket, autoclose=true returns to the previous app after connecting. Loon and Stash behavior varies by version, so prefer the system action or on-demand connection.

Uninstall and restore

1. Delete the “When Bilibili opens” automation in Shortcuts → Automation.
2. Delete the BiliCDNAuto-ConnectVPN shortcut.
3. Disable or delete the Bili CDN Auto module/plugin/Override in the network tool.
4. If you no longer use HTTPS decryption, remove its certificate profile under Settings → General → VPN & Device Management.
5. Stop the VPN; Bilibili returns to the platform's original CDN behavior.