Dies ist eine maschinelle Übersetzung. Das Original in Englisch ist hier: Update 24 February, 2022
Angesichts der wachsenden Zahl von Leuten, die daran interessiert sind, die Community-Testnetze und offiziellen Spielplätze auszuprobieren, und da @ChrisO die Installation für Windows-Benutzer mit seinem PowerShell-Skript vereinfacht hat, dachten wir, es wäre ein guter Zeitpunkt, die grundlegenden Befehle durchzugehen, damit die Leute es können Machen Sie sich die Hände schmutzig und machen Sie mit, wenn das nächste Comnet oder Testnet in Betrieb ist.
Allgemeiner Fortschritt
Chris hat in den letzten Tagen einige weitere Aktualisierungen am CLI-Benutzerhandbuch vorgenommen, darunter:
- Verschieben des Abschnitts XorUrl näher an den Anfang des Dokuments, wo es sinnvoller ist
- Umschreiben der NRS-,
cat
- unddog
-Dokumentation, um sie etwas schlanker zu machen - Hinzufügen eines neuen Abschnitts zu Keys, wo es für die aktuelle Netzwerkfunktionalität relevant ist.
Der nächste Schritt wird die Wiedereinführung von Shell-Vervollständigungen sein (damit Sie in der Lage sein werden, einen Befehl abzuschließen, indem Sie erneut die Tabulatortaste drücken - nicht sehr nützlich für cat
und dog
aber eine echte Zeitersparnis bei längeren Befehlen).
An anderer Stelle hat @yogesh den Pull-Flow abgeschlossen (bei dem Erwachsene automatisch die Daten abrufen, die sie aus dem Netzwerk halten sollten) und setzt Es hat sich mit Tests auf Herz und Nieren geprüft, und @davidrusu hat Mitgliedschaftsprobleme mit BLS-Schlüsseln gelöst und arbeitet derzeit daran, die Integrationsarbeit dort voranzutreiben.
Und wir freuen uns, @oetyng von seinem Sabbatical zurück zu begrüßen.
Er sprang auf das Verbindungs-Deadlock-Problem ein, und mit einer Überarbeitung der Verbindungsbehandlung, die heute zusammengeführt wurde, sehen die Tests jetzt viel stabiler aus. Einige Arbeiten in diesem Bereich werden fortgesetzt, da sie sich auf die umgestaltete Mitgliedschaft (ausstehende PR) und Verbesserungen im Messaging beziehen, die das Team jetzt diskutiert.
Verwenden der CLI
Die Befehlszeilenschnittstelle kann zunächst etwas beängstigend aussehen, wie ein Schritt zurück in die 1990er Jahre, aber für die Community-Testnetze und Spielplätze geht es meistens nur darum, Befehle zu kopieren und in ein Terminal wie PowerShell unter Windows oder Terminal auf dem Mac einzufügen /Linux und drücken Sie die Eingabetaste.
Hier sind einige der wichtigsten Befehle, die Sie für die Teilnahme benötigen. Hinweis: Warten Sie am besten, bis es ein Live-Testnet/Playground gibt, bevor Sie sie ausprobieren.
Herunterladen und Installieren der sicheren Anwendung
Wenn ein neues Community-Testnet oder ein neuer Spielplatz angekündigt wird, gibt es einige grundlegende Anweisungen zum Einstieg, und normalerweise sehen Sie so etwas (Mac/Linux)
curl -so- https://raw.githubusercontent.com/maidsafe/safe_network/main/resources/scripts/install.sh | bash
oder dies (Windows PowerShell)
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/maidsafe/safe_network/main/resources/scripts/install.ps1'))
Wenn Sie dies in Ihr Terminal einfügen und die Eingabetaste drücken, sollte „safe“ heruntergeladen und installiert werden, einschließlich der Aktualisierung von PATH, einer Liste von Orten, an denen das Betriebssystem nach installierten Anwendungen sucht.
Weitere Anweisungen finden Sie im aktualisierten Abschnitt Schnellstart des CLI-Benutzerhandbuchs.
Verbinden mit einem Testnetzwerk
Die nächsten Befehle laden die Konfigurationsdatei für ein Testnetzwerk herunter (in diesem Fall „comnet“ genannt) und lassen Sie sich damit verbinden. Sie sehen in etwa so aus (Hinweis: Diese Befehle funktionieren derzeit nicht, da derzeit kein Comnet / Testnet aktiv ist):
sichere Netzwerke comnet https://sn-comnet.s3.eu-west-2.amazonaws.com/node_connection_info.config hinzufügen
sichere Netzwerke wechseln comnet
Sie sollten nun in der Lage sein, Daten hoch- und herunterzuladen.
Beitritt als Knoten (optional)
Wenn Sie Ihr Glück versuchen möchten, dem Testnetzwerk als Speicherknoten beizutreten, wird der folgende Befehl die Knotensoftware herunterladen und installieren.
sichere Knoteninstallation
Sie können dann den Anweisungen des Testnetzes folgen, um beizutreten.
Weitere Informationen: Knoten bereitstellen
XorUrls
Alle in das Netzwerk hochgeladenen Inhalte haben eine Adresse, eine URL. Das sichere Netzwerk verwendet eine Adresse, die aus dem Inhalt selbst erstellt wird und als XorUrl bezeichnet wird, die wie folgt aussieht:
safe://hy8oyeyybwsanc3ehnecyab9n3ufoip6x47e6553rb539aeqnej1xwadcbfdo
Die XorUrl enthält Informationen darüber, wo sich die Daten befinden, um welche Art von Daten es sich handelt (z. B. Bild, Video, Text) und so weiter. XorUrls können mithilfe des Namensauflösungssystems von Safe Network (NRS) in menschenlesbare Adressen konvertiert werden.
Weitere Informationen: XorUrl
Hochladen einer Datei oder eines Ordners
Um Daten hochzuladen, verwenden Sie diesen Befehl: safe files put
Wenn sich also Ihre Datei „my-pic.jpg“ in Ihrem aktuellen Verzeichnis befindet (wie von der Terminal-Eingabeaufforderung angezeigt, z. B. C:\Users\Me\Pictures), wird sie in das Netzwerk hochgeladen:
sicher fDateien setzen mein-Bild.jpg
Bei Erfolg sehen Sie die XorUrl Ihrer hochgeladenen Datei, z. safe://hy8oycyybrqkkwrnmneshqetpnzfoncfw9qznm331515xk936hm1gsrkkw1cy
Um einen Ordner mit dem Namen „to-upload“ hochzuladen, der einige Dateien enthält (z. B. C:\Users\Me\Pictures\to-upload), lautet der Befehl
sichere Dateien setzen ./to-upload/ --recursive
Wenn dies erfolgreich ist, sehen Sie XorUrl für den Ordner und jede darin enthaltene Datei.
Um die Dateien in einem Container mit XorUrl „safe://hyryyryyndnbzqc9zmuu6iggm7j5obyx3sj8idcpg7ds9jdiwtjs1gjipd3ioeuy“ aufzulisten, verwenden Sie den Befehl „ls“ (Liste):
sichere Dateien ls safe://hyryyryyndnbzqc9zmuu6iggm7j5obyx3sj8idcpg7ds9jdiwtjs1gjipd3ioeuy
Weitere Informationen: Put
Informationen zu gespeicherten Daten finden
Wenn wir seine XorUrl kennen, können wir herausfinden, welche Art von Daten dog verwendet. Wenn wir das von uns hochgeladene my-pic-Bild „verfolgen“, bevor wir seine XorUrl verwenden, können wir sehen, dass es sich um ein JPEG handelt:
sicherer Hund sicher://hy8oycyybrqkkwrnmneshqetpnzfoncfw9qznm331515xk936hm1gsrkkw1cy
Die Ausgabe umfasst: Medientyp: Bild/JPG
Weitere Informationen: Dog
Herunterladen einer Datei
Der einfachste Weg, eine Datei herunterzuladen, ist die Verwendung von cat
. Um unsere Datei
safe://hy8oycyybrqkkwrnmneshqetpnzfoncfw9qznm331515xk936hm1gsrkkw1cy
in unser aktuelles Verzeichnis herunterzuladen, müssen wir der heruntergeladenen Datei einen Namen geben (andernfalls wird nur eine Menge Unsinn auf dem Bildschirm ausgegeben), wenn wir also wissen, dass es sich um ein JPG handelt:
safe cat safe://hy8oycyybrqkkwrnmneshqetpnzfoncfw9qznm331515xk936hm1gsrkkw1cy > my-new-filename.jpg
Weitere Informationen: Cat
Das sollte für den Anfang reichen. Hoffentlich sehen wir uns beim nächsten Community-Testnet oder Playground. :Spielplatz Rutsche:
Nützliche Links
Fühlen Sie sich frei, unten mit Links zu Übersetzungen dieses Entwicklungsupdates zu antworten, und die Moderatoren werden sie hier hinzufügen.
Als Open Source-Projekt sind wir immer auf der Suche nach Feedback, Kommentaren und Community-Beiträgen. Seien Sie also nicht schüchtern, machen Sie mit und lassen Sie uns gemeinsam das sichere Netzwerk erstellen!