summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorlolcat <will@lolcat.ca>2024-05-26 13:59:29 -0400
committerlolcat <will@lolcat.ca>2024-05-26 13:59:29 -0400
commita2c595b6f2b543f7b1e21420aa23093260481946 (patch)
tree6bba08660a3d2b75d3f596337c35aa0de64be367 /docs
parent08dd803e2dba51d981ec2f90a302dce2300ccd16 (diff)
why does this keep disappearing
Diffstat (limited to 'docs')
-rw-r--r--docs/configure.md40
1 files changed, 35 insertions, 5 deletions
diff --git a/docs/configure.md b/docs/configure.md
index c1b6afe..7cc4175 100644
--- a/docs/configure.md
+++ b/docs/configure.md
@@ -2,21 +2,51 @@
Welcome! This guide assumes that you have a working 4get instance. This will help you configure your instance to the best it can be!
-## Files location
+# Files location
1. The main configuration file is located at `data/config.php`
2. The proxies are located in `data/proxies/*.txt`
3. The captcha imagesets are located in `data/captcha/your_image_set/*.png`
4. The captcha font is located in `data/fonts/captcha.ttf`
-## Robots.txt
+# Cloudflare bypass
+**Note: this only allows you to bypass the browser integrity checks. Captchas & javascript challenges will not be bypassed.**
+
+Configuring this lets you fetch images sitting behind Cloudflare and allows you to scrape the **Yep** search engine. Following these instructions might make your package manager unhappy.
+
+First, follow these instructions. Only install the Firefox modules:
+
+https://github.com/lwthiker/curl-impersonate/blob/main/INSTALL.md#native-build
+
+Once you did this, you should be able to run the following inside your terminal:
+
+```sh
+$ curl_ff117 --version
+curl 8.1.1 (x86_64-pc-linux-gnu) libcurl/8.1.1 NSS/3.92 zlib/1.2.13 brotli/1.0.9 zstd/1.5.4 libidn2/2.3.3 nghttp2/1.56.0
+Release-Date: 2023-05-23
+Protocols: dict file ftp ftps gopher gophers http https imap imaps mqtt pop3 pop3s rtsp smb smbs smtp smtps telnet tftp ws wss
+Features: alt-svc AsynchDNS brotli HSTS HTTP2 HTTPS-proxy IDN IPv6 Largefile libz NTLM NTLM_WB SSL threadsafe UnixSockets zstd
+```
+Now, after compiling, you should have a `libcurl-impersonate-ff.so` sitting somewhere. Mine (on my debian install) is located at `/usr/local/lib/libcurl-impersonate-ff.so`.
+
+Find the `libcurl.so.4` file used by your current installation of curl. For me, this file is located at `/usr/lib/x86_64-linux-gnu/libcurl.so.4`
+
+Now comes the sketchy part: replace `libcurl.so.4` with `libcurl-impersonate-ff.so`. You can do this in the following way:
+```sh
+sudo rm /usr/lib/x86_64-linux-gnu/libcurl.so.4
+sudo cp /usr/local/lib/libcurl-impersonate-ff.so /usr/lib/x86_64-linux-gnu/libcurl.so.4
+```
+
+Make sure to restart your webserver and/or PHP daemon, otherwise it will keep using the old library. You should now be able to bypass Cloudflare's shitty checks!!
+
+# Robots.txt
Make sure you configure this right to optimize your search engine presence! Head over to `/robots.txt` and change the 4get.ca domain to your own domain.
-## Server listing
+# Server listing
To be listed on https://4get.ca/instances , you must contact *any* of the people in the server list and ask them to add you to their list of instances in their configuration. The instance list is distributed, and I don't have control over it.
If you see spammy entries in your instances list, simply remove the instance from your list that pushes the offending entries.
-## Proxies
+# Proxies
4get supports rotating proxies for scrapers! Configuring one is really easy.
1. Head over to the **proxies** folder. Give it any name you want, like `myproxy`, but make sure it has the `txt` extension.
@@ -34,5 +64,5 @@ If you see spammy entries in your instances list, simply remove the instance fro
Done! The scraper you chose should now be using the rotating proxies. When asking for the next page of results, it will use the same proxy to avoid detection!
-### Important!
+## Important!
If you ever test out a `socks5` proxy locally on your machine and find out it works but doesn't on your server, try supplying the `socks5_hostname` protocol instead. Hopefully this tip can save you 3 hours of your life!