Skip to content

Latest commit

 

History

History
48 lines (34 loc) · 3.51 KB

README.en.md

File metadata and controls

48 lines (34 loc) · 3.51 KB

Accesser

中文版本

A tool that solves SNI RST, which blocks sites like Wikipedia and Pixiv on the main land of China.

Because the main users of this project are in mainland China, you may encounter a lot of Chinese. Google translate may help you.

Supported sites

Usage

If you don't know what Python is

Download Windows executable program from here and run it. The first time you use it, you will be asked to install a certificate, just select yes.

If Python 3.10* or later is already installed

pip3 install -U "accesser[doh,doq]"

If you don't need DNS-over-HTTPS and DNS-over-QUIC, you can install without [doh,doq].

Then launch it with the following command:

accesser

For Windows, by default (without specifying --notsetproxy) it will set the system PAC proxy to https://localhost:7654/pac/?t=<random number>, if not you can set it manually.

In addition, for Windows, by default (without specifying --notimportca) the certificate will be imported to the system automatically, if not you can import it manually, please see here.

*You can use, for example, pyenv to install the required version of Python (Python 3.11+ is recommended).

Configuration

After starting Accesser once, config.toml will be generated in the working directory. See the comments therein. After saving, reopen the program.

Advanced Usage 1: Use with other proxy software such as v2ray

Accesser is a local HTTP proxy with a default proxy address of https://localhost:7654, which can be used in combination with other proxy software as long as the network traffic can be exported as HTTP proxy.

Take v2ray as an example, you can add an HTTP outbound pointing to https://localhost:7654 and set the corresponding routing rules to send traffic from sites like Wikipedia, Pixiv, etc. to this outbound. And then run Accesser with the argument --notsetproxy to prevent Accesser from setting the system proxy.

In addition, you can set up a DNS outbound and then edit config.toml to allow Accesser to use this DNS.

Advanced Usage 2: Add sites

Edit the pac file in the working directory (if it is a Windows executable program, you can download this file from GitHub to the working directory), so that the websites to be supported can pass through the proxy.

However, not all sites will work straight away and may require some adjustment, see How to adapt sites.