Ardúsáid
Sábháil Cluaisíní
Má dhúnann tú cluaisíní OnionShare, scriosann tú iad, rud a chuireann cosc ar athúsáid. Tá suíomhanna gréasáin a bhíonn á n-óstáil go seasta ar fáil ar an seoladh céanna fiú má dhéantar an ríomhaire óna bhfuil siad roinnte a atosú.
Déan cluaisín ar bith go leanúnach tríd an mbosca "Oscail an cluaisín seo i gcónaí nuair a thosaíonn OnionShare" a sheiceáil sula dtosaíonn tú ar do fhreastalaí.
Agus OnionShare á oscailt, cuirfear tús le do chuid cluaisíní sábháilte ón seisiún roimhe seo a oscailt. Is féidir tús a chur le gach seirbhís de láimh ansin, agus beidh sí ar fáil ar an seoladh OnionShare céanna agus beidh sí cosanta leis an eochair phríobháideach chéanna.
Má shábhálann tú cluaisín, stóráiltear cóip dá eochair rúnda seirbhíse oinniúin ar do ríomhaire.
Múch Eochair Phríobháideach
De réir réamhshocraithe, tá gach seirbhís OnionShare cosanta le eochair phríobháideach, a dtugann Tor "fíordheimhniú cliant" air.
Iarrfaidh Brabhsálaí Tor ort d’eochair phríobháideach a chur isteach nuair a lódálann tú seirbhís OnionShare. Más mian leat ligean don phobal do sheirbhís a úsáid, is fearr an eochair phríobháideach a dhíchumasú ar fad.
Chun an eochair phríobháideach le haghaidh aon chluaisín a mhúchadh, seiceáil an bosca "Seirbhís OnionShare poiblí é seo (díchumasaigh eochair phríobháideach)" sula dtosaíonn tú ar an bhfreastalaí. Ansin beidh an freastalaí poiblí agus ní gá eochair phríobháideach chun é a lódáil sa Bhrabhsálaí Tor.
Teidil Chustaim
Nuair a lódálann daoine seirbhísí OnionShare sa Bhrabhsálaí Tor feiceann siad an teideal réamhshocraithe do gach cineál seirbhíse. Mar shampla, is é an teideal réamhshocraithe le haghaidh seirbhísí comhrá ná "OnionShare Chat".
Má chuireann tú an socrú "Teideal an Chustaim" in eagar sula dtosaíonn tú ar fhreastalaí is féidir leat é a athrú.
Amanna Sceidealta
Tacaíonn OnionShare le sceidealú go díreach nuair ba cheart seirbhís a thosú agus a stopadh. Sula dtosaíonn tú ar fhreastalaí, cliceáil "Taispeáin socruithe casta" ina chluaisín agus ansin seiceáil na boscaí in aice le ceachtar "Tosaigh seirbhís oinniún ag am sceidealta", "Stop seirbhís oinniún ag am sceidealta", nó iad araon, agus socraigh na dátaí inmhianaithe faoi seach agus amanna.
Taispeánann seirbhísí atá sceidealaithe le tosú amach anseo lasc ama comhaireamh síos nuair a chliceáiltear an cnaipe “Tosaigh ag roinnt”. Taispeánann seirbhísí atá sceidealaithe le stopadh sa todhchaí lasc ama comhaireamh síos nuair a chuirtear tús leo.
Is féidir seirbhís OnionShare a sceidealú le tosú go huathoibríoch a úsáid mar lasc fear marbh. Ciallaíonn sé seo go ndéanfar do sheirbhís a phoibliú ag am ar leith amach anseo mura bhfuil tú ann chun é a chosc. Mura dtarlaíonn rud ar bith duit, is féidir leat an tseirbhís a chur ar ceal sula mbeidh sé sceidealaithe le tosú.
Cuireann sceidealú seirbhís OnionShare teorainn lena nochtadh. Más mian leat faisnéis rúnda nó rud éigin a bheidh as dáta a roinnt, is féidir leat é sin a dhéanamh ar feadh tréimhse teoranta roghnaithe.
Comhéadan líne ordaithe
Chomh maith lena chomhéadan grafach, tá comhéadan ordú-líne ag OnionShare.
Suiteáil an leagan CLI
Má tá an pacáiste Snap, macOS nó Windows suiteáilte agat, tá an leagan CLI suiteáilte agat cheana féin.
Nó, is féidir leat an leagan ordú-líne de OnionShare a shuiteáil ag baint úsáide as `` pip3``
pip3 install --user onionshare-cli
Tabhair faoi deara go mbeidh an pacáiste `` tor`` suiteáilte uait freisin. I macOS, é a shuiteáil le: `` brew install tor``
Ansin rith sé mar seo:
onionshare-cli --help
Tá eolas faoina shuiteáil ar chórais oibriúcháin éagsúla le fáil sa chomhad CLI README sa stór Git.
Rith an CLI ó Snap
Má shuiteáil tú OnionShare ag baint úsáide as an bpacáiste Snap, is féidir leat onionshare.cli a rith chun rochtain a fháil ar an leagan comhéadan ordú-líne.
CLI a rith ó macOS
Ón Teirminéal, is féidir leat / Applications/OnionShare.app/Contents/MacOS/onionshare-cli --help a rith
CLI a rith ó Windows
I suiteáil Windows, tá an inrite `` onionshare-cli.exe`` ar fáil.
Úsáid
Brabhsáil doiciméadú na líne ordaithe trí onionshare --help a rith:
$ onionshare-cli --help
╭───────────────────────────────────────────╮
│ * ▄▄█████▄▄ * │
│ ▄████▀▀▀████▄ * │
│ ▀▀█▀ ▀██▄ │
│ * ▄█▄ ▀██▄ │
│ ▄█████▄ ███ -+- │
│ ███ ▀█████▀ │
│ ▀██▄ ▀█▀ │
│ * ▀██▄ ▄█▄▄ * │
│ * ▀████▄▄▄████▀ │
│ ▀▀█████▀▀ │
│ -+- * │
│ ▄▀▄ ▄▀▀ █ │
│ █ █ ▀ ▀▄ █ │
│ █ █ █▀▄ █ ▄▀▄ █▀▄ ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄ │
│ ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █ ▀▄▄ │
│ │
│ v2.4.1 │
│ │
│ 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] [--log-filenames] [--qr] [--data-dir data_dir] [--webhook-url webhook_url] [--disable-text]
[--disable-files] [--disable_csp] [--custom_csp custom_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 scheduled time (N seconds from now)
--no-autostop-sharing Share files: Continue sharing after files have been sent (the default is to stop sharing)
--log-filenames Log file download activity to stdout
--qr Display a QR code in the terminal for share links
--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 the default Content Security Policy header (allows your website to use third-party resources)
--custom_csp custom_csp Publish website: Set a custom Content Security Policy header
-v, --verbose Log OnionShare errors to stdout, and web errors to disk
An CLI a rith mar chomhad aonaid systemd
Is féidir OnionShare a thosú go huathoibríoch ón CLI ag baint úsáide as comhad aonaid systemd.
B’fhéidir go mbeidh sé seo an-úsáideach duit má tá tú ag feidhmiú i mód ‘leanúnach’, agus más mian leat an tseirbhís oinniúin chéanna a thosú gach uair a thosaíonn do mheaisín.
Chun seo a dhéanamh, ní mór duit roinnt config OnionShare json a ullmhú ar dtús.
Seo é an príomh-chumraíocht OnionShare. Sa sampla seo, tá sé stóráilte i /home/user/.config/onionshare/onionshare.json. Seans go mbeidh ort cuid de na socruithe a choigeartú, ach má tá OnionShare suiteáilte agat cheana féin, is dócha go bhfuil cuma mhaith air seo cheana féin:
{
"version": "2.6.2",
"connection_type": "bundled",
"control_port_address": "127.0.0.1",
"control_port_port": 9051,
"socks_address": "127.0.0.1",
"socks_port": 9050,
"socket_file_path": "/var/run/tor/control",
"auth_type": "no_auth",
"auth_password": "",
"auto_connect": true,
"use_autoupdate": true,
"autoupdate_timestamp": null,
"bridges_enabled": false,
"bridges_type": "built-in",
"bridges_builtin_pt": "obfs4",
"bridges_moat": "",
"bridges_custom": "",
"bridges_builtin": {},
"persistent_tabs": [
"my-persistent-onion"
],
"locale": "en",
"theme": 0
}
Tabhair faoi deara an rannán 'persistent_tabs'. Cruthóimid comhad anois ag /home/user/.config/onionshare/persistent/my-persistent-onion.json, a bhreathnaíonn mar seo:
{
"onion": {
"private_key": "UDIaZD8QgoXRP8JnAJ+pnlogQazfZ0wrfWJk5zPBGUBqg6+lozzjUJKTYWxwrxR33pDgJdTFtCUN1CX1FE22UQ==",
"client_auth_priv_key": "RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ",
"client_auth_pub_key": "J4YLYAHS25UU3TZTE27H32RN3MCRGLR345U52XS2JNQ76CCHCRSQ"
},
"persistent": {
"mode": "share",
"enabled": true
},
"general": {
"title": null,
"public": false,
"autostart_timer": 0,
"autostop_timer": 0,
"service_id": "niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid",
"qr": false
},
"share": {
"autostop_sharing": true,
"filenames": [
"/home/user/my-shared-file.txt"
]
},
"receive": {
"data_dir": "/home/user/OnionShare",
"webhook_url": null,
"disable_text": false,
"disable_files": false
},
"website": {
"disable_csp": false,
"custom_csp": null,
"filenames": []
},
"chat": {}
}
Ná húsáid an eochair phríobháideach seo, na heochracha service_id nó client_auth! Léirítear iad mar shampla amháin. Ná roinn an eochair_phríobháideach le haon duine.
Is é an bealach is éasca chun an seoladh oinniún agus an eochair phríobháideach a ghiniúint ná cluaisín OnionShare 'pinned' a chruthú ar dtús san app deisce agus thosaigh sé ar an sciar den chéad uair. Ansin sábhálfaidh sé seo na socruithe leanúnacha chuig d'fhillteán .config/onionshare/persistent/ le hainm randamach air. Is féidir leat an cluaisín sin a dhíphionnáil nuair a bheidh sé ginte agat den chéad uair. Nó, is féidir leat é a fhágáil san áit a bhfuil sé, agus an comhad leanúnach sin a úsáid i do chomhad aonaid systemd thíos.
Anois is féidir leat comhad aonaid systemd a chruthú i /etc/systemd/system/onionshare-cli.service. Bí cinnte an tÚsáideoir agus an Grúpa a choigeartú do d’úsáideoir/grúpa féin, chomh maith le hathruithe ar aon chosáin chuig an dénártha onionshare-cli nó na cosáin chuig do chumraíochtaí agus scaireanna JSON.
Ba cheart go mbeadh cuma mar seo ar an gcomhad aonaid systemd:
[Unit]
Description=OnionShare CLI
After=network.target
[Service]
ExecStart=/home/user/.local/bin/onionshare-cli --persistent /home/user/.config/onionshare/persistent/my-persistent-onion.json /home/user/my-shared-file.txt
Restart=on-failure
User=user
Group=user
[Install]
WantedBy=multi-user.target
Tabhair faoi deara, cé go raibh /home/user/my-shared-file.txt sainmhínithe sa chuid filenames den chomhad my-persistent-onion.json, tá sé fós riachtanach é a shonrú mar argóint don ordú onionshare-cli.
Bí cinnte `` sudo systemctl daemon-reload`` a rith tar éis duit an comhad aonaid a chruthú.
Anois is féidir leat `` sudo systemctl start onionshare-cli.service`` a rith. Má tá journalctl suiteáilte agat, is féidir leat sudo journalctl -f -t onionshare-cli a rith, agus ba cheart go bhfeicfeá roinnt aschur de do sheirbhís ag tosú:
[...]
Feb 09 10:14:09 onionshare onionshare-cli[18852]: [6.5K blob data]
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Compressing files.
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Give this address and private key to the recipient:
Feb 09 10:14:18 onionshare onionshare-cli[18852]: http://niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid.onion
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Private key: RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ
Feb 09 10:14:18 onionshare onionshare-cli[18852]: Press Ctrl+C to stop the server
Mura dteastaíonn uait go n-úsáidfidh d’úsáideoirí Eochair Phríobháideach, socraigh public le bheith `` fíor`` sna socruithe ginearálta sa chomhad my-persistent-onion.json.
Aicearraí méarchláir
Tá roinnt aicearraí méarchláir san fheidhmchlár deisce OnionShare, ar mhaithe le háisiúlacht agus inrochtaineacht:
Ctrl T - New Tab
Ctrl X - Closes current tab
Agus ón scáileán roghnóir príomh-mhód:
Ctrl S - Share mode
Ctrl R - Receive mode
Ctrl W - Website mode
Ctrl C - Chat mode
Ctrl H - Settings tab
Paraiméadair comhad cumra
Stórálann OnionShare a shocruithe i gcomhad JSON. Úsáideann na leaganacha CLI agus na Deisce araon an comhad cumraíochta seo. Ligeann an CLI duit cosán a shonrú chuig comhad cumraíochta saincheaptha le --config.
Seo thíos na paraiméadair chomhaid cumraíochta agus cad a chiallaíonn siad. Má tá paraiméadair eile nach bhfuil liostaithe anseo ag do chomhad cumraíochta, d'fhéadfadh go mbeadh siad as feidhm ó leaganacha níos sine OnionShare.
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
leagan |
|
An leagan de OnionShare. Níor cheart go gcaithfidh tú an luach seo a athrú riamh. |
cineál_nasc |
|
An bealach a nascann OnionShare le Tor. Is iad na roghanna bailí 'cuinneall', 'uathoibríoch' (bain úsáid as nasc Tor Brabhsálaí Tor), 'control_port' nó 'socket_file'. Réamhshocraithe: 'cuinneáilte' |
seoladh rialaithe_port |
|
Seoladh IP calafort Rialaithe Tor, má tá |
calafort rialaitheoireachta |
|
Uimhir chalafort calafort Rialaithe Tor, má tá |
seoladh stocks_ |
|
Seoladh IP seachfhreastalaí SOCKS Tor, má tá |
calafort soicíní |
|
Uimhir chalafoirt seachfhreastalaí SOCKS Tor, má tá |
soicet_file_path |
|
An cosán chuig comhad soicéad Tor, má tá |
|
Má theastaíonn pasfhocal ó rochtain ar chalafort rialaithe Tor, is féidir é seo a shocrú go 'pasfhocal', ar shlí eile 'no_auth'. Réamhshocraithe: 'no_auth' |
|
auth_password |
|
Má theastaíonn pasfhocal ó rochtain ar chalafort rialaithe Tor, agus má tá |
uath_nasc |
|
Cibé an chóir OnionShare ceangal go huathoibríoch le Tor nuair a thosaíonn sé Réamhshocrú: Bréagach |
úsáid uathoibríoch |
|
Cibé an cheart OnionShare seiceáil go huathoibríoch le haghaidh nuashonruithe (thar Tor Níl an socrú seo bailí ach le haghaidh suiteálacha macOS nó Windows. Réamhshocraithe: Fíor. |
uath_nuashonrú_stampa_ama |
|
An uair dheireanach a sheiceáil OnionShare le haghaidh nuashonruithe. Réamhshocraithe: Níl aon |
bridges_cumasaithe |
|
Cibé acu ceangail le Tor ag baint úsáide as droichid. Réamhshocrú: Bréagach |
cineál_droidí |
|
Nuair a bhíonn |
droidge_buntin_pt |
|
Nuair a shocraítear |
droidges_moat |
|
Nuair a shocraítear |
bridges_saincheaptha |
|
Nuair a shocraítear |
droichid_builtin |
|
Nuair a bheidh |
cluaisíní leanúnacha |
|
Má shainmhíníonn an t-úsáideoir aon chluaisíní mar 'sábháilte' (rud a chiallaíonn go bhfuil siad leanúnach gach uair a thosaíonn OnionShare, agus ní athraíonn a seoladh oinniún), tugtar aitheantóir randamach dóibh seo a liostaítear anseo. Stóráiltear an oinniún leanúnach mar chomhad JSON leis an ainm céanna leis an aitheantóir seo, i bhfofhillteán den fhillteán cumraíochta OnionShare ar a dtugtar 'leanún'. Réamhshocraithe: [] |
áitiúil |
|
An áitiúil a úsáidtear in OnionShare. Réamhshocraithe: Níl aon (atá mar an gcéanna le 'en'). Le haghaidh cóid bailí áitiúla, féach 'available_locales' i https://github.com/onionshare/onionshare/blob/main/cli/onionshare_cli/settings.py |
téama |
|
An téama don aip deisce OnionShare. Is iad na roghanna bailí ná 0 (téama éadrom nó dorcha ríomhaire an úsáideora a bhrath go huathoibríoch), 1 (solas) nó 2 (dorcha). |
Paraiméadair comhad cumraíochta do oinniúin
Mar a thuairiscítear thuas, tá paraiméadair dá chuid féin ag gach oinniún 'leanúnach' a stóráiltear ina chomhad JSON féin. Is féidir an cosán chuig an gcomhad seo a shonrú don uirlis CLI le --persistent.
Seo sampla cumraíocht leanúnach JSON:
{
"onion": {
"private_key": "0HGxILDDwYhxAB2Zq8mM3Wu3MirBgK7Fw2/tVrTw1XraElH7MWbVn3lzKbcJEapVWz2TFjaoCAVN48hGqraiRg==",
"client_auth_priv_key": "UT55HDBA5VSRWOUERMGOHEIBKZCMOOGZAFFNI54GDQFZ6CMCUGIQ",
"client_auth_pub_key": "TPQCMCV26UEDMCWGZCWAWM4FOJSQKZZTVPC5TC3CAGMDWKV255OA"
},
"persistent": {
"mode": "share",
"enabled": true,
"autostart_on_launch": false
},
"general": {
"title": null,
"public": false,
"autostart_timer": false,
"autostop_timer": false,
"service_id": "hvsufvk2anyadehahfqiacy4wbrjt2atpnagk4itlkh4mdfsg6vhd5ad"
},
"share": {
"autostop_sharing": true,
"filenames": [
"/home/user/git/onionshare/desktop/org.onionshare.OnionShare.svg"
],
"log_filenames": false
},
"receive": {
"data_dir": "/home/user/OnionShare",
"webhook_url": null,
"disable_text": false,
"disable_files": false
},
"website": {
"disable_csp": false,
"custom_csp": null,
"log_filenames": false,
"filenames": []
},
"chat": {}
}
Seo thíos na paraiméadair chomhaid cumraíochta le haghaidh oinniún leanúnach agus cad a chiallaíonn siad, do gach cuid sa JSON
oinniún
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
eochair_príobháideach |
|
Eochair phríobháideach ionchódaithe Base64 den tseirbhís |
cliant_auth_priv_key |
|
An eochair príobháideach agus Fíordheimhniú Cliant á úsáid Seol é seo chuig an úsáideoir. |
cliant_auth_pub_key |
|
An eochair phoiblí agus Fíordheimhniú Cliant á úsáid. Úsáidtear ar thaobh OnionShare. |
leanúnach
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
mód |
|
An modh a úsáideann an oinniún leanúnach seo. Is iad na roghanna “comhroinnt”, “faigh”, “suíomh Gréasáin” nó “comhrá”. |
cumasaithe |
|
Cibé an bhfuil marthanacht cumasaithe don oinniún seo. Nuair a dhéantar an rogha leanúnach a sheiceáil ar an deasc, scriostar an comhad JSON iomlán seo. Réamhshocraithe: fíor |
tús_uathoibríoch_ar_lainseáil |
|
Cibé an gcuirfear tús leis an oinniún leanúnach seo go huathoibríoch nuair a thosaíonn OnionShare agus nuair a Réamhshocraithe: bréagach |
ginearálta
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
teideal |
|
Teideal saincheaptha roghnach le taispeáint ar an tseirbhís oinniún. Réamhshocraithe: null (taispeánfar “OnionShare” ina ionad) |
poiblí |
|
Cibé an féidir rochtain a fháil ar an tseirbhís oinniún le nó gan Eochair Phríobháideach (Fíordheimhniú Cliant). Más fíor, níl aon Eochair Príobháideach ag teastáil. |
autostart_timer |
|
Cibé an bhfuil an tseirbhís oinniún cumraithe chun tosú ag am ar leith. Is féidir an t-am a shocrú san aip deisce nó a shonrú i soicindí le |
uathstad_uaineadóir |
|
Cibé an bhfuil an tseirbhís oinniún cumraithe chun stopadh ag am ar leith. Is féidir an t-am a shocrú san aip deisce nó a shonrú i soicindí le |
service_id |
|
URL seirbhíse oinniúin 32 carachtar, gan an scéim agus gan an iarmhír '.onion'. |
Is iad seo thíos socruithe atá sonrach don 'modh' a shonraítear sa chuid leanún thuas.
glacadh
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
data_dir |
|
Stórálfar an cosán ina bhfuarthas comhaid nó teachtaireachtaí téacs. Réamhshocraithe: an fillteán 'OnionShare' d'eolaire baile an úsáideora. |
cuaille_gréasáin_url |
|
URL webhook a chuirfidh OnionShare POST air nuair a fhaigheann sé comhaid nó teachtaireachtaí téacs. Réamhshocraithe: null |
téacs_míchumasaithe |
|
Cibé acu teachtaireachtaí téacs a fháil a dhíchumasú Réamhshocraithe: bréagach |
comhaid neamhdhíchumasaithe |
|
Cibé acu comhaid glacadh a dhíchumasú. Réamhshocraithe: bréagach |
láithreán gréasáin
Paraiméadar |
Cineál |
Míniú |
|---|---|---|
disable_csp |
|
Má tá sé socraithe ar |
saincheaptha_csp |
|
Ceanntásc saincheaptha Polasaí Slándála Ábhar le seoladh in ionad an réamhshocrai. |
log_file names |
|
Cibé acu iarratais URL a logáil chuig stdout agus an uirlis CLI á úsáid agat. Réamhshocraithe: bréagach |
ainmneacha comhaid |
|
Liosta de na comhaid le roinnt. Réamhshocraithe: [] |
comhrá
Faoi láthair níl aon socruithe inchumraithe don mhodh Comhrá.