Comandi

Prima di leggere questa pagina, consulta le nozioni di base della riga di comando.

Questa pagina descrive i comandi di pluck in modo più dettagliato.

Ulteriore aiuto

L’output di pluck more-help (dalla versione v1.0.64) per comodità:

Usage:

  pluck [help|more-help]
  pluck [add|del|+|-] <rule>
  pluck export [-r][-v]

More Usage:

  pluck abort [term]            # discard pending changes that match term
  pluck bug                     # interact with bug reporting system
  pluck clear                   # clear configuration (requires 0 delay)
  pluck compact                 # maintenance command to shrink data
  pluck delay [n]               # print or set the delay
  pluck delays                  # print delay and non-standard delays
  pluck email <address|none>    # set email address for bug reports
  pluck eval [-x] <context(s)>  # show whether context would be allowed
  pluck expedite [term(s)]      # create expedite requests for recent rules
  pluck export [-r][-v]         # export configuration
  pluck factoryreset            # use factory defaults
  pluck features                # print enabled features
  pluck find [-r][-v] <term(s)> # print configuration items that match term(s)
  pluck future                  # like export, but only print the future
  pluck import <file>           # import rules from file
  pluck import-allow <file>     # add hosts to allow
  pluck import-block <file>     # add hosts to block
  pluck mety .<ext>             # show media type for extension ext
  pluck repair                  # attempt to repair Internet
  pluck refresh                 # refetch configurations from u.pluckeye.net
  pluck sync                    # immediately synchronize with u.pluckeye.net
  pluck trim                    # remove bygone rules
  pluck unimport <file>         # remove rules matching those in file
  pluck unimport-allow <file>   # remove hosts to allow
  pluck unimport-block <file>   # remove hosts to block
  pluck uninstall               # uninstall (requires 0 delay)
  pluck users                   # print names of local users
  pluck verdicts [term(s)]      # print recent allow/block verdicts
  pluck version                 # print version

  pluck [+|-] <rule1>   <+|-> <rule2>
  pluck [+|-] <rule1> , [+|-] <rule2>

Examples:

  pluck + allow ok.com
  pluck + block http://no.com/something
  pluck + allow um.com
  pluck - allow um.com
  pluck + block um.com
  pluck export

More Examples:

  pluck export                  # show the current configuration
  pluck export -r -v            # show main and imported configurations
  pluck export >file.txt        # put configuration into file.txt
  pluck eval http://a.com/p.png # would http://a.com/p.png be allowed?
  pluck eval http://a.com/ image/ # would an image on a.com be allowed?
  pluck find google             # search configuration for google
  pluck find -r -v google       # search all configurations for google
  pluck import file.txt         # import configuration from file.txt
  pluck import-allow good.txt   # allow all hosts listed in good.txt
  pluck import-block bad.txt    # block all hosts listed in bad.txt
  pluck delay 3600              # set delay to 1 hour
  pluck delay 1h                # set delay to 1 hour
  pluck delay                   # print the current delay
  pluck abort                   # abort all pending changes
  pluck abort foo               # abort pending changes that contain "foo"
  pluck mety a.txt              # print the default media type for a.txt
  pluck + system                # enable the system feature (aka level 2)
  pluck - system                # disable the system feature
  pluck + nhb                   # enable the nhb feature
  pluck + block image/          # block images
  pluck + block port 123        # block port 123
  pluck + block 1.2.3.4         # block ip address 1.2.3.4
  pluck + block youtube.com     # block youtube.com
  pluck + block facebook.com image/  # block images on facebook.com
  pluck + when 8-9 allow google.com  # allow google.com from 8-9 AM
  pluck + allow program git     # allow git
  pluck + when now+10m a.com    # allow a.com ASAP, but only for 10 minutes
  pluck + allow ok.com + block no.com # fancy
  pluck + allow ok.com , block no.com # fancy
  pluck + unadmin peter         # remove peter from sudo group
  pluck verdicts                # show verdicts from last 2 minutes
  pluck verdicts 1m             # show verdicts from last minute
  pluck verdicts block          # show recent verdicts that block

Even more examples:

  # block aa.com for the next 5 minutes
  pluck when + now+5m block aa.com
  pluck find aa.com | pluck replace allow "when now+5m block" | pluck import -
  pluck verdicts | pluck exclude :53

Features:

  blockearly                    # block more speculatively, not recommended
  nhb                           # block 'more' (usually more programs)
  nobrave                       # disallow brave-based browser
  nobrowserextensions           # block if non-required extension is installed
  nochrome                      # disallow chrome-based browsers
  nochromecast                  # disallow chrome cast
  nochromesignin                # disallow chrome sign-in
  nochromesync                  # disallow chrome sync
  nocontext                     # ignore containing page permissions
  nodevtools                    # disallow use of devtools
  nodoh                         # disallow DNS over HTTPS
  noedge                        # disallow edge browser
  noexpedite                    # disable expedite
  nofirefox                     # disallow firefox-based browsers
  nohistoryclear                # disallow clearing of history
  notor                         # prevent use of TOR in brave
  nouninstall                   # prevent uninstallation even when delay is 0
  okblockhome                   # permit blocking of u.pluckeye.net
  okincognito                   # permit incognito mode in chrome
  oksidebar                     # permit use of side search in chrome
  safe                          # use experimental "safe" browsing features
  safer                         # like safe, but more so
  system                        # integrate with the system (aka 'level 2')

Advice:

  Use a short delay while learning how to use Plucky.

  Use the 'system' feature (aka level 2), but ignore most of the rest
  of the features unless you discover a need for one of them.

  Don't import big blacklists using `pluck import`.  Instead, use
  https://u.pluckeye.net/ and create a host or ip specific blacklist
  and import it on the site.  That will keep your specific
  customizations separate from the big blacklist, and it will allow
  you to share the blacklist with other pluckers if you so choose.

  If you still need help, see https://r.pluckeye.net/help .

  Finally, as the Dread Pirate Roberts says, "Get used to disappointment."

I comandi di Plucky vengono digitati in una finestra della console e possono essere usati per controllare Plucky. Sono diversi dalle regole di Plucky.

Se sei nuovo a Plucky o stai cercando solo i comandi più usati, consulta le nozioni di base della riga di comando.

Se non hai familiarità con l’esecuzione di comandi in una console, non dovresti averne bisogno spesso, poiché la maggior parte delle azioni può essere eseguita anche facendo clic sui pulsanti nell’estensione browser di Plucky. (Se hai l’estensione browser installata, fai clic sul pulsante Plucky in alto a destra del browser per iniziare.) Se vuoi usare i comandi, consulta la Notazione per sapere esattamente come digitarli.

Per cercare questa pagina per parola chiave, usa Ctrl + F su Windows e Linux o Command + F su Mac.

add (+)

Il comando add è così comune che pluck usa il simbolo add (+) per esso.

pluck + allow example.com

In alcuni contesti, si può usare la parola add al posto di +.

pluck add allow example.com

Ecco alcuni esempi semplici:

pluck + allow example.com
pluck + allow https://example.com/page
pluck + allow program:C:\Program Files\foo.exe
pluck + block program bar.exe
pluck + allow user susan
pluck + block user edmund

Per un trattamento più approfondito di cosa può essere consentito o bloccato, consulta le regole.

remove (-)

L’opposto di add, il comando remove (o delete) viene solitamente espresso con il simbolo meno (-).

pluck - allow example.com

In alcuni contesti, si può usare l’abbreviazione del al posto di -.

pluck del allow example.com

Il tentativo di rimuovere una regola che non è nella tua configurazione non ha alcun effetto.

abort

Il comando abort permette di annullare le modifiche di configurazione in sospeso.

In tutti i seguenti esempi viene inserita una modifica a una regola, ma la regola non entra mai in vigore se hai un ritardo diverso da zero, perché la modifica viene annullata.

pluck + allow wikipedia.org
pluck abort

pluck + allow https://example.com/foo
pluck abort example.com

pluck + allow example.com image/
pluck abort image

Annulla le modifiche alle regole in sospeso (quelle che entreranno in vigore una volta trascorso il ritardo). Per impostazione predefinita, tutte le modifiche in sospeso vengono rimosse. Se viene specificato un sito web, una pagina, un programma, ecc., vengono rimosse tutte le modifiche in sospeso che corrispondono a quel contesto.

clear

Il comando clear può essere usato per cancellare la configurazione di Plucky. Questo comando ha effetto solo se il ritardo corrente è 0. Questo comando distruggerà la tua configurazione, quindi usalo con attenzione. Vedi anche: consenti tutto.

pluck clear

compact

Un comando di manutenzione per ridurre i dati.

pluck compact

delay

Il comando delay può essere usato per visualizzare o impostare il ritardo.

pluck delay
pluck delay 30

Vedi ritardo.

delays

Stampa il ritardo corrente e anche i ritardi non standard che si applicano a siti web, pagine, programmi, ecc. specifici.

pluck delays

eval

Il comando eval valuta un dato contesto di blocco nel motore delle regole di pluckeye. L’output che vedi quando esegui questo comando dipenderà dalla tua configurazione di Plucky; la configurazione predefinita produce output simili a quelli mostrati qui.

Input (cosa digiti):

pluck eval google.com

Output (cosa stampa il computer):

allow because of rule 330: allow

In questo esempio, pluck eval google.com riporta che google.com è consentito, ma ciò non significa che tutti i contenuti, come le immagini, saranno necessariamente visibili sul sito. Significa solo che dovresti essere in grado di visitare la pagina. Per determinare se le immagini saranno mostrate, aggiungi image/.

Input:

pluck eval google.com image/

Output:

block because of rule 420: block image/

Il comando eval valuta se un dato sito web, URL, programma, utente, ecc. è consentito in base alla tua configurazione corrente. Può essere usato per diagnosticare perché qualcosa viene o non viene visualizzato, ma i verdetti di sistema o i verdetti nel browser sono più autorevoli, poiché eval è una previsione di ciò che Plucky farà, non ciò che Plucky ha effettivamente fatto.

Per impostazione predefinita, il comando ha un codice di uscita pari a 0 a meno che non si verifichi un errore. Se si usa il flag -x, il comando avrà un codice di uscita pari a 0 se il risultato era allow o null, e un codice di uscita diverso da zero se era block. Se non sai cosa significa, non hai bisogno del flag -x. È utile principalmente negli script.

pluck eval -x google.com image/

expedite

Invia richieste di expedite a https://u.pluckeye.net/ per fino a 10 regole recenti in modo che qualcun altro possa approvarle. Se segue un termine a expedite, possono essere oggetto di expedite solo gli elementi che corrispondono a quel termine. Ad esempio, la seguente sequenza creerà una richiesta di expedite solo per allow ok.com.

pluck + delay 99
pluck + allow ok.com
pluck + allow hmm.com
pluck expedite ok.com

Se non seguono termini a expedite, vengono create richieste di expedite per ciascuno dei 10 elementi di configurazione aggiunti più di recente ma ancora in sospeso.

pluck expedite

Vedi expedite.

export

Il comando export stampa il contenuto della configurazione di Plucky. Può essere usato per eseguire il backup o ispezionare la tua configurazione di Plucky, sebbene sia consigliata una configurazione sincronizzata per backup più affidabili.

Il seguente esempio dovrebbe creare un file chiamato “pluckeye-configuration.txt” sul tuo desktop.

Windows

cd %HOMEPATH%\Desktop
pluck export > pluckeye-configuration.txt

Linux o macOS

cd Desktop
pluck export > pluckeye-configuration.txt

Vedi anche il comando import descritto di seguito.

factoryreset

Il comando factoryreset ripristina Plucky alle impostazioni “predefinite di fabbrica” (cioè, come se fosse appena installato). Come il comando clear, richiede un ritardo di 0 per funzionare. Anche come clear, a meno che la tua configurazione non sia sincronizzata, andrà persa. Se prevedi di riutilizzare o ripristinare la tua configurazione attuale, assicurati di eseguire export e salvarla in un file di configurazione prima di eseguire il ripristino alle impostazioni di fabbrica.

pluck factoryreset

features

Stampa le funzionalità abilitate, come system e nhb.

pluck features

find

Il comando find cerca nella tua configurazione di Plucky un elemento corrispondente. Può essere usato per cercare rapidamente la configurazione dalla riga di comando. Utilizza la corrispondenza per sottostringa anziché la corrispondenza per espressione regolare.

Input:

pluck find image/

Output:

allow image/svg+xml
block image/

La sezione timeline della pagina di configurazione dell’interfaccia browser è un altro modo per cercare nella configurazione.

future

Stampa tutte le modifiche in sospeso alla tua configurazione.

pluck future

import

Il comando import è diverso e più vecchio della direttiva import che consente di importare dinamicamente una configurazione.

Il comando import importa tutte le regole contenute in un file locale nella configurazione principale. È l’opposto del comando export. È così chiamato perché un tempo pluck export e pluck import erano i principali comandi usati per memorizzare e trasferire la configurazione di Plucky tra computer. Oggi la sincronizzazione lo fa automaticamente.

Prima di eseguire questo comando, apri il terminale nella directory (alias cartella) che contiene il file pluckeye-configuration.txt che vuoi importare.

Windows

cd %HOMEPATH%\Desktop
pluck import pluckeye-configuration.txt

Linux o macOS

cd Desktop
pluck import pluckeye-configuration.txt

import-allow

Il comando import-allow è come import, tranne per il fatto che antepone automaticamente + allow a ogni riga dell’importazione. Pertanto, può essere usato per consentire un elenco di host creato da un altro strumento.

pluck import-allow good-websites.txt

good-websites.txt potrebbe contenere:

google.com
facebook.com
https://youtube.com/watch

import-block

Il comando import-block è come import, tranne per il fatto che antepone automaticamente + block a ogni riga dell’importazione. Pertanto, può essere usato per bloccare un elenco di host creato da un altro strumento.

pluck import-block bad-websites.txt

bad-websites.txt potrebbe contenere:

bad1.com
bad2.com
1.2.3.4

mety

Il comando mety stampa il tipo di media usuale per una data estensione di file.

Input:

pluck mety .css

Output:

.css -> text/css

Questo indica che il tipo di media usuale di un file CSS è text/css.

Vedi anche i tipi di media.

refresh

Il comando refresh è simile al comando sync in quanto sincronizza la configurazione con https://u.pluckeye.net/ . È diverso in quanto può essere usato per sostituire completamente la configurazione locale che è diventata corrotta. Di solito non è necessario poiché pluck sync funziona normalmente.

pluck refresh

repair

Il comando repair tenta di ripristinare l’accesso a Internet.

pluck repair

replace

Il comando replace legge il suo input e sostituisce il primo argomento con il secondo usando la corrispondenza esatta delle stringhe. Potrebbe essere usato per eseguire un’operazione su molte regole di Plucky. Ad esempio, la seguente pipeline trova tutte le regole nella tua configurazione che contengono “example.com”, sostituisce “allow” con “when now+5m block” in tutte le regole, e poi importa queste nuove regole nella configurazione principale. Lo scopo è far sì che tutti i contenuti su example.com che erano consentiti da regole allow prima vengano bloccati per i prossimi cinque minuti.

pluck find example.com | pluck replace allow "when now+5m block" | pluck import -

sync

Il comando sync sincronizza il dispositivo con https://u.pluckeye.net/. Se non sai cosa significa, consulta la guida alla sincronizzazione.

pluck sync

trim

Il comando trim è un comando di manutenzione per ridurre i dati.

pluck trim

unimport

Il comando unimport è simile a import, tranne per il fatto che rimuove tutte le regole nel file di configurazione invece di aggiungerle.

pluck unimport pluckeye-configuration.txt

unimport-allow

Il comando unimport-allow è simile a import-allow, tranne per il fatto che rimuove le regole allow per ciascuno dei siti web, pagine, programmi, ecc. nel file invece di aggiungerle.

pluck unimport-allow websites.txt

unimport-block

Il comando unimport-block è simile a import-block, tranne per il fatto che rimuove le regole block per ciascuno dei siti web, pagine, programmi, ecc. nel file invece di aggiungerle.

pluck unimport-block websites.txt

uninstall

Il comando uninstall disinstalla Plucky. Il ritardo deve essere 0 prima di procedere.

pluck uninstall

Vedi anche come disinstallare.

upload

Il comando upload è stato sostituito dal comando sync. Vedi Sincronizzare le configurazioni per ulteriori informazioni.

verdicts

Il comando verdicts stampa i tentativi di connessione a Internet recenti e se Plucky li ha consentiti o bloccati.

pluck verdicts

Comprendere l’output

Il comando stamperà molte righe, ognuna delle quali avrà questa forma:

12:50:48.320 allow 1541 chromium google.com [2607:f8b0:400a:0806:0000:0000:0000:200e]:80 rule allow

Questa riga ci dice che alle 12:50:48 il programma chiamato chromium ha tentato di connettersi a google.com, e Plucky ha consentito questa connessione.

Queste informazioni possono essere utili quando vuoi consentire o bloccare un particolare programma.

Nota che questi sono diversi dai verdetti nel browser.

version

Stampa la versione di Plucky installata.

pluck version

unbork

Sostituito da repair.