P0RN-PROXY(1)

πŸ“¦ version 0.0.4, in fedora 43, fedora 44

✨ NAME ✨

p0rn-proxy β€” bestie, it's an HTTP proxy for comfortably browsing p0rn πŸ’… (this page lives in the p0rn-comfort manual, if you were wondering πŸŽ€)


🌸 SYNOPSIS 🌸

p0rn-proxy

[ --addr addr ] [ --configfile configfile ] [ --help ] [ --port port ]
[ --proxy proxy ] [ --version ]

p0rn-proxy [ -a addr ] [ -c configfile ] [ -h ] [ -p port ] [ -P proxy ]
[ -V ]

πŸ¦‹ OVERVIEW πŸ¦‹

So p0rn-proxy is a tiny little proxy, lowkey adorable, written in Perl πŸ’– And what it does is chef's kiss: it sprinkles some extra links at the top of every HTML page, so you can tag a page as a thumbnail site and blacklist it, or as a site containing pictures, or as a picture site worth downloading πŸ”₯ It also lets you get in there and administrate the proxy's link database, which is giving admin energy, ngl πŸ‘‘


πŸ‘‘ DESCRIPTION πŸ‘‘

Just start p0rn-proxy. Fr fr, that's it. By default it creates a proxy running on http://localhost:8080 (and it will fail if something else is already squatting on that port, no cap πŸ’€). Then point your browser at the proxy. Browse some website and see all those extra links chilling at the top of each page ✨ Now go browse some p0rn and start blacklisting those annoying thumbnail sites that have no real content, we hate them 🚫 After you've marked pages for download, run p0rn-download(1) to actually go get them 🫢

πŸ’… Switches πŸ’…

  • --addr addr βŽͺ -a addr β€” this is the IP address that p0rn-proxy will bind to. This address (together with the correct port) has to be configured in your browser to actually make use of the proxy, okay?
Be careful bestie 😭 Everybody who can reach the port on this address can use your proxy. You should bind to an address that's only reachable from your local net, or use a packet filter to 'guard' p0rn-proxy from the outside. Do not skip this part.

The address 0.0.0.0 will bind p0rn-proxy to all of your network devices 🌈

Default is to bind to address 127.0.0.1, because that address can only be accessed from your local computer and is not accessible from the network πŸ™ Please take care when binding to another address. Like, actual care.

  • --configfile configfile βŽͺ -c configfile β€” the options from the given configuration file will be read πŸ“– These options can be overridden by other command line arguments (command line stays winning, periodt).

Default is not to read a configuration file.

  • --help βŽͺ -h β€” this prints a short help text and exits. Cute and efficient πŸ’–
  • --port port βŽͺ -p port β€” this is the port on which the proxy listens to your incoming requests πŸ‘‚ This port (together with the correct address) has to be configured in your browser to make use of the proxy.

Default setting is port 8080.

  • --proxy proxy βŽͺ -P proxy β€” if this variable contains a value, the given proxy is used by p0rn-proxy. This lets you chain multiple proxies together, proxy-ception πŸŒ€

Example: if you need a proxy to access the Internet, then point your browser to the p0rn-proxy, and in turn point p0rn-proxy to your original proxy. Slay.

Set this to none to use no proxy at all.

Default is to use the environment variable ${http_proxy}.

  • --version βŽͺ -V β€” this prints the current version of p0rn-proxy and exits. Identity reveal, iconic πŸ’…

πŸŽ€ Configuration file format πŸŽ€

Configuration is also possible via configuration files, bc sometimes you don't wanna type flags every time. Every command line switch is possible in a configuration file. Empty lines and lines starting with # are ignored (they're just vibing).

Instead of --port 3128 you would put this line in the configuration file:

 port = 3128

and so on and so forth ✨


πŸ“ FILES πŸ“

All data is stored in a database πŸ’Ύ By default, it is located in ./p0rn.db (yes, that's the directory from which you're starting p0rn-proxy, we're not being subtle here). If you want to change this, set the environment variable P0RNDBLOCATION (the second letter is a zero, don't come for me, that's just how it is πŸ’€) to another path and filename.


🌈 SEE ALSO 🌈

p0rn-download(1), p0rn-dbdump(1), p0rn-dbrestore(1) β€” the whole friend group 🫢


⭐ MODULES NEEDED ⭐

 use AppConfig;
 use DBM:Deep;
 use HTTP::Daemon;
 use LWP::UserAgent;

These modules can be obtained from <http://www.cpan.org> 🧚


πŸ’€ BUGS πŸ’€

In the default configuration, p0rn-proxy supports NO ACCESS CONTROL! 😭 Not a single one. Everyone with access to the proxy port on your system will be able to use the proxy. Please bind p0rn-proxy to a port that is either only available from your local network or protected by a packet filter. This is not a drill, bestie πŸ™ˆ

Please report bugs by mail to <p0rn-bugs@cgarbs.de>.


πŸ’œ AUTHOR πŸ’œ

p0rn-proxy was written by Christian Garbs <mitch@cgarbs.de>. King behavior πŸ‘‘


πŸ”₯ AVAILABILITY πŸ”₯

Look for updates at <http://www.cgarbs.de/p0rn-comfort.en.html> 🌸


p0rn-proxy is licensed under the GNU GPL.


Okay bestie that's the whole page πŸ’– This was version 0.0.4, dated 2004-11-20, from the p0rn-comfort manual. Go forth and browse comfortably πŸ¦‹βœ¨πŸ’…
πŸ“¦ where this page comes from