3wc
ca4b4c0ec7
continuous-integration/drone/push Build is passing
Details
|
||
---|---|---|
.drone.yml | ||
.env.sample | ||
.gitignore | ||
README.md | ||
abra.sh | ||
compose.ssl.yml | ||
compose.yml | ||
proxy.pac.tmpl |
README.md
compy
Compy is an HTTP/HTTPS forward proxy with content compression/transcoding capabilities. One use case is to reduce bandwidth usage when browsing on limited mobile broadband connection.
- Category: Apps
- Status: 1, alpha
- Image:
compy
, 0, own - Healthcheck: No
- Backups: No
- Email: N/A
- Tests: No
- SSO: No
Quick start
abra app new compy --secrets
abra app config <app-name>
abra app deploy <app-name>
(For more abra
commands, see docs.coopcloud.tech
.)
Then, configure an HTTP proxy (either system-wide, or in your app), using:
- Address/hostname: (your configured domain)
- Port: 9999
- Authentication: None (so far..)
SSL (and Man-in-the-Middle)
To enable SSL (recommended), to encrypt the connection between you and Compy, and to enable Man-in-the-Middle (MitM) to prevent hordes of certificate warnings:
abra app config <app-name>
- (uncomment the SSL section)
abra app deploy <app-name> --force
When using SSL, there are a few extra steps to set up your client:
- Download the generated Certificate Authority certificate:
abra app cp <app-name> app:/certs/ca.crt .
- Import and trust this CA -- e.g. for Firefox, "Settings" → "Privacy and Security" → "Certificates" → "Authorities" → "Import".
- Add a security exception for the self-signed certificate that Compy uses for
its own connection (see #1), e.g. by visiting
https://<your-domain>:9999
in your browser. - You may need to clear a certificate cache, if there is one (see below for Firefox)
Troubleshooting
Firefox cert9.db
Firefox has a certificate cache, including HSTS information, which can prevent
Compy from working. Clear it by deleting or renaming
$HOME/.mozilla/firefox/<your-profile>/cert9.db
Firefox & FoxyProxy
FoxyProxy is great. As of March 2022, it doesn't support Proxy Access Configuration files, which Compy needs for working good (FoxyProxy say it's because of an unresolved bug in Firefox). No solution is known at this time 😕