docs: Add Cloudflare troubleshooting section to README
All checks were successful
build-and-push / lint (push) Successful in 7s
build-and-push / sonar (push) Successful in 19s
build-and-push / docker (push) Successful in 11s

- Document 'Incorrect response' error and solutions
- Add FlareSolverr usage instructions
- Add common issues table
- Improve Firefox user.js for better Cloudflare compatibility
This commit is contained in:
root 2026-03-08 14:06:49 +00:00
parent 48c861b3de
commit 23ca522094
2 changed files with 57 additions and 4 deletions

View file

@ -45,10 +45,17 @@ rm -f "$BROWSER_DIR"/parent.lock "$BROWSER_DIR"/lock "$BROWSER_DIR"/.parentlock
# Only write the prefs file when the volume is writable (container runs as non-root).
if [ -w "$BROWSER_DIR" ] && { [ ! -e "$BROWSER_DIR/user.js" ] || [ -w "$BROWSER_DIR/user.js" ] || rm -f "$BROWSER_DIR/user.js" 2>/dev/null; }; then
cat << 'EOT' > "$BROWSER_DIR/user.js"
user_pref("privacy.resistFingerprinting", true);
// user_pref("privacy.resistFingerprinting.letterboxing", true);
// user_pref("browser.contentblocking.category", "strict");
// user_pref("webgl.disabled", true);
// Anti-fingerprinting settings for Cloudflare bypass
user_pref("privacy.resistFingerprinting", false); // Can trigger Cloudflare
user_pref("privacy.resistFingerprinting.letterboxing", false);
user_pref("browser.contentblocking.category", "standard");
user_pref("webgl.disabled", false); // WebGL needed for some bot detection
user_pref("webgl.enable-webgl2", true);
user_pref("javascript.use_us_english_locale", true);
user_pref("intl.accept_languages", "en-US,en");
user_pref("privacy.trackingprotection.enabled", false); // Can interfere with Cloudflare
user_pref("network.http.referer.default_policy", 2);
user_pref("network.http.referer.XOriginPolicy", 0);
EOT
else
echo "Warning: $BROWSER_DIR not writable; skipping user.js creation."