Procrastiproxy Open-Source reverse proxy
Procrastiproxy is a simple, configurable proxy that helps you focus by blocking distracting websites.
curl https://raw.githubusercontent.com/zackproser/procrastiproxy/main/install.sh | bash
Example: block reddit and twitter during work hours
procrastiproxy --block reddit.com,twitter.com
Procrastiproxy implements an in-memory, mutable list for tracking hosts that should be blocked. This in-memory list allows for fast (O(1) or "constant time") look-ups of blocked hosts.
graph TD
A[User] -->|Itches to browse something distracting| B(GET reddit.com/)
B --> C(Procrastiproxy)
C --> D{Should this request be allowed?}
D -->|It's not working hours| E(Allow Request)
D -->|It's time to work!| F(Access denied!)
Install with one command
To install procrastiproxy as a command-line interface (CLI) tool, you can execute the install script:
curl https://raw.githubusercontent.com/zackproser/procrastiproxy/main/install.sh | bash
Install as a library
You can import procrastiproxy into your own project:
import github.com/zackproser/procrastiproxy
Install via Go
You can install and use procrastiproxy as a command line interface (CLI) tool:
go install github.com/zackproser/procrastiproxy
Build from source and run locally
go build -o procrastiproxy ./cmd
./procrastiproxy --port 8001
The block list is kept in-memory and is implemented as a map for fast lookups. You can set your baseline block list in .procrastiproxy.yaml. It can be modified at runtime via the admin control endpoints described below.
Make a request to the <server-root>/admin/ path, passing either block or unblock followed by a host, like so:
curl http://localhost:8001/admin/block/reddit.com
curl http://localhost:8001/admin/unblock/reddit.com
If a request is made to procrastiproxy within the configured office hours, the request will be examined and blocked if its host is on the block list. If a request is made to procrastiproxy outside of the configured office hours, it will be allowed.
Procrastiproxy comes complete with tests to verify its functionality.
go test