Troubleshooting

Solve common problems and errors you may encounter when using the Website Access Restriction Tool.

Problem Categories

Installation Issues

Problem: Permission errors during installation

Received permission denied errors when trying to install the tool.

Solution

  • Run the installer as an administrator
  • Ensure you have sufficient system permissions
  • Check if antivirus software is blocking the installation
  • Try downloading the installation files locally before running

Problem: Tool fails to start after installation

Installation succeeded but the tool fails to start or closes immediately.

Solution

  • Check system compatibility (ensure your OS version is supported)
  • Install necessary runtime libraries and dependencies
  • Check firewall settings
  • View log files for detailed error information

Configuration Problems

Problem: Configuration changes not taking effect

After modifying the configuration file, the settings are not applied.

Solution

  • Restart the application to reload the configuration
  • Check if the configuration file format is correct (use JSON validation tools)
  • Ensure the configuration file is located in the correct directory
  • Check file permissions to ensure the application can read the configuration file

Problem: Configuration file format error

The application reports that the configuration file format is incorrect.

Solution

  • Use JSON validation tools to check the configuration file
  • Check if brackets, quotes, and commas are correct
  • Restore the default configuration file and modify it step by step
  • Refer to configuration examples in the documentation

Blocking Issues

Problem: Some websites not blocked

Websites added to the block list can still be accessed.

Solution

  • Check if URL format is correct (including protocol and www)
  • Try adding multiple variants (e.g., example.com and www.example.com)
  • Check if website uses HTTPS redirection
  • Confirm the entry is enabled in configuration (enabled: true)

Problem: Blocking rules too strict

Blocking rules affect websites that shouldn't be blocked.

Solution

  • Check if wildcard rules are too broad
  • Use more specific URL matching
  • Add exception rules (whitelist)
  • Use regular expressions for more precise matching

Performance Issues

Problem: Slow internet speed

Internet browsing speed is slower after installing the tool.

Solution

  • Disable content filtering features (if enabled)
  • Reduce the number of entries in the block list
  • Optimize regular expression rules
  • Check system resource usage

Problem: High system resource usage

The tool is consuming excessive CPU or memory resources.

Solution

  • Reduce content scanning frequency
  • Simplify filtering rules
  • Update to the latest version (may include performance optimizations)
  • Check for memory leaks

Network Issues

Problem: VPN or proxy not working properly

When using VPN or proxy, the tool cannot properly block websites.

Solution

  • Configure the tool to monitor VPN/proxy traffic
  • Implement blocking at network layer rather than application layer
  • Check VPN/proxy DNS settings
  • Consider implementing blocking at router level

Getting Help

If you cannot resolve the issues you encounter, you can get help through the following ways:

Collect Diagnostic Information

Before seeking help, please collect the following information:

  • Operating system version and architecture
  • Tool version number
  • Detailed error messages
  • Configuration file content (remove sensitive information)
  • Log file content
  • Steps to reproduce the problem

Contact Support

You can contact our support team through the following ways:

  • Email: wang.station@hotmail.com
  • GitHub Issues: github.com/Yuanyuan5510/-3.7
  • Community Forum (if available)

Continue Learning

Check our FAQ and API documentation for more information.

FAQ API Reference

Legacy Version Usage Instructions

We are committed to providing users with the best product experience and technical support. With the continuous development of technology, we have had to adjust our support strategy for older versions:

Versions No Longer Supported

Except for versions 1+ and 2+, all other older versions (including but not limited to v0.1-v1.0, v2.0-v2.9, etc.) are no longer supported. This means:

Reasons for Discontinuation

  1. Outdated Technology: Older versions are based on outdated technical architectures and cannot adapt to modern operating systems and browser environments
  2. Security Risks: Older versions have potential security vulnerabilities that cannot be fixed in a timely manner
  3. High Maintenance Costs: Maintaining multiple versions simultaneously diverts development resources, affecting the iteration speed of new versions
  4. Large Function Differences: Older versions have significant functional differences from the current version, resulting in high support costs

Recommended Upgrade Path

If you are still using an unsupported older version, we strongly recommend upgrading to the latest version:

  1. Back up your current configuration data (if any)
  2. Uninstall the old version of the software
  3. Download the latest version from our official website: https://websiteblocker.vercel.app/download
  4. Install the latest version and reconfigure your settings
Important Note

Continuing to use unsupported older versions may cause the software to not work properly, pose security risks, and may be incompatible with new operating systems. Please upgrade to the latest version as soon as possible for the best experience and security.