Kehittynyt käyttö¶
Tallenna välilehdet¶
Kaikki OnionSharessa on tilapäistä oletusarvoisesti. Jos suljet OnionShare-välilehden, sen osoite ei enää ole olemassa ja sitä ei voida ladata uudelleen. Joskus saatat haluta OnionShare-palvelun olevan pysyvä. Tämä on hyödyllistä, jos haluat isännöidä verkkosivua, joka on saatavilla samasta OnionShare-osoitteesta, vaikka uudelleenkäynnistäisit tietokoneesi.
Tehdäksesi välilehdestä pysyvän, valitse ”Tallenna tämä välilehti, ja automaattisesti avaa se, kun avaan OnionSharen” -ruutu ennen palvelimen käynnistämistä. Kun välilehti on tallennettu violetti nastan kuva ilmaantuu sen palvelimen vasempaan reunaan.
When you quit OnionShare and then open it again, your saved tabs will start opened. You’ll have to manually start each service, but when you do they will start with the same OnionShare address and private key.
Jos tallennat välilehden, kopio kyseisen välilehden sipulipalvelun salaisesta avaimesta talletetaan tietokoneellesi OnionShare-asetusten mukana.
Turn Off Private Key¶
By default, all OnionShare services are protected with a private key, which Tor calls ”client authentication”.
When browsing to an OnionShare service in Tor Browser, Tor Browser will prompt for the private key to be entered.
Sometimes you might want your OnionShare service to be accessible to the public, like if you want to set up an OnionShare receive service so the public can securely and anonymously send you files. In this case, it’s better to disable the private key altogether.
To turn off the private key for any tab, check the ”This is a public OnionShare service (disables private key)” box before starting the server. Then the server will be public and won’t need a private key to view in Tor Browser.
Muokatut otsikot¶
Oletuksena, kun ihmiset lataavat OnionShare-palvelun Tor-selaimessaan he näkevät oletuksena kyseisen palvelun nimen. Esimerkiksi, oletusotsikko keskustelupalvelulle on ”OnionShare Chat”.
Jos haluat valita muokatun otsikon, valitse ”Muokattu otsikko” -asetus ennen palvelimen käynnistämistä.
Ajastetut hetket¶
OnionShare tukee ajastusta juuri silloin, kun palvelun tulee käynnistyä tai pysähtyä. Ennen palvelimen käynnistämistä, klikkaa ”Näytä lisäasetukset” välilehdestä ja sen jälkeen valitse joko ”Aloita sipulipalvelu ajastettuna hetkenä”, ”Pysäytä sipulipalvelu ajastettuna hetkenä”, tai molemmat, ja aseta haluamasi päivämäärät ja kellonajat.
Jos ajastit palvelun alkamaan tulevaisuudessa, klikkaamalla ”Aloita jakaminen”-nappia näet laskurin, joka ilmaisee lähestyvää alkamisaikaa. Jos ajastit sen pysähtymään tulevaisuudessa, palvelun ollessa päällä näet laskurin, joka ilmaisee lähestyvää lopetusaikaa.
OnionShare-palvelun automaattista ajastusta voi käyttää ”kuolleen miehen vipuna”, eli palvelusi tulee julkiseksi tulevaisuudessa, jos jotain tapahtuisi sinulle. Jos mitään ei tapahdu, voit peruuttaa palvelun ennen kuin ajastettu hetki koittaa.
Scheduling an OnionShare service to automatically stop can be useful to limit exposure, like if you want to share secret documents while making sure they’re not available on the internet for more than a few days.
Komentokehotekäyttöliittymä¶
Graafisen käyttöliittymän lisäksi OnionSharessa on komentokehotekäyttöliittymä.
Voit asentaa pelkästään komentokehoteversion OnionSharesta käyttämällä pip3:
pip3 install --user onionshare-cli
Huomioi, että sinulla tulee olla tor-paketti asennettuna. MacOS:ssa asenna se näin: brew install tor
Sen jälkeen aja se näin:
onionshare-cli --help
For information about installing it on different operating systems, see the CLI readme file in the git repository.
Jos olet asentanut OnionSharen käyttämällä Linuxin Snapcraft-pakettia, voit myös ajaa``onionshare.cli`` päästäksesi komentokehotekäyttöliittymään.
Käyttö¶
Voit selata komentokehotteen dokumentaatiota ajamalla komennon onionshare --help:
$ onionshare-cli --help
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4 │
│ │
│ https://onionshare.org/ │
╰───────────────────────────────────────────╯
usage: onionshare-cli [-h] [--receive] [--website] [--chat] [--local-only] [--connect-timeout SECONDS] [--config FILENAME] [--persistent FILENAME] [--title TITLE] [--public]
[--auto-start-timer SECONDS] [--auto-stop-timer SECONDS] [--no-autostop-sharing] [--data-dir data_dir] [--webhook-url webhook_url] [--disable-text] [--disable-files]
[--disable_csp] [-v]
[filename ...]
positional arguments:
filename List of files or folders to share
optional arguments:
-h, --help show this help message and exit
--receive Receive files
--website Publish website
--chat Start chat server
--local-only Don't use Tor (only for development)
--connect-timeout SECONDS
Give up connecting to Tor after a given amount of seconds (default: 120)
--config FILENAME Filename of custom global settings
--persistent FILENAME Filename of persistent session
--title TITLE Set a title
--public Don't use a private key
--auto-start-timer SECONDS
Start onion service at scheduled time (N seconds from now)
--auto-stop-timer SECONDS
Stop onion service at schedule time (N seconds from now)
--no-autostop-sharing Share files: Continue sharing after files have been sent (default is to stop sharing)
--data-dir data_dir Receive files: Save files received to this directory
--webhook-url webhook_url
Receive files: URL to receive webhook notifications
--disable-text Receive files: Disable receiving text messages
--disable-files Receive files: Disable receiving files
--disable_csp Publish website: Disable Content Security Policy header (allows your website to use third-party resources)
-v, --verbose Log OnionShare errors to stdout, and web errors to disk