mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-28 08:03:36 +00:00
74a6042ed8
Closes: #1797. Tests: - For each affected app, install the app, visit frontpage. Select the shortcut. Notice that Learn More... link is shown and clicking on the link takes us to the manual page of the app. Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org> Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
119 lines
4.2 KiB
Python
119 lines
4.2 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""
|
|
FreedomBox app to configure Privoxy.
|
|
"""
|
|
|
|
from django.urls import reverse_lazy
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
from plinth import action_utils, actions
|
|
from plinth import app as app_module
|
|
from plinth import cfg, frontpage, menu
|
|
from plinth.daemon import Daemon
|
|
from plinth.modules.apache.components import diagnose_url
|
|
from plinth.modules.backups.components import BackupRestore
|
|
from plinth.modules.firewall.components import Firewall
|
|
from plinth.modules.users.components import UsersAndGroups
|
|
from plinth.package import Packages
|
|
from plinth.utils import format_lazy
|
|
|
|
from . import manifest
|
|
|
|
_description = [
|
|
_('Privoxy is a non-caching web proxy with advanced filtering '
|
|
'capabilities for enhancing privacy, modifying web page data and '
|
|
'HTTP headers, controlling access, and removing ads and other '
|
|
'obnoxious Internet junk. '),
|
|
format_lazy(
|
|
_('You can use Privoxy by modifying your browser proxy settings to '
|
|
'your {box_name} hostname (or IP address) with port 8118. '
|
|
'While using Privoxy, you can see its configuration details and '
|
|
'documentation at '
|
|
'<a href="http://config.privoxy.org">http://config.privoxy.org/</a> '
|
|
'or <a href="http://p.p">http://p.p</a>.'),
|
|
box_name=_(cfg.box_name)),
|
|
]
|
|
|
|
app = None
|
|
|
|
|
|
class PrivoxyApp(app_module.App):
|
|
"""FreedomBox app for Privoxy."""
|
|
|
|
app_id = 'privoxy'
|
|
|
|
_version = 1
|
|
|
|
def __init__(self):
|
|
"""Create components for the app."""
|
|
super().__init__()
|
|
|
|
info = app_module.Info(
|
|
app_id=self.app_id, version=self._version, name=_('Privoxy'),
|
|
icon_filename='privoxy', short_description=_('Web Proxy'),
|
|
description=_description, manual_page='Privoxy',
|
|
donation_url='https://www.privoxy.org/faq/general.html#DONATE')
|
|
self.add(info)
|
|
|
|
menu_item = menu.Menu('menu-privoxy', info.name,
|
|
info.short_description, info.icon_filename,
|
|
'privoxy:index', parent_url_name='apps')
|
|
self.add(menu_item)
|
|
|
|
shortcut = frontpage.Shortcut(
|
|
'shortcut-privoxy', info.name,
|
|
short_description=info.short_description, icon=info.icon_filename,
|
|
description=info.description, manual_page=info.manual_page,
|
|
configure_url=reverse_lazy('privoxy:index'), login_required=True)
|
|
self.add(shortcut)
|
|
|
|
packages = Packages('packages-privoxy', ['privoxy'])
|
|
self.add(packages)
|
|
|
|
firewall = Firewall('firewall-privoxy', info.name, ports=['privoxy'],
|
|
is_external=False)
|
|
self.add(firewall)
|
|
|
|
daemon = Daemon('daemon-privoxy', 'privoxy',
|
|
listen_ports=[(8118, 'tcp4'), (8118, 'tcp6')])
|
|
self.add(daemon)
|
|
|
|
users_and_groups = UsersAndGroups('users-and-groups-privoxy',
|
|
reserved_usernames=['privoxy'])
|
|
self.add(users_and_groups)
|
|
|
|
backup_restore = BackupRestore('backup-restore-privoxy',
|
|
**manifest.backup)
|
|
self.add(backup_restore)
|
|
|
|
def diagnose(self):
|
|
"""Run diagnostics and return the results."""
|
|
results = super().diagnose()
|
|
results.append(diagnose_url('https://www.debian.org'))
|
|
results.extend(diagnose_url_with_proxy())
|
|
return results
|
|
|
|
|
|
def setup(helper, old_version=None):
|
|
"""Install and configure the module."""
|
|
helper.call('pre', actions.superuser_run, 'privoxy', ['pre-install'])
|
|
app.setup(old_version)
|
|
helper.call('post', app.enable)
|
|
|
|
|
|
def diagnose_url_with_proxy():
|
|
"""Run a diagnostic on a URL with a proxy."""
|
|
url = 'https://debian.org/' # Gives a simple redirect to www.
|
|
|
|
results = []
|
|
for address in action_utils.get_addresses():
|
|
proxy = 'http://{host}:8118/'.format(host=address['url_address'])
|
|
env = {'https_proxy': proxy}
|
|
|
|
result = diagnose_url(url, kind=address['kind'], env=env)
|
|
result[0] = _('Access {url} with proxy {proxy} on tcp{kind}') \
|
|
.format(url=url, proxy=proxy, kind=address['kind'])
|
|
results.append(result)
|
|
|
|
return results
|