Gelişmiş kullanım
Sekmeleri kaydedin
Barındırdığınız OnionShare sekmelerini kapatmak onları yok ederek yeniden kullanılmalarını engeller. Kalıcı olarak barındırılan web siteleri, paylaşıldıkları bilgisayar yeniden başlatılsa bile aynı adreste kullanılabilir.
Sunucunuzu başlatmadan önce “OnionShare başlatıldığında her zaman bu sekmeyi aç” kutusunu işaretleyerek herhangi bir sekmeyi kalıcı hale getirin.
OnionShare açıldığında, önceki oturumdaki kayıtlı sekmeleriniz açılmaya başlayacaktır. Her hizmet daha sonra elle başlatılabilir ve aynı OnionShare adresinde kullanılabilir ve aynı kişisel anahtar tarafından korunur olacaktır.
Bir sekmeyi kaydederseniz, onion hizmeti kişisel anahtarının bir kopyası bilgisayarınızda saklanır.
Kişisel anahtarı kapat
Varsayılan olarak, tüm OnionShare hizmetleri, Tor tarafından “istemci kimlik doğrulaması” olarak adlandırılan kişisel bir anahtarla korunur.
Bir OnionShare hizmetini yüklediğinizde Tor Browser sizden kişisel anahtarınızı girmenizi isteyecektir. Herkesin hizmetinizi kullanmasına izin vermek istiyorsanız, kişisel anahtarı tamamen devre dışı bırakmanız daha iyi olur.
Herhangi bir sekmenin kişisel anahtarını kapatmak için sunucuyu başlatmadan önce “Bu, herkese açık bir OnionShare hizmetidir (kişisel anahtarı devre dışı bırakır)” kutusunu işaretleyin. Böylece sunucu herkese açık olur ve Tor Browser’da yüklemek için kişisel anahtara gerek kalmaz.
Özel başlıklar
Kullanıcılar Tor Browser’da OnionShare hizmetlerini yüklediklerinde her bir hizmet türü için öntanımlı başlığı görürler. Örneğin, sohbet hizmetleri için öntanımlı başlık “OnionShare Chat” şeklindedir.
Bir sunucuyu başlatmadan önce “Özel başlık” ayarını düzenlerseniz, bunu değiştirebilirsiniz.
Zamanlamalar
OnionShare, bir hizmetin tam olarak başlayacağı ve duracağı zamanları ayarlayabilir. Bir sunucuyu başlatmadan önce, sekmesindeki “Gelişmiş ayarları görüntüle” düğmesine tıklayın ve ardından “Onion hizmeti şu zamanda başlatılsın”, “Onion hizmeti şu zamanda durdurulsun” seçeneklerini kullanarak istediğiniz tarih ve saatleri ayarlayın.
Gelecekte başlaması zamanlanan hizmetler, “Paylaşımı başlat” düğmesine tıklandığında bir geri sayım sayacı görüntüler. Gelecekte durması zamanlanan hizmetler, başlatıldığında bir geri sayım sayacı görüntüler.
Bir OnionShare hizmetini otomatik olarak başlatmak için zamanlamak, ölü adam anahtarı olarak kullanılabilir. Bu, hizmetinizin gelecekte belirli bir zamanda, bunu önlemek için orada değilseniz, herkese açık hale getirileceği anlamına gelir. Başınıza bir şey gelmezse, hizmeti başlayacağı zamandan önce iptal edebilirsiniz.
Bir OnionShare hizmetini otomatik olarak durdurmak için zamanlamak, maruz kalmayı sınırlar. Gizli bilgileri veya güncelliğini yitirecek bir şeyi paylaşmak istiyorsanız, bunu seçilen sınırlı bir süre için yapabilirsiniz.
Komut satırı arayüzü
Görsel arayüze ek olarak, OnionShare bir komut satırı arayüzüne sahiptir.
CLI sürümü kurulumu
Snap, macOS veya Windows paketini kurduysanız, CLI sürümü zaten kuruludur.
OnionShare uygulamasının yalnız komut satırı sürümünü pip3 kullanarak kurabilirsiniz:
pip3 install --user onionshare-cli
Ayrıca tor paketinin kurulu olması gerekeceğini unutmayın. macOS için şu komutla kurun: brew install tor
Sonra şu şekilde çalıştırın:
onionshare-cli --help
Farklı işletim sistemlerine kurmak hakkında bilgi Git deposundaki CLI README dosyasında bulunabilir.
Snap paketinden CLI çalıştırma
OnionShare’i Snap paketini kullanarak kurduysanız, komut satırı arayüzü sürümüne erişmek için onionshare.cli komutunu çalıştırabilirsiniz.
macOS için CLI çalıştırma
Uçbirimden, /Applications/OnionShare.app/Contents/MacOS/onionshare-cli --help komutunu çalıştırabilirsiniz
Windows için CLI çalıştırma
Windows kurulumunda, onionshare-cli.exe program dosyası kullanılabilir.
Kullanım
onionshare --help komutunu çalıştırarak komut satırı belgelerine göz atın:
$ 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
systemd birim dosyası olarak CLI çalıştırma
Bir systemd birim dosyası kullanarak CLI’dan OnionShare otomatik olarak başlatılabilir.
Bu, ‘kalıcı’ kipte çalışıyorsanız ve makineniz her başlatıldığında aynı onion hizmetini başlatmak istiyorsanız kullanışlı olabilir.
Bunu yapmak için önce OnionShare json yapılandırmasını hazırlamanız gerekir.
Burada OnionShare ana yapılandırması bulunmaktadır. Bu örnekte, /home/user/.config/onionshare/onionshare.json konumunda saklanmaktadır. Bazı ayarları değiştirmeniz gerekebilir, ancak OnionShare zaten kuruluysa buna çok benziyor olacaktır:
{
"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
}
‘persistent_tabs’ bölümüne dikkat edin. Şimdi /home/user/.config/onionshare/persistent/my-persistent-onion.json konumunda şu şekilde bir dosya oluşturacağız:
{
"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": {}
}
Bu özel anahtarı, service_id veya client_auth anahtarlarını gerçekten kullanmayın! Bunlar yalnızca örnek olarak gösterilmiştir. Özel anahtarı asla kimseyle paylaşmayın.
Onion adresini ve özel anahtarı oluşturmanın en kolay yolu, önce masaüstü uygulamasında ‘sabitlenen’ bir OnionShare sekmesi oluşturmak ve paylaşımı ilk kez başlatmaktır. Bu, kalıcı ayarları rastgele bir adla .config/onionshare/persistent/ klasörüne kaydedecektir. İlk kez oluşturduktan sonra bu sekmenin sabitlenmesini kaldırabilirsiniz. Ya da olduğu gibi bırakabilir ve aşağıdaki systemd birim dosyanızda bu kalıcı dosyayı kullanabilirsiniz.
Artık /etc/systemd/system/onionshare-cli.service içinde bir systemd birim dosyası oluşturabilirsiniz. User ve Group kısmını kendi kullanıcı/grubunuza göre ayarladığınızdan ve ayrıca onionshare-cli dosyasının yolunu veya JSON yapılandırma ve paylaşımlarınızın yollarını değiştirdiğinizden emin olun.
systemd birim dosyası şu şekilde olmalıdır:
[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
/home/user/my-shared-file.txt dosyası my-persistent-onion.json dosyasının filenames bölümünde tanımlanmış olsa da, onionshare-cli komutuna argüman olarak belirtilmesi gerektiğini unutmayın.
Birim dosyasını oluşturduktan sonra sudo systemctl daemon-reload komutunu çalıştırmayı unutmayın.
Artık sudo systemctl start onionshare-cli.service komutunu çalıştırabilirsiniz. journalctl kuruluysa, sudo journalctl -f -t onionshare-cli komutunu çalıştırabilirsiniz ve hizmetinizin başlatıldığına dair bazı çıktılar göreceksiniz:
[...]
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
Kullanıcılarınızın Özel Anahtar kullanmasını istemiyorsanız, my-persistent-onion.json dosyasının general ayarlarında public değerini true olarak ayarlayın.
Klavye Kısayolları
OnionShare masaüstü uygulaması, kolaylık ve erişilebilirlik için bazı klavye kısayolları içerir:
Ctrl T - New Tab
Ctrl X - Closes current tab
Ve ana mod seçici ekranından:
Ctrl S - Share mode
Ctrl R - Receive mode
Ctrl W - Website mode
Ctrl C - Chat mode
Ctrl H - Settings tab
Yapılandırma dosyası parametreleri
OnionShare ayarlarını bir JSON dosyasında saklar. Hem CLI hem de Masaüstü sürümleri bu yapılandırma dosyasını kullanır. CLI ayrıca --config seçeneği ile özel bir yapılandırma dosyasının yolunu belirtmenize olanak tanır.
Aşağıda yapılandırma dosyası parametreleri ve anlamları yer almaktadır. Yapılandırma dosyanızda burada listelenmeyen başka parametreler varsa, bunlar eski OnionShare sürümlerinden kalma eski parametreler olabilir.
Parametre |
Türü |
Açıklaması |
|---|---|---|
version |
|
OnionShare sürümü. Bu değeri asla değiştirmenize gerek yoktur. |
connection_type |
|
OnionShare’in Tor ağına bağlanma şekli. Geçerli seçenekler ‘bundled’, ‘automatic’ (Tor Browser’ın Tor bağlantısını kullan), ‘control_port’ veya ‘socket_file’ değerleridir. Öntanımlı: ‘bundled’ |
control_port_address |
|
|
control_port_port |
|
|
socks_address |
|
|
socks_port |
|
|
socket_file_path |
|
|
auth_type |
|
Tor denetim bağlantı noktasına erişim için parola gerekiyorsa, bu ‘password’ olarak ayarlanabilir, aksi takdirde ‘no_auth’ olarak ayarlanabilir. Öntanımlı: ‘no_auth’ |
auth_password |
|
Tor denetim bağlantı noktasına erişim için parola gerekiyorsa ve |
auto_connect |
|
OnionShare başlatıldığında Tor ağına otomatik bağlanıp bağlanmayacağı. Öntanımlı: False |
use_autoupdate |
|
OnionShare’in güncellemeleri (Tor üzerinden) otomatik olarak denetleyip denetlemeyeceği. Bu ayar yalnızca MacOS veya Windows kurulumları için geçerlidir. Öntanımlı: True. |
autoupdate_timestamp |
|
OnionShare’in en son ne zaman güncelleme denetimi yaptığı. Öntanımlı: Boş |
bridges_enabled |
|
Tor ağına köprüler kullanılarak bağlanıp bağlanılmayacağı. Öntanımlı: False |
bridges_type |
|
|
bridges_builtin_pt |
|
|
bridges_moat |
|
|
bridges_custom |
|
|
bridges_builtin |
|
|
persistent_tabs |
|
Kullanıcı herhangi bir sekmeyi ‘kaydedildi’ olarak tanımladıysa (yani OnionShare her başlatıldığında kalıcı oldukları ve onion adresleri değişmediği anlamına gelir), bunlara burada listelenen rastgele bir tanımlayıcı verilir. Kalıcı onion, bu tanımlayıcıyla aynı ada sahip bir JSON dosyası olarak, OnionShare yapılandırma klasörünün ‘persistent’ adlı alt klasöründe saklanır. Öntanımlı: [] |
locale |
|
OnionShare’de kullanılan yerel ayar. Öntanımlı: Yok (bu, ‘en’ ile aynıdır). Geçerli yerel ayar kodları için, https://github.com/onionshare/onionshare/blob/main/cli/onionshare_cli/settings.py içindeki ‘available_locales’ bölümüne bakın |
theme |
|
OnionShare masaüstü uygulamasının teması. Geçerli seçenekler 0 (kullanıcının bilgisayarının açık veya koyu temasını otomatik olarak algılar), 1 (açık) veya 2 (koyu) şeklindedir. |
Kalıcı onionlar için yapılandırma dosyası parametreleri
Yukarıda açıklandığı gibi, her bir ‘kalıcı’ onion, kendi JSON dosyasında saklanan kendine özgü parametrelere sahiptir. Bu dosyanın yolu, CLI aracı için --persistent ile belirtilebilir.
Kalıcı JSON yapılandırmasının bir örneği şu şekildedir:
{
"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": {}
}
Aşağıda, kalıcı bir onion için yapılandırma dosyası parametreleri ve bunların anlamları, JSON’daki her bölüm için verilmiştir
onion
Parametre |
Türü |
Açıklaması |
|---|---|---|
private_key |
|
Onion hizmetinin Base64 ile kodlanan kişisel anahtarı |
client_auth_priv_key |
|
İstemci kimlik doğrulaması kullanıldığında kişisel anahtar. Bunu kullanıcıya gönderin. |
client_auth_pub_key |
|
İstemci kimlik doğrulaması kullanıldığında herkese açık anahtar. OnionShare tarafında kullanılır. |
persistent
Parametre |
Türü |
Açıklaması |
|---|---|---|
mode |
|
Bu kalıcı onion tarafından kullanılan kip. Seçenekler “share”, “ receive”, “website” veya “chat” şeklindedir. |
enabled |
|
Bu onion için kalıcılığın etkinleştirilip etkinleştirilmeyeceği. Masaüstünde kalıcılık seçeneği işaretlenmediğinde, bu JSON dosyasının tamamı silinir. Öntanımlı: true |
autostart_on_launch |
|
OnionShare başlatıldığında ve Tor ağına bağlanıldığında bu kalıcı onion’un otomatik başlatılıp başlatılmayacağı. Öntanımlı: false |
general
Parametre |
Türü |
Açıklaması |
|---|---|---|
title |
|
Onion hizmetinde görüntülenmek üzere isteğe bağlı özel başlık. Öntanımlı: null (bunun yerine “OnionShare” gösterilir) |
public |
|
Onion hizmetine kişisel anahtar ile veya kişisel anahtar olmadan erişilip erişilemeyeceği (İstemci Kimlik Doğrulama). ‘true’ ise, kişisel anahtar gerekmez. |
autostart_timer |
|
Onion hizmetinin belirli bir zamanda başlatılacak şekilde yapılandırılıp yapılandırılmayacağı. Zaman, masaüstü uygulamasında ayarlanabilir veya CLI aracıyla |
autostop_timer |
|
Onion hizmetinin belirli bir zamanda durdurulacak şekilde yapılandırılıp yapılandırılmayacağı. Zaman, masaüstü uygulamasında ayarlanabilir veya CLI aracıyla |
service_id |
|
32 karakterlik onion hizmeti URL’si, şema ve ‘.onion’ son eki olmadan. |
Aşağıdakiler, yukarıdaki persistent bölümünde belirtilen ‘mode’ için özel ayarlardır.
receive
Parametre |
Türü |
Açıklaması |
|---|---|---|
data_dir |
|
Alınan dosyaların veya metin iletilerinin saklanacağı yol. Öntanımlı: kullanıcının ana dizinindeki ‘OnionShare’ klasörü. |
webhook_url |
|
OnionShare, dosya veya metin iletileri aldığında POST isteği göndereceği bir web kancası URL’si. Öntanımlı: null |
disable_text |
|
Metin iletilerinin alınmasının devre dışı bırakılıp bırakılmayacağı. Öntanımlı: false |
disable_files |
|
Dosya almanın devre dışı bırakılıp bırakılmayacağı. Öntanımlı: false |
website
Parametre |
Türü |
Açıklaması |
|---|---|---|
disable_csp |
|
|
custom_csp |
|
Öntanımlı yerine gönderilecek özel İçerik Güvenliği İlkesi başlığı. |
log_filenames |
|
CLI aracını kullanırken URL isteklerinin standart çıktıya yazdırılıp yazdırılmayacağı. Öntanımlı: false |
filenames |
|
Paylaşılacak dosyaların listesi. Öntanımlı: [] |
chat
Şu anda Sohbet kipi için yapılandırılabilir ayar yoktur.