diff --git a/docs/run-a-node/control-panel.md b/docs/run-a-node/control-panel.md new file mode 100644 index 0000000..3a8c8d3 --- /dev/null +++ b/docs/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: The dig-node Control Panel +description: "Manage your local dig-node from the DIG Chrome extension's Control Panel: reserved .dig cache space and LRU eviction, upstream, hosted stores, sync, peers, live status, and pairing the control token." +keywords: + - dig-node control panel + - dig cache + - LRU eviction + - reserved cache space + - control token pairing + - hosted stores + - node sync + - node peers +tags: + - dig-node + - browser + - dig-rpc +--- + +# The dig-node Control Panel + +The DIG Chrome extension includes a **Control Panel** for your local dig-node. From it you can see the node's live status, decide how much disk space to reserve for cached content, and — after a one-time pairing step — manage the node's upstream, the stores it hosts, its sync, and its peers. No command line required for everyday use. + +The Control Panel is the extension's built-in equivalent of the DIG Browser's node-management screen: it talks to the node running on your own machine, so everything stays local. + +## Open it + +1. Open the extension. +2. Go to the **Network** tab and choose **Control**. (The compact popup shows a summary; use **Open control panel** to see every section full-screen.) + +The panel detects the node automatically: + +- **Node running** → you see the management view. +- **No node found** → you see a short page on how to install one. Browsing still works — content reads fall back to the public network; a node is only needed for the management view below. + +## Live status + +At the top, a live indicator shows whether your node is **Connected**, **Connecting**, or **Disconnected**, along with its address and version. It updates on its own — start or stop the node and the indicator flips within a few seconds, with no need to reopen the panel or refresh. + +## Reserve disk space for cached content (cache & LRU) + +Your node keeps a local cache of the content it has fetched, so repeat visits are instant and you help serve that content. The cache has a **reserved size** — a cap on how much disk it may use. When the cache grows past the cap, the node automatically removes the **least-recently-used** items first (an "LRU" policy), so the space you reserve is never exceeded and the content you actually use stays cached. + +This section is available immediately — it needs no pairing. + +**See how much is used.** A bar shows used space against the reserved cap, plus a few live figures: how many items are cached, their total size, how much has been evicted since the node started, and the cache hit/miss counts. + +**Set the reserved cap.** Enter a new size and apply it. The minimum is 64 MiB; a smaller value is raised to that floor. Lowering the cap below what's currently used triggers eviction of the oldest items until usage fits. + +**Review and remove cached items.** The cached list shows each item with its size, when it was last used, and its **eviction order** (position `0` is the next item that would be removed). You can: + +- **Evict one item** — remove a single cached item now. +- **Clear all** — empty the cache entirely. + +Removing items only frees local disk; anything you visit again is simply re-fetched. + +:::tip +Give the cache as much room as you can spare on a machine you browse from often — a larger reserve means fewer re-fetches and more content served locally. On a space-constrained machine, set a smaller reserve; LRU keeps the most useful items and drops the rest. +::: + +## Manage the node (pairing required) + +The remaining sections change the node's configuration, so they require your explicit permission. Because the extension runs in the browser's sandbox, it cannot read the node's local permission file directly — instead you **pair** it once. Pairing grants the extension its own scoped, revocable credential; it never exposes the node's master key, and it can only be approved from the computer running the node. + +### Pair the extension with your node + +1. In the Control Panel, choose **Pair**. The extension shows a **6-digit code** and a pairing id. +2. On the computer running the node, in a terminal, run `dig-node pair` to list pending requests (or `dig-node pair approve ` directly). +3. Confirm the code shown in the terminal **matches** the code in the extension, then approve. This match is your safeguard: it ensures you approve *this* extension and nothing else. +4. The Control Panel switches to the paired state automatically. The credential is stored only by the extension. + +The pairing code **expires after a few minutes**; if yours does before you approve it, choose **Pair** again for a fresh one. + +To stop using the credential, choose **Unpair** in the panel (this forgets it locally). To revoke it on the node itself, run `dig-node pair revoke ` on that computer — the panel returns to the unpaired state on its next action. + +:::note +Pairing is only needed for the management sections below. Live status and the cache/LRU controls above work without it. +::: + +### Upstream + +View the upstream the node fetches from, and set a different one. A changed upstream takes effect the next time the node starts. + +### Hosted stores + +See the stores your node holds and pins, pin a new store (so the node keeps and serves it), unpin one, and check any store's status. Pinning a specific version pre-fetches it so it's ready to serve. + +### Sync + +See whether authenticated whole-store sync is available and, for a specific version, trigger a sync so the node fetches and caches it. + +### Peers + +See your node's peer-network status — its connection to the relay for reachability behind a home router, and the peers it is connected to. + +## Related + +- [Manage your node](./manage.md) — the `control.*` admin actions and how the browser drives them +- [Point a consumer at your node](./point-a-consumer.md) — set the extension, browser, or CLI to use your node +- [Configure dig-node](./configure.md) — ports, the cache cap, and the upstream diff --git a/docs/run-a-node/index.md b/docs/run-a-node/index.md index 074aac5..ff459b0 100644 --- a/docs/run-a-node/index.md +++ b/docs/run-a-node/index.md @@ -71,6 +71,7 @@ You don't need a node. Get the **[DIG Browser ↗](https://github.com/DIG-Networ - [Configure dig-node](./configure.md) — ports, listeners, cache cap, upstream - [Self-host a remote origin](../rpc/dig-remote.md) — `digstore serve` + dig:// clone/pull/push - [Manage your node](./manage.md) — the control.* admin RPCs + the My Node UI +- [The dig-node Control Panel](./control-panel.md) — run your node from the DIG extension: live status, reserved cache space (LRU), and — once paired — upstream/hosted stores/sync/peers - [Using the public network RPC](../rpc/public-network-rpc.md) — the dig RPC your node speaks, and operating a node on the network - [Installing the CLI](../digstore/cli/install.md) — `digstore` on its own (publishing, not serving) diff --git a/docs/run-a-node/manage.md b/docs/run-a-node/manage.md index 96aa057..53ced8d 100644 --- a/docs/run-a-node/manage.md +++ b/docs/run-a-node/manage.md @@ -41,6 +41,7 @@ Open it from the **Control Pane button in the toolbar** (next to the wallet and ## Related +- [The dig-node Control Panel](./control-panel.md) — manage the node from the extension: reserved cache + LRU, upstream, hosted stores, sync, peers, pairing - [Configure dig-node](./configure.md) — ports, cache cap, upstream - [Node conformance](../rpc/conformance.md) — the public serving contract (distinct from control.*) - [Self-host a remote origin](../rpc/dig-remote.md) — `digstore serve` + dig:// clone/pull/push diff --git a/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..b41b5f5 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: Das dig-node Bedienfeld +description: "Verwalte deinen lokalen dig-node über das Bedienfeld der DIG Chrome extension: reservierter .dig-Cache-Speicherplatz und LRU-Verdrängung, vorgelagerte Quelle, gehostete Stores, Synchronisierung, Peers, Live-Status und die Kopplung des Kontroll-Tokens." +keywords: + - dig-node Bedienfeld + - dig-Cache + - LRU-Verdrängung + - reservierter Cache-Speicherplatz + - Kopplung des Kontroll-Tokens + - gehostete Stores + - Node-Synchronisierung + - Node-Peers +tags: + - dig-node + - browser + - dig-rpc +--- + +# Das dig-node Bedienfeld + +Die DIG Chrome extension enthält ein **Bedienfeld** für deinen lokalen dig-node. Darin siehst du den Live-Status des Nodes, legst fest, wie viel Speicherplatz für zwischengespeicherte Inhalte reserviert werden soll, und verwaltest — nach einem einmaligen Kopplungsschritt — die vorgelagerte Quelle des Nodes, die von ihm gehosteten Stores, seine Synchronisierung und seine Peers. Für die alltägliche Nutzung ist keine Kommandozeile nötig. + +Das Bedienfeld ist das in die Erweiterung eingebaute Gegenstück zum Node-Verwaltungsbildschirm des DIG Browser: Es spricht mit dem Node, der auf deinem eigenen Rechner läuft, sodass alles lokal bleibt. + +## Öffnen + +1. Öffne die Erweiterung. +2. Gehe zum Tab **Network** (Netzwerk) und wähle **Control** (Steuerung). (Das kompakte Popup zeigt nur eine Zusammenfassung; nutze **Bedienfeld öffnen**, um jeden Bereich im Vollbild zu sehen.) + +Das Bedienfeld erkennt den Node automatisch: + +- **Node läuft** → du siehst die Verwaltungsansicht. +- **Kein Node gefunden** → du siehst eine kurze Seite dazu, wie man einen installiert. Das Browsen funktioniert weiterhin normal — Inhaltszugriffe weichen dann auf das öffentliche Netzwerk aus; ein Node wird nur für die unten beschriebene Verwaltungsansicht benötigt. + +## Live-Status + +Oben zeigt eine Live-Anzeige, ob dein Node **Verbunden**, **Verbindet** oder **Getrennt** ist, zusammen mit seiner Adresse und Version. Sie aktualisiert sich von selbst — starte oder stoppe den Node, und die Anzeige wechselt binnen weniger Sekunden, ohne dass du das Bedienfeld neu öffnen oder die Seite neu laden musst. + +## Speicherplatz für zwischengespeicherte Inhalte reservieren (Cache & LRU) + +Dein Node hält einen lokalen Cache der von ihm abgerufenen Inhalte vor, sodass wiederholte Zugriffe sofort erfolgen und du mithilfst, diese Inhalte auszuliefern. Der Cache hat eine **reservierte Größe** — eine Obergrenze dafür, wie viel Speicherplatz er nutzen darf. Wächst der Cache über diese Grenze hinaus, entfernt der Node automatisch zuerst die **am längsten nicht genutzten** Einträge (eine „LRU"-Richtlinie), sodass der von dir reservierte Platz nie überschritten wird und die Inhalte, die du tatsächlich nutzt, im Cache bleiben. + +Dieser Bereich ist sofort verfügbar — er erfordert keine Kopplung. + +**Nutzung ansehen.** Ein Balken zeigt den genutzten Speicherplatz im Verhältnis zur reservierten Obergrenze, dazu einige Live-Werte: wie viele Einträge im Cache sind, ihre Gesamtgröße, wie viel seit dem Start des Nodes verdrängt wurde, sowie die Zahl der Cache-Treffer/-Fehlschläge. + +**Reservierte Obergrenze festlegen.** Gib eine neue Größe ein und wende sie an. Das Minimum ist **64 MiB**; ein kleinerer Wert wird auf diese Untergrenze angehoben. Senkst du die Obergrenze unter die aktuelle Nutzung, löst das die Verdrängung der ältesten Einträge aus, bis die Nutzung wieder passt. + +**Zwischengespeicherte Einträge ansehen und entfernen.** Die Liste der zwischengespeicherten Einträge zeigt zu jedem Eintrag seine Größe, wann er zuletzt genutzt wurde, und seine **Verdrängungsreihenfolge** (Position `0` ist der Eintrag, der als Nächstes entfernt würde). Du kannst: + +- **Einen Eintrag verdrängen** — einen einzelnen zwischengespeicherten Eintrag sofort entfernen. +- **Alles leeren** — den Cache vollständig leeren. + +Das Entfernen von Einträgen gibt nur lokalen Speicherplatz frei; alles, was du erneut besuchst, wird einfach erneut abgerufen. + +:::tip +Gib dem Cache so viel Platz wie möglich auf einem Rechner, von dem aus du häufig browst — eine größere Reservierung bedeutet weniger erneute Abrufe und mehr lokal ausgelieferte Inhalte. Auf einem Rechner mit begrenztem Speicherplatz solltest du eine kleinere Reservierung festlegen; LRU behält die nützlichsten Einträge und verwirft den Rest. +::: + +## Den Node verwalten (Kopplung erforderlich) + +Die übrigen Bereiche ändern die Konfiguration des Nodes und erfordern daher deine ausdrückliche Erlaubnis. Da die Erweiterung in der Sandbox des Browsers läuft, kann sie die lokale Berechtigungsdatei des Nodes nicht direkt lesen — stattdessen **koppelst** du sie einmalig. Die Kopplung gewährt der Erweiterung ein eigenes, im Umfang begrenztes und widerrufbares Zugangsdatum; sie legt nie den Master-Key des Nodes offen, und sie kann nur auf dem Rechner genehmigt werden, auf dem der Node läuft. + +### Die Erweiterung mit deinem Node koppeln + +1. Wähle im Bedienfeld **Koppeln**. Die Erweiterung zeigt einen **6-stelligen Code** und eine Kopplungs-ID an. +2. Führe auf dem Rechner, auf dem der Node läuft, in einem Terminal `dig-node pair` aus, um ausstehende Anfragen aufzulisten (oder direkt `dig-node pair approve `). +3. Bestätige, dass der im Terminal angezeigte Code mit dem Code in der Erweiterung **übereinstimmt**, und genehmige dann. Dieser Abgleich ist deine Absicherung: Er stellt sicher, dass du *genau diese* Erweiterung genehmigst und keine andere. +4. Das Bedienfeld wechselt automatisch in den gekoppelten Zustand. Die Zugangsdaten werden nur von der Erweiterung gespeichert. + +Der Kopplungscode **läuft nach wenigen Minuten ab**; läuft deiner ab, bevor du ihn genehmigst, wähle einfach erneut **Koppeln** für einen neuen. + +Um die Zugangsdaten nicht mehr zu verwenden, wähle im Bedienfeld **Entkoppeln** (das vergisst sie nur lokal). Um sie am Node selbst zu widerrufen, führe auf diesem Rechner `dig-node pair revoke ` aus — das Bedienfeld kehrt bei seiner nächsten Aktion in den ungekoppelten Zustand zurück. + +:::note +Die Kopplung wird nur für die Verwaltungsbereiche unten benötigt. Der Live-Status und die Cache-/LRU-Steuerung oben funktionieren auch ohne sie. +::: + +### Vorgelagerte Quelle + +Sieh dir die vorgelagerte Quelle an, von der der Node Inhalte abruft, und lege eine andere fest. Eine geänderte vorgelagerte Quelle wird beim nächsten Start des Nodes wirksam. + +### Gehostete Stores + +Sieh dir die Stores an, die dein Node vorhält und anpinnt, pinne einen neuen Store an (damit der Node ihn vorhält und ausliefert), löse das Anpinnen eines anderen und prüfe den Status jedes beliebigen Stores. Das Anpinnen einer bestimmten Version ruft sie vorab ab, sodass sie sofort ausgeliefert werden kann. + +### Synchronisierung + +Sieh, ob eine authentifizierte Synchronisierung des gesamten Stores verfügbar ist, und löse für eine bestimmte Version eine Synchronisierung aus, sodass der Node sie abruft und zwischenspeichert. + +### Peers + +Sieh dir den Status des Peer-Netzwerks deines Nodes an — seine Verbindung zum Relay für Erreichbarkeit hinter einem heimischen Router sowie die Peers, mit denen er verbunden ist. + +## Siehe auch + +- [Verwalte deinen Node](./manage.md) — die administrativen `control.*`-Aktionen und wie der Browser sie ansteuert +- [Einen Client auf deinen Node zeigen lassen](./point-a-consumer.md) — Erweiterung, Browser oder CLI so einstellen, dass sie deinen Node nutzen +- [dig-node konfigurieren](./configure.md) — Ports, die Cache-Obergrenze und die vorgelagerte Quelle diff --git a/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/index.md index 460042c..deed5f7 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Du brauchst keinen Node. Hol dir den **[DIG Browser ↗](https://github.com/DIG- - [dig-node konfigurieren](./configure.md) — Ports, Listener, Cache-Obergrenze, Upstream - [Einen Remote-Origin selbst hosten](../rpc/dig-remote.md) — `digstore serve` + dig://-Clone/Pull/Push - [Deinen Node verwalten](./manage.md) — die control.*-Admin-RPCs + die My-Node-UI +- [Das Control Panel](./control-panel.md) — betreibe deinen Node komplett aus der DIG-Erweiterung: Live-Status, reservierter Cache-Speicher (LRU) und — nach dem Pairing — Upstream/gehostete Stores/Sync/Peers - [Die öffentliche Netzwerk-RPC nutzen](../rpc/public-network-rpc.md) — die dig RPC, die dein Node spricht, und den Betrieb eines Node im Netzwerk - [Die CLI installieren](../digstore/cli/install.md) — `digstore` für sich allein (Veröffentlichen, nicht Servieren) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..2012585 --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: El panel de control de dig-node +description: "Gestiona tu dig-node local desde el panel de control de la DIG Chrome extension: espacio de caché .dig reservado y desalojo LRU, origen ascendente, repositorios alojados, sincronización, pares, estado en vivo y el emparejamiento del token de control." +keywords: + - panel de control de dig-node + - caché de dig + - desalojo LRU + - espacio de caché reservado + - emparejamiento del token de control + - repositorios alojados + - sincronización del nodo + - pares del nodo +tags: + - dig-node + - browser + - dig-rpc +--- + +# El panel de control de dig-node + +La DIG Chrome extension incluye un **panel de control** para tu dig-node local. Desde él puedes ver el estado en vivo del nodo, decidir cuánto espacio en disco reservar para el contenido en caché y, tras un paso de emparejamiento único, gestionar el origen ascendente del nodo, los repositorios que aloja, su sincronización y sus pares. No hace falta la línea de comandos para el uso diario. + +El panel de control es el equivalente integrado en la extensión de la pantalla de gestión de nodos de DIG Browser: se comunica con el nodo que se ejecuta en tu propia máquina, así que todo permanece local. + +## Abrirlo + +1. Abre la extensión. +2. Ve a la pestaña **Network** (Red) y elige **Control**. (La ventana emergente compacta muestra un resumen; usa **Abrir panel de control** para ver cada sección a pantalla completa.) + +El panel detecta el nodo automáticamente: + +- **Nodo en ejecución** → verás la vista de gestión. +- **No se encontró ningún nodo** → verás una página breve sobre cómo instalar uno. La navegación sigue funcionando: las lecturas de contenido recurren a la red pública; un nodo solo hace falta para la vista de gestión que se describe a continuación. + +## Estado en vivo + +En la parte superior, un indicador en vivo muestra si tu nodo está **Conectado**, **Conectando** o **Desconectado**, junto con su dirección y versión. Se actualiza solo: inicia o detén el nodo y el indicador cambia en pocos segundos, sin necesidad de volver a abrir el panel ni de recargar. + +## Reservar espacio en disco para el contenido en caché (caché y LRU) + +Tu nodo mantiene una caché local del contenido que ha obtenido, de modo que las visitas repetidas sean instantáneas y ayudes a servir ese contenido. La caché tiene un **tamaño reservado**: un límite de cuánto disco puede usar. Cuando la caché supera ese límite, el nodo elimina automáticamente primero los elementos **usados menos recientemente** (una política "LRU"), de modo que el espacio que reservas nunca se supera y el contenido que realmente usas permanece en caché. + +Esta sección está disponible de inmediato; no necesita emparejamiento. + +**Ver cuánto se usa.** Una barra muestra el espacio usado frente al límite reservado, además de varias cifras en vivo: cuántos elementos hay en caché, su tamaño total, cuánto se ha desalojado desde que arrancó el nodo, y los conteos de aciertos/fallos de caché. + +**Definir el límite reservado.** Introduce un nuevo tamaño y aplícalo. El mínimo es **64 MiB**; un valor menor se eleva a ese suelo. Bajar el límite por debajo de lo que ya está en uso desencadena el desalojo de los elementos más antiguos hasta que el uso encaje. + +**Revisar y eliminar elementos en caché.** La lista de elementos en caché muestra cada uno con su tamaño, cuándo se usó por última vez y su **orden de desalojo** (la posición `0` es el siguiente elemento que se eliminaría). Puedes: + +- **Desalojar un elemento** — eliminar un único elemento en caché ahora mismo. +- **Vaciar todo** — vaciar la caché por completo. + +Eliminar elementos solo libera disco local; cualquier cosa que vuelvas a visitar simplemente se vuelve a obtener. + +:::tip +Dale a la caché todo el espacio que puedas en una máquina desde la que navegues a menudo: una reserva más grande significa menos reobtenciones y más contenido servido localmente. En una máquina con espacio limitado, define una reserva menor; LRU conserva los elementos más útiles y descarta el resto. +::: + +## Gestionar el nodo (requiere emparejamiento) + +Las secciones restantes cambian la configuración del nodo, así que requieren tu permiso explícito. Como la extensión se ejecuta en el sandbox del navegador, no puede leer directamente el archivo de permisos local del nodo; en su lugar, la **emparejas** una vez. El emparejamiento otorga a la extensión su propia credencial, limitada en alcance y revocable; nunca expone la clave maestra del nodo, y solo puede aprobarse desde el ordenador donde se ejecuta el nodo. + +### Emparejar la extensión con tu nodo + +1. En el panel de control, elige **Emparejar**. La extensión mostrará un **código de 6 dígitos** y un id de emparejamiento. +2. En el ordenador donde se ejecuta el nodo, en una terminal, ejecuta `dig-node pair` para listar las solicitudes pendientes (o directamente `dig-node pair approve `). +3. Confirma que el código mostrado en la terminal **coincide** con el código de la extensión, y luego apruébalo. Esta coincidencia es tu salvaguarda: garantiza que apruebas *esta* extensión y ninguna otra. +4. El panel de control pasa automáticamente al estado emparejado. La credencial se guarda únicamente en la extensión. + +El código de emparejamiento **caduca a los pocos minutos**; si el tuyo caduca antes de aprobarlo, elige **Emparejar** de nuevo para obtener uno nuevo. + +Para dejar de usar la credencial, elige **Desemparejar** en el panel (esto la olvida localmente). Para revocarla en el propio nodo, ejecuta `dig-node pair revoke ` en ese ordenador; el panel volverá al estado sin emparejar en su siguiente acción. + +:::note +El emparejamiento solo hace falta para las secciones de gestión de abajo. El estado en vivo y los controles de caché/LRU de arriba funcionan sin él. +::: + +### Origen ascendente + +Consulta el origen ascendente del que el nodo obtiene contenido y define uno distinto. Un origen ascendente cambiado surte efecto la próxima vez que arranque el nodo. + +### Repositorios alojados + +Consulta los repositorios que tu nodo mantiene y fija, fija uno nuevo (para que el nodo lo conserve y lo sirva), quita la fijación de otro y comprueba el estado de cualquiera. Fijar una versión concreta la obtiene por adelantado para que esté lista para servirse. + +### Sincronización + +Consulta si la sincronización completa autenticada del repositorio está disponible y, para una versión concreta, dispara una sincronización para que el nodo la obtenga y la guarde en caché. + +### Pares + +Consulta el estado de la red de pares de tu nodo: su conexión al relay para ser alcanzable detrás de un router doméstico, y los pares a los que está conectado. + +## Relacionados + +- [Gestiona tu nodo](./manage.md) — las acciones administrativas de `control.*` y cómo las conduce el navegador +- [Apunta un consumidor a tu nodo](./point-a-consumer.md) — configura la extensión, el navegador o la CLI para que usen tu nodo +- [Configura dig-node](./configure.md) — puertos, el límite de caché y el origen ascendente diff --git a/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/index.md index 1e61ea5..82dd51e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ No necesitas un nodo. Consigue el **[DIG Browser ↗](https://github.com/DIG-Net - [Configura dig-node](./configure.md) — puertos, listeners, límite de caché, upstream - [Auto-hospeda un origen remoto](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push por dig:// - [Gestiona tu nodo](./manage.md) — los RPCs de administración control.* y la UI My Node +- [El Panel de control](./control-panel.md) — gestiona tu nodo desde la extensión DIG: estado en vivo, espacio de caché reservado (LRU) y — tras el emparejamiento — upstream/stores alojados/sincronización/pares - [Usando el RPC de la red pública](../rpc/public-network-rpc.md) — el dig RPC que habla tu nodo, y cómo operar un nodo en la red - [Instalar la CLI](../digstore/cli/install.md) — `digstore` por su cuenta (publicar, no servir) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..7942ee6 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: Le panneau de contrôle de dig-node +description: "Gérez votre dig-node local depuis le panneau de contrôle de la DIG Chrome extension : espace de cache .dig réservé et éviction LRU, source amont, dépôts hébergés, synchronisation, pairs, statut en direct, et l'appairage du jeton de contrôle." +keywords: + - panneau de contrôle dig-node + - cache dig + - éviction LRU + - espace de cache réservé + - appairage du jeton de contrôle + - dépôts hébergés + - synchronisation du nœud + - pairs du nœud +tags: + - dig-node + - browser + - dig-rpc +--- + +# Le panneau de contrôle de dig-node + +La DIG Chrome extension embarque un **panneau de contrôle** pour votre dig-node local. Il permet de voir le statut en direct du nœud, de décider combien d'espace disque réserver au contenu mis en cache et — après une étape d'appairage à faire une seule fois — de gérer la source amont du nœud, les dépôts qu'il héberge, sa synchronisation et ses pairs. Aucune ligne de commande n'est nécessaire au quotidien. + +Le panneau de contrôle est l'équivalent, intégré à l'extension, de l'écran de gestion de nœud de DIG Browser : il dialogue avec le nœud qui tourne sur votre propre machine, donc tout reste local. + +## L'ouvrir + +1. Ouvrez l'extension. +2. Allez dans l'onglet **Network** (Réseau) et choisissez **Control** (Contrôle). (Le popup compact n'affiche qu'un résumé ; utilisez **Ouvrir le panneau de contrôle** pour voir chaque section en plein écran.) + +Le panneau détecte automatiquement le nœud : + +- **Nœud en cours d'exécution** → vous voyez la vue de gestion. +- **Aucun nœud trouvé** → vous voyez une courte page expliquant comment en installer un. La navigation continue de fonctionner normalement — les lectures de contenu basculent alors sur le réseau public ; un nœud n'est nécessaire que pour la vue de gestion ci-dessous. + +## Statut en direct + +En haut, un indicateur en direct montre si votre nœud est **Connecté**, **En connexion** ou **Déconnecté**, avec son adresse et sa version. Il se met à jour tout seul — démarrez ou arrêtez le nœud, et l'indicateur bascule en quelques secondes, sans avoir besoin de rouvrir le panneau ni de rafraîchir la page. + +## Réserver de l'espace disque pour le contenu mis en cache (cache et LRU) + +Votre nœud conserve un cache local du contenu qu'il a récupéré, afin que les visites répétées soient instantanées et que vous aidiez à servir ce contenu. Le cache a une **taille réservée** — un plafond sur la quantité de disque qu'il peut utiliser. Quand le cache dépasse ce plafond, le nœud supprime automatiquement en premier les éléments **les moins récemment utilisés** (une politique « LRU »), de sorte que l'espace que vous réservez n'est jamais dépassé et que le contenu que vous utilisez réellement reste en cache. + +Cette section est disponible immédiatement — elle ne nécessite aucun appairage. + +**Voir l'espace utilisé.** Une barre montre l'espace utilisé par rapport au plafond réservé, ainsi que quelques chiffres en direct : combien d'éléments sont en cache, leur taille totale, ce qui a été évincé depuis le démarrage du nœud, et le nombre de succès/échecs de cache. + +**Définir le plafond réservé.** Saisissez une nouvelle taille et appliquez-la. Le minimum est **64 MiB** ; une valeur plus petite est relevée à ce plancher. Abaisser le plafond en dessous de l'utilisation actuelle déclenche l'éviction des éléments les plus anciens jusqu'à ce que l'utilisation rentre dans la limite. + +**Consulter et retirer des éléments du cache.** La liste des éléments en cache affiche, pour chacun, sa taille, la dernière fois qu'il a été utilisé et son **ordre d'éviction** (la position `0` est le prochain élément qui serait retiré). Vous pouvez : + +- **Évincer un élément** — retirer immédiatement un seul élément du cache. +- **Tout effacer** — vider entièrement le cache. + +Retirer des éléments ne fait que libérer du disque local ; tout ce que vous revisitez est simplement récupéré à nouveau. + +:::tip +Donnez au cache autant d'espace que possible sur une machine que vous utilisez souvent pour naviguer — une réserve plus grande signifie moins de nouvelles récupérations et davantage de contenu servi localement. Sur une machine à l'espace limité, définissez une réserve plus petite ; le LRU conserve les éléments les plus utiles et écarte le reste. +::: + +## Gérer le nœud (appairage requis) + +Les sections restantes modifient la configuration du nœud et nécessitent donc votre autorisation explicite. Comme l'extension s'exécute dans le bac à sable du navigateur, elle ne peut pas lire directement le fichier de permissions local du nœud — vous devez à la place l'**appairer** une fois. L'appairage accorde à l'extension ses propres identifiants, à portée limitée et révocables ; il n'expose jamais la clé maîtresse du nœud, et il ne peut être approuvé que depuis l'ordinateur qui fait tourner le nœud. + +### Appairer l'extension avec votre nœud + +1. Dans le panneau de contrôle, choisissez **Appairer**. L'extension affiche un **code à 6 chiffres** et un identifiant d'appairage. +2. Sur l'ordinateur qui fait tourner le nœud, dans un terminal, exécutez `dig-node pair` pour lister les demandes en attente (ou directement `dig-node pair approve `). +3. Vérifiez que le code affiché dans le terminal **correspond** à celui de l'extension, puis approuvez. Cette correspondance est votre garde-fou : elle garantit que vous approuvez *cette* extension précise, et aucune autre. +4. Le panneau de contrôle bascule automatiquement à l'état appairé. Les identifiants ne sont stockés que par l'extension. + +Le code d'appairage **expire après quelques minutes** ; si le vôtre expire avant que vous ne l'approuviez, choisissez de nouveau **Appairer** pour en obtenir un nouveau. + +Pour cesser d'utiliser ces identifiants, choisissez **Dissocier** dans le panneau (cela les oublie localement). Pour les révoquer sur le nœud lui-même, exécutez `dig-node pair revoke ` sur cet ordinateur — le panneau revient à l'état non appairé lors de sa prochaine action. + +:::note +L'appairage n'est nécessaire que pour les sections de gestion ci-dessous. Le statut en direct et les contrôles cache/LRU ci-dessus fonctionnent sans lui. +::: + +### Source amont + +Consultez la source amont depuis laquelle le nœud récupère le contenu, et définissez-en une autre. Une source amont modifiée prend effet au prochain démarrage du nœud. + +### Dépôts hébergés + +Consultez les dépôts que votre nœud détient et épingle, épinglez un nouveau dépôt (pour que le nœud le conserve et le serve), désépinglez-en un, et vérifiez le statut de n'importe quel dépôt. Épingler une version précise la récupère à l'avance pour qu'elle soit prête à être servie. + +### Synchronisation + +Vérifiez si la synchronisation complète et authentifiée d'un dépôt est disponible et, pour une version précise, déclenchez une synchronisation pour que le nœud la récupère et la mette en cache. + +### Pairs + +Consultez le statut du réseau de pairs de votre nœud — sa connexion au relais pour être joignable derrière un routeur domestique, et les pairs auxquels il est connecté. + +## Voir aussi + +- [Gérer votre nœud](./manage.md) — les actions d'administration `control.*` et comment le navigateur les pilote +- [Diriger un client vers votre nœud](./point-a-consumer.md) — configurer l'extension, le navigateur ou la CLI pour utiliser votre nœud +- [Configurer dig-node](./configure.md) — ports, plafond de cache et source amont diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/index.md index 77da514..3666ea4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Vous n'avez pas besoin d'un nœud. Obtenez le **[DIG Browser ↗](https://github - [Configurer dig-node](./configure.md) — ports, écouteurs, plafond de cache, amont - [Auto-héberger une origine distante](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push dig:// - [Gérer votre nœud](./manage.md) — les RPC d'administration control.* et l'UI My Node +- [Le panneau de contrôle](./control-panel.md) — pilotez votre nœud depuis l'extension DIG : statut en direct, espace de cache réservé (LRU) et — une fois l'appairage effectué — amont/stores hébergés/synchronisation/pairs - [Utiliser le RPC du réseau public](../rpc/public-network-rpc.md) — le dig RPC que parle votre nœud, et faire tourner un nœud sur le réseau - [Installer la CLI](../digstore/cli/install.md) — `digstore` seul (publication, pas service) diff --git a/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..c954f99 --- /dev/null +++ b/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node नियंत्रण पैनल +description: "DIG Chrome extension के नियंत्रण पैनल से अपने लोकल dig-node को प्रबंधित करें: आरक्षित .dig कैश स्थान और LRU निष्कासन, अपस्ट्रीम, होस्ट किए गए स्टोर, सिंक, पीयर, लाइव स्थिति, और नियंत्रण टोकन पेयरिंग।" +keywords: + - dig-node नियंत्रण पैनल + - dig कैश + - LRU निष्कासन + - आरक्षित कैश स्थान + - नियंत्रण टोकन पेयरिंग + - होस्ट किए गए स्टोर + - नोड सिंक + - नोड पीयर +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node नियंत्रण पैनल + +DIG Chrome extension में आपके लोकल dig-node के लिए एक **नियंत्रण पैनल** शामिल है। इसके ज़रिए आप नोड की लाइव स्थिति देख सकते हैं, यह तय कर सकते हैं कि कैश की गई सामग्री के लिए कितना डिस्क स्थान आरक्षित करना है, और — एक बार की पेयरिंग प्रक्रिया पूरी करने के बाद — नोड के अपस्ट्रीम, उसके द्वारा होस्ट किए गए स्टोर, उसके सिंक, और उसके पीयर को प्रबंधित कर सकते हैं। रोज़मर्रा के उपयोग के लिए किसी कमांड लाइन की ज़रूरत नहीं है। + +नियंत्रण पैनल, DIG Browser की नोड-प्रबंधन स्क्रीन का एक्सटेंशन में अंतर्निहित समकक्ष है: यह आपकी अपनी मशीन पर चल रहे नोड से बात करता है, इसलिए सब कुछ लोकल ही रहता है। + +## इसे खोलना + +1. एक्सटेंशन खोलें। +2. **Network** (नेटवर्क) टैब पर जाएँ और **Control** (नियंत्रण) चुनें। (कॉम्पैक्ट पॉपअप केवल एक सारांश दिखाता है; हर सेक्शन को फ़ुल-स्क्रीन देखने के लिए **नियंत्रण पैनल खोलें** का उपयोग करें।) + +पैनल नोड को अपने-आप पहचान लेता है: + +- **नोड चल रहा है** → आपको प्रबंधन दृश्य दिखाई देगा। +- **कोई नोड नहीं मिला** → आपको एक छोटा-सा पेज दिखेगा कि नोड कैसे इंस्टॉल करें। ब्राउज़िंग फिर भी सामान्य रूप से काम करती रहती है — सामग्री रीड्स सार्वजनिक नेटवर्क पर वापस चली जाती हैं; नोड केवल नीचे दिए गए प्रबंधन दृश्य के लिए ज़रूरी है। + +## लाइव स्थिति + +सबसे ऊपर, एक लाइव इंडिकेटर दिखाता है कि आपका नोड **कनेक्टेड**, **कनेक्ट हो रहा है**, या **डिस्कनेक्टेड** है, साथ ही उसका पता और वर्शन भी। यह अपने-आप अपडेट होता रहता है — नोड को शुरू या बंद करें, और इंडिकेटर कुछ ही सेकंड में बदल जाता है, बिना पैनल दोबारा खोले या पेज रीफ़्रेश किए। + +## कैश की गई सामग्री के लिए डिस्क स्थान आरक्षित करना (कैश और LRU) + +आपका नोड उन सामग्रियों का एक लोकल कैश रखता है जिन्हें उसने फ़ेच किया है, ताकि दोबारा विज़िट तुरंत हों और आप उस सामग्री को सर्व करने में मदद करें। कैश का एक **आरक्षित आकार** होता है — यह सीमा तय करती है कि वह कितना डिस्क इस्तेमाल कर सकता है। जब कैश इस सीमा से बड़ा हो जाता है, तो नोड अपने-आप सबसे पहले उन आइटम को हटाता है जो **सबसे हाल में सबसे कम इस्तेमाल हुए हैं** ("LRU" नीति), इसलिए आपके द्वारा आरक्षित स्थान कभी पार नहीं होता, और जिस सामग्री का आप वास्तव में उपयोग करते हैं वह कैश में बनी रहती है। + +यह सेक्शन तुरंत उपलब्ध है — इसके लिए पेयरिंग की ज़रूरत नहीं है। + +**कितना उपयोग हुआ है यह देखें।** एक बार आरक्षित सीमा की तुलना में उपयोग किए गए स्थान को दिखाता है, साथ ही कुछ लाइव आँकड़े भी: कितने आइटम कैश में हैं, उनका कुल आकार, नोड शुरू होने के बाद से कितना निष्कासित हुआ है, और कैश हिट/मिस की संख्या। + +**आरक्षित सीमा सेट करें।** एक नया आकार दर्ज करें और लागू करें। न्यूनतम **64 MiB** है; इससे छोटा मान इस न्यूनतम सीमा तक बढ़ा दिया जाता है। सीमा को मौजूदा उपयोग से कम करने पर, उपयोग फिट होने तक सबसे पुराने आइटम का निष्कासन शुरू हो जाता है। + +**कैश किए गए आइटम की समीक्षा करें और हटाएँ।** कैश सूची हर आइटम को उसके आकार, अंतिम बार उपयोग किए जाने के समय, और उसके **निष्कासन क्रम** (स्थिति `0` वह अगला आइटम है जिसे हटाया जाएगा) के साथ दिखाती है। आप यह कर सकते हैं: + +- **एक आइटम निष्कासित करें** — अभी एक ही कैश आइटम हटाएँ। +- **सभी साफ़ करें** — पूरे कैश को खाली कर दें। + +आइटम हटाने से सिर्फ़ लोकल डिस्क खाली होती है; जिस भी चीज़ को आप दोबारा विज़िट करते हैं, वह बस दोबारा फ़ेच हो जाती है। + +:::tip +जिस मशीन से आप अक्सर ब्राउज़ करते हैं, उस पर कैश को जितना हो सके उतनी जगह दें — बड़ा आरक्षण मतलब कम दोबारा फ़ेचिंग और ज़्यादा सामग्री लोकल रूप से सर्व होना। सीमित स्थान वाली मशीन पर, एक छोटा आरक्षण सेट करें; LRU सबसे उपयोगी आइटम रखता है और बाकी को हटा देता है। +::: + +## नोड प्रबंधित करना (पेयरिंग आवश्यक) + +बाकी सेक्शन नोड के कॉन्फ़िगरेशन को बदलते हैं, इसलिए उनके लिए आपकी स्पष्ट अनुमति ज़रूरी है। चूँकि एक्सटेंशन ब्राउज़र के सैंडबॉक्स में चलता है, यह नोड की लोकल परमिशन फ़ाइल को सीधे नहीं पढ़ सकता — इसकी बजाय आप इसे एक बार **पेयर** करते हैं। पेयरिंग एक्सटेंशन को उसका अपना, सीमित दायरे वाला और रद्द किया जा सकने वाला क्रेडेंशियल देती है; यह नोड की मास्टर-की को कभी उजागर नहीं करती, और इसे केवल उसी कंप्यूटर से स्वीकृत किया जा सकता है जिस पर नोड चल रहा है। + +### एक्सटेंशन को अपने नोड के साथ पेयर करना + +1. नियंत्रण पैनल में, **पेयर** चुनें। एक्सटेंशन एक **6-अंकीय कोड** और एक पेयरिंग आईडी दिखाएगा। +2. जिस कंप्यूटर पर नोड चल रहा है, उस पर एक टर्मिनल में, लंबित रिक्वेस्ट सूचीबद्ध करने के लिए `dig-node pair` चलाएँ (या सीधे `dig-node pair approve ` चलाएँ)। +3. पुष्टि करें कि टर्मिनल में दिखाया गया कोड एक्सटेंशन के कोड से **मेल खाता है**, फिर स्वीकृत करें। यह मिलान आपकी सुरक्षा है: यह सुनिश्चित करता है कि आप *इसी* एक्सटेंशन को स्वीकृत कर रहे हैं, किसी और को नहीं। +4. नियंत्रण पैनल अपने-आप पेयर की गई स्थिति में बदल जाएगा। क्रेडेंशियल केवल एक्सटेंशन द्वारा ही स्टोर किया जाता है। + +पेयरिंग कोड **कुछ मिनटों में समाप्त** हो जाता है; यदि स्वीकृत करने से पहले आपका कोड समाप्त हो जाए, तो नया कोड पाने के लिए फिर से **पेयर** चुनें। + +उस क्रेडेंशियल का उपयोग बंद करने के लिए, पैनल में **अनपेयर** चुनें (यह इसे केवल लोकल रूप से भुला देता है)। इसे नोड पर ही रद्द करने के लिए, उस कंप्यूटर पर `dig-node pair revoke ` चलाएँ — पैनल अपनी अगली कार्रवाई पर अनपेयर की गई स्थिति में लौट आएगा। + +:::note +पेयरिंग केवल नीचे दिए गए प्रबंधन सेक्शन के लिए ज़रूरी है। ऊपर दी गई लाइव स्थिति और कैश/LRU नियंत्रण इसके बिना भी काम करते हैं। +::: + +### अपस्ट्रीम + +वह अपस्ट्रीम देखें जिससे नोड सामग्री फ़ेच करता है, और एक अलग अपस्ट्रीम सेट करें। बदला हुआ अपस्ट्रीम नोड के अगली बार शुरू होने पर प्रभावी होता है। + +### होस्ट किए गए स्टोर + +वे स्टोर देखें जिन्हें आपका नोड रखता और पिन करता है, एक नया स्टोर पिन करें (ताकि नोड उसे रखे और सर्व करे), किसी स्टोर को अनपिन करें, और किसी भी स्टोर की स्थिति जाँचें। किसी विशेष वर्शन को पिन करने से वह पहले से फ़ेच हो जाता है ताकि वह सर्व करने के लिए तैयार रहे। + +### सिंक + +देखें कि क्या प्रमाणित पूरे-स्टोर सिंक उपलब्ध है, और किसी विशेष वर्शन के लिए सिंक ट्रिगर करें ताकि नोड उसे फ़ेच करके कैश कर ले। + +### पीयर + +अपने नोड की पीयर-नेटवर्क स्थिति देखें — होम राउटर के पीछे पहुँच योग्य बने रहने के लिए रिले से इसका कनेक्शन, और वे पीयर जिनसे यह जुड़ा है। + +## संबंधित + +- [अपना नोड प्रबंधित करें](./manage.md) — `control.*` एडमिन क्रियाएँ और ब्राउज़र इन्हें कैसे चलाता है +- [किसी उपभोक्ता को अपने नोड की ओर इंगित करें](./point-a-consumer.md) — एक्सटेंशन, ब्राउज़र, या CLI को अपने नोड का उपयोग करने के लिए सेट करें +- [dig-node कॉन्फ़िगर करें](./configure.md) — पोर्ट, कैश सीमा, और अपस्ट्रीम diff --git a/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/index.md index 4b2f4c5..5d73003 100644 --- a/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/hi/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [Configure dig-node](./configure.md) — ports, listeners, कैश कैप, upstream - [Self-host a remote origin](../rpc/dig-remote.md) — `digstore serve` + dig:// clone/pull/push - [Manage your node](./manage.md) — control.* admin RPCs + My Node UI +- [नियंत्रण पैनल](./control-panel.md) — DIG एक्सटेंशन से अपना node पूरी तरह चलाएँ: लाइव स्थिति, आरक्षित कैश स्पेस (LRU), और — पेयरिंग के बाद — upstream/hosted stores/sync/peers - [Using the public network RPC](../rpc/public-network-rpc.md) — dig RPC जो आपका node बोलता है, और नेटवर्क पर एक node ऑपरेट करना - [Installing the CLI](../digstore/cli/install.md) — अकेले `digstore` (पब्लिशिंग, सर्विंग नहीं) diff --git a/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..1580790 --- /dev/null +++ b/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: Panel Kontrol dig-node +description: "Kelola dig-node lokal Anda dari Panel Kontrol pada DIG Chrome extension: ruang cache .dig yang dicadangkan dan eviksi LRU, sumber hulu, store yang di-hosting, sinkronisasi, peer, status langsung, dan pemasangan token kontrol." +keywords: + - panel kontrol dig-node + - cache dig + - eviksi LRU + - ruang cache yang dicadangkan + - pemasangan token kontrol + - store yang di-hosting + - sinkronisasi node + - peer node +tags: + - dig-node + - browser + - dig-rpc +--- + +# Panel Kontrol dig-node + +DIG Chrome extension menyertakan **Panel Kontrol** untuk dig-node lokal Anda. Dari sana Anda dapat melihat status langsung node, memutuskan berapa banyak ruang disk yang dicadangkan untuk konten yang di-cache, dan — setelah langkah pemasangan satu kali — mengelola sumber hulu node, store yang di-hosting-nya, sinkronisasinya, dan peer-nya. Tidak diperlukan baris perintah untuk penggunaan sehari-hari. + +Panel Kontrol adalah versi bawaan pada ekstensi dari layar manajemen node milik DIG Browser: ia berbicara dengan node yang berjalan di komputer Anda sendiri, sehingga semuanya tetap lokal. + +## Membukanya + +1. Buka ekstensi. +2. Buka tab **Network** (Jaringan) lalu pilih **Control** (Kontrol). (Popup ringkas hanya menampilkan ringkasan; gunakan **Buka panel kontrol** untuk melihat setiap bagian secara penuh layar.) + +Panel akan mendeteksi node secara otomatis: + +- **Node berjalan** → Anda akan melihat tampilan manajemen. +- **Tidak ada node yang ditemukan** → Anda akan melihat halaman singkat tentang cara menginstal satu. Menjelajah tetap berjalan normal — pembacaan konten akan kembali menggunakan jaringan publik; node hanya diperlukan untuk tampilan manajemen di bawah ini. + +## Status langsung + +Di bagian atas, indikator langsung menunjukkan apakah node Anda **Terhubung**, **Menghubungkan**, atau **Terputus**, beserta alamat dan versinya. Indikator ini memperbarui dirinya sendiri — jalankan atau hentikan node, dan indikator akan berubah dalam beberapa detik, tanpa perlu membuka ulang panel atau memuat ulang halaman. + +## Mencadangkan ruang disk untuk konten yang di-cache (cache dan LRU) + +Node Anda menyimpan cache lokal dari konten yang telah diambilnya, sehingga kunjungan berulang menjadi instan dan Anda turut membantu menyajikan konten tersebut. Cache memiliki **ukuran yang dicadangkan** — batas atas seberapa banyak disk yang boleh digunakannya. Ketika cache melebihi batas ini, node akan secara otomatis menghapus terlebih dahulu item yang **paling lama tidak digunakan** (kebijakan "LRU"), sehingga ruang yang Anda cadangkan tidak akan pernah terlampaui, dan konten yang benar-benar Anda pakai tetap berada di cache. + +Bagian ini tersedia segera — tidak memerlukan pemasangan. + +**Lihat berapa banyak yang terpakai.** Sebuah bilah menunjukkan ruang yang terpakai dibandingkan batas yang dicadangkan, ditambah beberapa angka langsung: berapa banyak item yang ada di cache, total ukurannya, berapa banyak yang telah dieviksi sejak node dimulai, dan jumlah cache hit/miss. + +**Menetapkan batas yang dicadangkan.** Masukkan ukuran baru lalu terapkan. Minimumnya adalah **64 MiB**; nilai yang lebih kecil akan dinaikkan ke batas bawah ini. Menurunkan batas di bawah penggunaan saat ini akan memicu eviksi item tertua hingga penggunaan sesuai. + +**Meninjau dan menghapus item cache.** Daftar item cache menampilkan setiap item beserta ukurannya, kapan terakhir digunakan, dan **urutan eviksi**-nya (posisi `0` adalah item berikutnya yang akan dihapus). Anda dapat: + +- **Mengeviksi satu item** — menghapus satu item cache sekarang. +- **Bersihkan semua** — mengosongkan cache sepenuhnya. + +Menghapus item hanya membebaskan disk lokal; apa pun yang Anda kunjungi kembali cukup diambil ulang. + +:::tip +Berikan ruang sebanyak mungkin untuk cache pada komputer yang sering Anda pakai untuk menjelajah — cadangan yang lebih besar berarti lebih sedikit pengambilan ulang dan lebih banyak konten yang disajikan secara lokal. Pada komputer dengan ruang terbatas, tetapkan cadangan yang lebih kecil; LRU akan mempertahankan item yang paling berguna dan membuang sisanya. +::: + +## Mengelola node (memerlukan pemasangan) + +Bagian-bagian lainnya mengubah konfigurasi node, sehingga memerlukan izin eksplisit Anda. Karena ekstensi berjalan di dalam sandbox milik peramban, ia tidak dapat membaca berkas izin lokal node secara langsung — sebagai gantinya, Anda **memasangkannya** satu kali. Pemasangan memberikan ekstensi kredensial miliknya sendiri, dengan cakupan terbatas dan dapat dicabut; ia tidak pernah mengungkap kunci utama node, dan hanya dapat disetujui dari komputer yang menjalankan node tersebut. + +### Memasangkan ekstensi dengan node Anda + +1. Di Panel Kontrol, pilih **Pasangkan**. Ekstensi akan menampilkan **kode 6 digit** dan id pemasangan. +2. Di komputer yang menjalankan node, pada sebuah terminal, jalankan `dig-node pair` untuk mendaftar permintaan yang tertunda (atau langsung jalankan `dig-node pair approve `). +3. Pastikan kode yang ditampilkan di terminal **cocok** dengan kode di ekstensi, lalu setujui. Kecocokan ini adalah pengaman Anda: ini memastikan bahwa yang Anda setujui adalah ekstensi *ini* dan bukan yang lain. +4. Panel Kontrol akan otomatis beralih ke status terpasang. Kredensial hanya disimpan oleh ekstensi. + +Kode pemasangan **kedaluwarsa setelah beberapa menit**; jika kode Anda kedaluwarsa sebelum disetujui, pilih **Pasangkan** lagi untuk mendapatkan yang baru. + +Untuk berhenti menggunakan kredensial tersebut, pilih **Lepas Pasangan** di panel (ini hanya melupakannya secara lokal). Untuk mencabutnya di node itu sendiri, jalankan `dig-node pair revoke ` di komputer tersebut — panel akan kembali ke status belum terpasang pada aksi berikutnya. + +:::note +Pemasangan hanya diperlukan untuk bagian-bagian manajemen di bawah ini. Status langsung dan kontrol cache/LRU di atas berfungsi tanpanya. +::: + +### Sumber hulu + +Lihat sumber hulu tempat node mengambil konten, dan tetapkan yang berbeda. Sumber hulu yang diubah akan berlaku pada saat node berikutnya kali dimulai. + +### Store yang di-hosting + +Lihat store yang disimpan dan di-pin oleh node Anda, pin store baru (agar node menyimpan dan menyajikannya), lepaskan pin dari salah satunya, dan periksa status store mana pun. Mem-pin versi tertentu akan mengambilnya terlebih dahulu agar siap untuk disajikan. + +### Sinkronisasi + +Lihat apakah sinkronisasi seluruh store yang terautentikasi tersedia, dan untuk versi tertentu, picu sinkronisasi agar node mengambil dan meng-cache-nya. + +### Peer + +Lihat status jaringan peer node Anda — koneksinya ke relay untuk keterjangkauan di balik router rumah, serta peer yang sedang terhubung dengannya. + +## Terkait + +- [Kelola node Anda](./manage.md) — aksi administratif `control.*` dan cara peramban mengendalikannya +- [Arahkan konsumen ke node Anda](./point-a-consumer.md) — atur ekstensi, peramban, atau CLI agar menggunakan node Anda +- [Konfigurasikan dig-node](./configure.md) — port, batas cache, dan sumber hulu diff --git a/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/index.md index 5297288..f195195 100644 --- a/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/id/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Anda tidak memerlukan sebuah node. Dapatkan **[DIG Browser ↗](https://github.c - [Konfigurasikan dig-node](./configure.md) — port, listener, batas cache, upstream - [Self-host sebuah origin remote](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push dig:// - [Kelola node Anda](./manage.md) — RPC admin control.* dan UI My Node +- [Panel Kontrol](./control-panel.md) — jalankan node Anda sepenuhnya dari ekstensi DIG: status langsung, ruang cache yang dicadangkan (LRU), dan — setelah pemasangan (pairing) — upstream/hosted stores/sinkronisasi/peer - [Menggunakan RPC jaringan publik](../rpc/public-network-rpc.md) — dig RPC yang diucapkan node Anda, dan cara mengoperasikan sebuah node di jaringan - [Menginstal CLI](../digstore/cli/install.md) — `digstore` sendiri (menerbitkan, bukan menyajikan) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..382cf7f --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node コントロールパネル +description: "DIG Chrome extension のコントロールパネルからローカルの dig-node を管理します: 予約された .dig キャッシュ容量と LRU エビクション、アップストリーム、ホストしているストア、同期、ピア、ライブステータス、そしてコントロールトークンのペアリング。" +keywords: + - dig-node コントロールパネル + - dig キャッシュ + - LRU エビクション + - 予約キャッシュ容量 + - コントロールトークンのペアリング + - ホストしているストア + - ノード同期 + - ノードピア +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node コントロールパネル + +DIG Chrome extension には、ローカルの dig-node を管理するための**コントロールパネル**が組み込まれています。ここからノードのライブステータスを確認したり、キャッシュされたコンテンツのためにどれだけのディスク容量を予約するかを決めたりできます。さらに、一度だけのペアリングを済ませれば、ノードのアップストリーム、ホストしているストア、同期、ピアまで管理できます。日常的な利用にコマンドラインは不要です。 + +コントロールパネルは、DIG Browser のノード管理画面に相当する機能を拡張機能に組み込んだものです。自分自身のマシンで動いているノードと通信するため、すべてがローカルにとどまります。 + +## 開き方 + +1. 拡張機能を開きます。 +2. **Network**(ネットワーク)タブを開き、**Control**(コントロール)を選びます。(コンパクトなポップアップには概要のみが表示されます。各セクションを全画面で見るには**コントロールパネルを開く**を使ってください。) + +パネルはノードを自動的に検出します。 + +- **ノードが実行中** → 管理画面が表示されます。 +- **ノードが見つからない** → ノードのインストール方法を説明する短いページが表示されます。この場合でもブラウジング自体は問題なく行えます——コンテンツの読み込みはパブリックネットワークへフォールバックします。ノードが必要になるのは、下記の管理画面だけです。 + +## ライブステータス + +上部のライブインジケーターは、ノードが**接続済み**、**接続中**、**切断**のいずれの状態にあるかを、そのアドレスとバージョンとともに表示します。この表示は自動的に更新されます——ノードを起動または停止すると、数秒以内にインジケーターが切り替わり、パネルを開き直したり再読み込みしたりする必要はありません。 + +## キャッシュコンテンツ用にディスク容量を予約する(キャッシュと LRU) + +あなたのノードは取得済みのコンテンツをローカルにキャッシュするため、再訪問が瞬時になり、そのコンテンツの配信を手助けすることにもなります。キャッシュには**予約サイズ**があります——ノードが使用できるディスク容量の上限です。キャッシュがこの上限を超えると、ノードは**最も長く使われていない**項目から自動的に削除していきます(「LRU」ポリシー)。これにより、予約した容量を超えることはなく、実際に使っているコンテンツはキャッシュされたままになります。 + +このセクションはペアリングなしですぐに利用できます。 + +**使用量を確認する。** バーが予約上限に対する使用容量を示すほか、いくつかのライブな数値も表示されます:キャッシュされている項目数、その合計サイズ、ノード起動後に削除(エビクション)された量、そしてキャッシュのヒット/ミス件数です。 + +**予約上限を設定する。** 新しいサイズを入力して適用します。最小値は **64 MiB** で、これより小さい値はこの下限に引き上げられます。上限を現在の使用量より低く設定すると、使用量が収まるまで最も古い項目からエビクションが実行されます。 + +**キャッシュ項目を確認・削除する。** キャッシュ一覧には各項目のサイズ、最終使用日時、そして**エビクション順序**(位置 `0` が次に削除される項目)が表示されます。次のことができます。 + +- **1 件をエビクションする** — 単一のキャッシュ項目を今すぐ削除します。 +- **すべてクリアする** — キャッシュを完全に空にします。 + +項目を削除してもローカルディスクの空き容量が増えるだけです。再び訪れたコンテンツは、単に再取得されます。 + +:::tip +よく使うマシンでは、キャッシュにできるだけ多くの容量を割り当ててください——予約容量が大きいほど再取得が減り、より多くのコンテンツをローカルから配信できます。ディスク容量が限られたマシンでは予約を小さくしましょう。LRU が最も有用な項目を残し、それ以外を破棄します。 +::: + +## ノードを管理する(ペアリングが必要) + +残りのセクションはノードの設定を変更するため、明示的な許可が必要です。拡張機能はブラウザのサンドボックス内で動作するため、ノードのローカル権限ファイルを直接読み取ることができません——そこで、一度だけ**ペアリング**を行います。ペアリングによって拡張機能には専用の、範囲が限定され取り消し可能な資格情報が発行されます。ノードのマスターキーが露出することは決してなく、承認できるのはそのノードを実行しているコンピューター上だけです。 + +### 拡張機能をノードとペアリングする + +1. コントロールパネルで**ペアリング**を選びます。拡張機能に **6 桁のコード**とペアリング ID が表示されます。 +2. ノードを実行しているコンピューターのターミナルで `dig-node pair` を実行し、保留中のリクエストを一覧表示します(または直接 `dig-node pair approve ` を実行します)。 +3. ターミナルに表示されたコードが拡張機能のコードと**一致**することを確認してから承認します。この一致確認があなたを守る仕組みです。承認しているのが*ほかならぬこの*拡張機能であることを保証します。 +4. コントロールパネルは自動的にペアリング済みの状態に切り替わります。資格情報は拡張機能側にのみ保存されます。 + +ペアリングコードは**数分で失効**します。承認する前に失効した場合は、もう一度**ペアリング**を選んで新しいコードを取得してください。 + +資格情報の利用をやめるには、パネルで**ペアリング解除**を選びます(ローカル側で忘れるだけです)。ノード側で取り消すには、そのコンピューターで `dig-node pair revoke ` を実行してください——パネルは次の操作時に未ペアリングの状態へ戻ります。 + +:::note +ペアリングが必要なのは、下記の管理セクションのみです。上記のライブステータスとキャッシュ/LRU の操作はペアリングなしで動作します。 +::: + +### アップストリーム + +ノードが取得元としているアップストリームを確認し、別のものに設定できます。変更したアップストリームは、次にノードが起動したときに反映されます。 + +### ホストしているストア + +ノードが保持・固定(ピン留め)しているストアを確認し、新しいストアを固定して(ノードがそれを保持・配信するように)ピン留めしたり、固定を解除したり、任意のストアのステータスを確認したりできます。特定バージョンを固定すると、それを事前に取得しておき、すぐに配信できる状態にします。 + +### 同期 + +認証付きのストア全体同期が利用可能かどうかを確認し、特定バージョンについて同期を実行して、ノードにそのバージョンを取得・キャッシュさせることができます。 + +### ピア + +あなたのノードのピアネットワークの状態——家庭用ルーターの内側からでも到達可能にするためのリレーへの接続状況や、接続中のピア——を確認できます。 + +## 関連ページ + +- [ノードを管理する](./manage.md) — `control.*` の管理アクションと、ブラウザがそれをどう操作するか +- [コンシューマーをノードに向ける](./point-a-consumer.md) — 拡張機能・ブラウザ・CLI があなたのノードを使うように設定する +- [dig-node を設定する](./configure.md) — ポート、キャッシュ上限、アップストリーム diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/index.md index b4ecda6..9fd9e4a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [dig-nodeを設定する](./configure.md) — ポート、リスナー、キャッシュ上限、アップストリーム - [リモートオリジンをセルフホストする](../rpc/dig-remote.md) — `digstore serve` + dig://のclone/pull/push - [ノードを管理する](./manage.md) — control.*管理RPCとMy Node UI +- [コントロールパネル](./control-panel.md) — DIG拡張機能からノードをまるごと運用する：ライブステータス、予約キャッシュ容量（LRU）、そしてペアリング後はアップストリーム／ホストするストア／同期／ピア - [公開ネットワークRPCを使う](../rpc/public-network-rpc.md) — あなたのノードが話すdig RPCと、ネットワーク上でのノード運用 - [CLIのインストール](../digstore/cli/install.md) — `digstore`単体（配信ではなく公開のため） diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..bc4d656 --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node 제어판 +description: "DIG Chrome extension의 제어판에서 로컬 dig-node를 관리하세요: 예약된 .dig 캐시 공간과 LRU 축출, 업스트림, 호스팅되는 스토어, 동기화, 피어, 실시간 상태, 그리고 제어 토큰 페어링." +keywords: + - dig-node 제어판 + - dig 캐시 + - LRU 축출 + - 예약된 캐시 공간 + - 제어 토큰 페어링 + - 호스팅되는 스토어 + - 노드 동기화 + - 노드 피어 +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node 제어판 + +DIG Chrome extension에는 로컬 dig-node를 위한 **제어판**이 내장되어 있습니다. 제어판에서 노드의 실시간 상태를 확인하고, 캐시된 콘텐츠를 위해 얼마나 많은 디스크 공간을 예약할지 결정할 수 있으며, 일회성 페어링 절차를 마친 뒤에는 노드의 업스트림, 노드가 호스팅하는 스토어, 동기화, 피어까지 관리할 수 있습니다. 일상적인 사용에는 명령줄이 필요하지 않습니다. + +제어판은 DIG Browser의 노드 관리 화면에 해당하는 확장 프로그램 내장 기능입니다. 여러분 자신의 컴퓨터에서 실행 중인 노드와 통신하므로 모든 것이 로컬에 머무릅니다. + +## 열기 + +1. 확장 프로그램을 엽니다. +2. **Network**(네트워크) 탭으로 이동해 **Control**(제어)을 선택합니다. (간단한 팝업에는 요약만 표시됩니다. 각 섹션을 전체 화면으로 보려면 **제어판 열기**를 사용하세요.) + +패널은 노드를 자동으로 감지합니다. + +- **노드 실행 중** → 관리 화면이 표시됩니다. +- **노드를 찾을 수 없음** → 노드 설치 방법을 안내하는 짧은 페이지가 표시됩니다. 이 경우에도 브라우징은 정상적으로 작동합니다 — 콘텐츠 읽기는 공개 네트워크로 대체(fallback)됩니다. 노드는 아래의 관리 화면에서만 필요합니다. + +## 실시간 상태 + +상단의 실시간 표시기는 노드가 **연결됨**, **연결 중**, **연결 끊김** 중 어떤 상태인지와 그 주소 및 버전을 보여줍니다. 이 표시는 자동으로 갱신됩니다 — 노드를 시작하거나 중지하면 몇 초 안에 표시기가 바뀌며, 패널을 다시 열거나 새로고침할 필요가 없습니다. + +## 캐시된 콘텐츠를 위한 디스크 공간 예약(캐시 및 LRU) + +노드는 가져온 콘텐츠의 로컬 캐시를 유지하므로, 재방문 시 즉시 응답하고 여러분도 해당 콘텐츠 제공을 돕게 됩니다. 캐시에는 **예약된 크기**가 있습니다 — 사용할 수 있는 디스크 공간의 상한입니다. 캐시가 이 상한을 초과하면 노드는 **가장 오랫동안 사용되지 않은** 항목부터 자동으로 제거합니다("LRU" 정책). 그래서 예약한 공간이 초과되는 일은 없으며, 실제로 사용하는 콘텐츠는 계속 캐시에 남습니다. + +이 섹션은 페어링 없이 바로 사용할 수 있습니다. + +**사용량 확인.** 막대 그래프가 예약 상한 대비 사용된 공간을 보여주며, 몇 가지 실시간 수치도 함께 제공됩니다: 캐시된 항목 수, 총 크기, 노드가 시작된 이후 축출된 양, 캐시 적중/실패 횟수입니다. + +**예약 상한 설정.** 새 크기를 입력하고 적용합니다. 최소값은 **64 MiB**이며, 이보다 작은 값은 이 하한으로 올림 처리됩니다. 상한을 현재 사용량보다 낮게 설정하면 사용량이 맞을 때까지 가장 오래된 항목부터 축출이 실행됩니다. + +**캐시 항목 확인 및 제거.** 캐시 목록에는 각 항목의 크기, 마지막 사용 시각, **축출 순서**(위치 `0`은 다음에 제거될 항목)가 표시됩니다. 다음을 수행할 수 있습니다. + +- **항목 하나 축출** — 지금 캐시 항목 하나를 제거합니다. +- **전체 지우기** — 캐시를 완전히 비웁니다. + +항목을 제거해도 로컬 디스크 공간만 확보될 뿐입니다. 다시 방문하는 콘텐츠는 그저 다시 가져올 뿐입니다. + +:::tip +자주 브라우징하는 컴퓨터라면 캐시에 가능한 한 넉넉한 공간을 할당하세요 — 예약 공간이 클수록 재요청이 줄고 로컬에서 제공되는 콘텐츠가 늘어납니다. 공간이 제한된 컴퓨터에서는 예약 공간을 작게 설정하세요. LRU가 가장 유용한 항목을 남기고 나머지를 제거합니다. +::: + +## 노드 관리(페어링 필요) + +나머지 섹션들은 노드의 설정을 변경하므로 명시적인 권한이 필요합니다. 확장 프로그램은 브라우저의 샌드박스 안에서 실행되기 때문에 노드의 로컬 권한 파일을 직접 읽을 수 없습니다 — 그래서 한 번 **페어링**을 해야 합니다. 페어링은 확장 프로그램에 자체적인, 범위가 제한되고 취소 가능한 자격 증명을 부여합니다. 이 과정에서 노드의 마스터 키가 노출되는 일은 절대 없으며, 노드가 실행 중인 컴퓨터에서만 승인할 수 있습니다. + +### 확장 프로그램을 노드와 페어링하기 + +1. 제어판에서 **페어링**을 선택합니다. 확장 프로그램이 **6자리 코드**와 페어링 ID를 표시합니다. +2. 노드가 실행 중인 컴퓨터의 터미널에서 `dig-node pair`를 실행해 대기 중인 요청 목록을 확인합니다(또는 바로 `dig-node pair approve `를 실행합니다). +3. 터미널에 표시된 코드가 확장 프로그램의 코드와 **일치**하는지 확인한 뒤 승인합니다. 이 일치 확인이 여러분을 지켜주는 안전장치입니다 — 여러분이 승인하는 것이 *바로 이* 확장 프로그램이며 다른 무엇도 아님을 보장합니다. +4. 제어판이 자동으로 페어링된 상태로 전환됩니다. 자격 증명은 확장 프로그램에만 저장됩니다. + +페어링 코드는 **몇 분 후 만료**됩니다. 승인하기 전에 만료되었다면 **페어링**을 다시 선택해 새 코드를 받으세요. + +이 자격 증명 사용을 중단하려면 패널에서 **페어링 해제**를 선택하세요(로컬에서 잊어버리는 것뿐입니다). 노드 자체에서 이를 취소하려면 해당 컴퓨터에서 `dig-node pair revoke `를 실행하세요 — 패널은 다음 동작 시 페어링되지 않은 상태로 돌아갑니다. + +:::note +페어링은 아래의 관리 섹션에만 필요합니다. 위의 실시간 상태와 캐시/LRU 제어는 페어링 없이도 작동합니다. +::: + +### 업스트림 + +노드가 가져오는 업스트림을 확인하고 다른 업스트림으로 설정할 수 있습니다. 변경된 업스트림은 노드가 다음에 시작될 때 적용됩니다. + +### 호스팅되는 스토어 + +노드가 보유하고 고정(pin)하는 스토어를 확인하고, 새 스토어를 고정해(노드가 이를 유지하며 제공하도록) 두거나, 고정을 해제하고, 어떤 스토어든 상태를 확인할 수 있습니다. 특정 버전을 고정하면 미리 가져와 즉시 제공할 수 있는 상태가 됩니다. + +### 동기화 + +인증된 전체 스토어 동기화를 사용할 수 있는지 확인하고, 특정 버전에 대해 동기화를 실행해 노드가 이를 가져와 캐시하도록 할 수 있습니다. + +### 피어 + +노드의 피어 네트워크 상태 — 홈 라우터 뒤에서도 접근 가능하도록 해주는 릴레이(relay) 연결 상태와, 현재 연결된 피어들 — 를 확인할 수 있습니다. + +## 관련 문서 + +- [노드 관리하기](./manage.md) — `control.*` 관리 작업과 브라우저가 이를 구동하는 방식 +- [소비자(consumer)를 노드로 지정하기](./point-a-consumer.md) — 확장 프로그램, 브라우저, CLI가 여러분의 노드를 사용하도록 설정하기 +- [dig-node 설정하기](./configure.md) — 포트, 캐시 상한, 업스트림 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/index.md index 7602204..ee28949 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [dig-node 설정하기](./configure.md) — 포트, 리스너, 캐시 한도, 업스트림 - [원격 origin 셀프 호스팅하기](../rpc/dig-remote.md) — `digstore serve` + dig:// clone/pull/push - [노드 관리하기](./manage.md) — control.* 관리 RPC + My Node UI +- [컨트롤 패널](./control-panel.md) — DIG 확장 프로그램에서 노드를 완전히 운영하기: 실시간 상태, 예약된 캐시 공간(LRU), 그리고 페어링 후에는 업스트림/호스팅 스토어/동기화/피어 - [공개 네트워크 RPC 사용하기](../rpc/public-network-rpc.md) — 노드가 사용하는 dig RPC, 그리고 네트워크에서 노드 운영하기 - [CLI 설치하기](../digstore/cli/install.md) — `digstore` 단독 설치(게시용, 서비스용 아님) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..c74dfb8 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: O painel de controle do dig-node +description: "Gerencie seu dig-node local pelo painel de controle da DIG Chrome extension: espaço de cache .dig reservado e remoção por LRU, origem upstream, repositórios hospedados, sincronização, pares, status ao vivo e o pareamento do token de controle." +keywords: + - painel de controle do dig-node + - cache do dig + - remoção por LRU + - espaço de cache reservado + - pareamento do token de controle + - repositórios hospedados + - sincronização do nó + - pares do nó +tags: + - dig-node + - browser + - dig-rpc +--- + +# O painel de controle do dig-node + +A DIG Chrome extension inclui um **painel de controle** para o seu dig-node local. Nele você vê o status ao vivo do nó, decide quanto espaço em disco reservar para o conteúdo em cache e — depois de uma etapa de pareamento única — gerencia a origem upstream do nó, os repositórios que ele hospeda, sua sincronização e seus pares. O uso diário não exige linha de comando. + +O painel de controle é o equivalente embutido na extensão da tela de gerenciamento de nó do DIG Browser: ele conversa com o nó rodando na sua própria máquina, então tudo permanece local. + +## Como abrir + +1. Abra a extensão. +2. Vá até a aba **Network** (Rede) e escolha **Control** (Controle). (O popup compacto mostra um resumo; use **Abrir painel de controle** para ver cada seção em tela cheia.) + +O painel detecta o nó automaticamente: + +- **Nó em execução** → você vê a tela de gerenciamento. +- **Nenhum nó encontrado** → você vê uma página curta sobre como instalar um. A navegação continua funcionando — as leituras de conteúdo recorrem à rede pública; um nó só é necessário para a tela de gerenciamento abaixo. + +## Status ao vivo + +No topo, um indicador ao vivo mostra se o seu nó está **Conectado**, **Conectando** ou **Desconectado**, junto com seu endereço e versão. Ele se atualiza sozinho — inicie ou pare o nó e o indicador muda em poucos segundos, sem precisar reabrir o painel ou atualizar a página. + +## Reservar espaço em disco para conteúdo em cache (cache e LRU) + +Seu nó mantém um cache local do conteúdo que já buscou, de modo que revisitas sejam instantâneas e você ajude a servir esse conteúdo. O cache tem um **tamanho reservado** — um teto de quanto disco ele pode usar. Quando o cache ultrapassa esse teto, o nó remove automaticamente primeiro os itens **usados há mais tempo** (uma política "LRU"), então o espaço que você reserva nunca é excedido e o conteúdo que você realmente usa permanece em cache. + +Esta seção fica disponível de imediato — não precisa de pareamento. + +**Veja quanto está em uso.** Uma barra mostra o espaço usado em relação ao teto reservado, além de alguns números ao vivo: quantos itens estão em cache, seu tamanho total, quanto foi removido desde que o nó iniciou, e as contagens de acertos/erros de cache. + +**Defina o teto reservado.** Digite um novo tamanho e aplique. O mínimo é **64 MiB**; um valor menor é elevado a esse piso. Reduzir o teto abaixo do que já está em uso dispara a remoção dos itens mais antigos até o uso caber. + +**Revise e remova itens em cache.** A lista de itens em cache mostra cada item com seu tamanho, quando foi usado pela última vez e sua **ordem de remoção** (posição `0` é o próximo item a ser removido). Você pode: + +- **Remover um item** — remover um único item em cache agora. +- **Limpar tudo** — esvaziar o cache por completo. + +Remover itens libera apenas disco local; qualquer coisa que você visite de novo é simplesmente buscada novamente. + +:::tip +Dê ao cache o máximo de espaço que puder em uma máquina de onde você navega com frequência — uma reserva maior significa menos rebuscas e mais conteúdo servido localmente. Em uma máquina com espaço limitado, defina uma reserva menor; o LRU mantém os itens mais úteis e descarta o resto. +::: + +## Gerenciar o nó (requer pareamento) + +As seções restantes alteram a configuração do nó, então exigem sua permissão explícita. Como a extensão roda na sandbox do navegador, ela não consegue ler o arquivo de permissões local do nó diretamente — em vez disso, você faz o **pareamento** uma única vez. O pareamento concede à extensão uma credencial própria, com escopo limitado e revogável; ela nunca expõe a chave mestra do nó, e só pode ser aprovada a partir do computador que roda o nó. + +### Parear a extensão com o seu nó + +1. No painel de controle, escolha **Parear**. A extensão mostra um **código de 6 dígitos** e um id de pareamento. +2. No computador que roda o nó, em um terminal, execute `dig-node pair` para listar as solicitações pendentes (ou diretamente `dig-node pair approve `). +3. Confirme que o código exibido no terminal **corresponde** ao código na extensão, depois aprove. Essa correspondência é sua salvaguarda: garante que você está aprovando *esta* extensão e nenhuma outra. +4. O painel de controle muda automaticamente para o estado pareado. A credencial fica armazenada só na extensão. + +O código de pareamento **expira em poucos minutos**; se o seu expirar antes de você aprová-lo, escolha **Parear** novamente para obter um novo. + +Para deixar de usar a credencial, escolha **Desparear** no painel (isso a esquece localmente). Para revogá-la no próprio nó, execute `dig-node pair revoke ` naquele computador — o painel volta ao estado não pareado na próxima ação. + +:::note +O pareamento só é necessário para as seções de gerenciamento abaixo. O status ao vivo e os controles de cache/LRU acima funcionam sem ele. +::: + +### Origem upstream + +Veja a origem upstream de onde o nó busca conteúdo e defina uma diferente. Uma origem upstream alterada passa a valer na próxima vez que o nó iniciar. + +### Repositórios hospedados + +Veja os repositórios que seu nó mantém e fixa, fixe um novo repositório (para que o nó o mantenha e sirva), desfixe um existente e confira o status de qualquer repositório. Fixar uma versão específica a busca antecipadamente para que fique pronta para servir. + +### Sincronização + +Veja se a sincronização completa autenticada do repositório está disponível e, para uma versão específica, dispare uma sincronização para que o nó a busque e a coloque em cache. + +### Pares + +Veja o status da rede de pares do seu nó — sua conexão com o relay para alcançabilidade atrás de um roteador doméstico, e os pares aos quais está conectado. + +## Relacionados + +- [Gerencie seu nó](./manage.md) — as ações administrativas de `control.*` e como o navegador as conduz +- [Aponte um consumidor para o seu nó](./point-a-consumer.md) — configure a extensão, o navegador ou a CLI para usar o seu nó +- [Configure o dig-node](./configure.md) — portas, o teto de cache e a origem upstream diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/index.md index 5cf1113..a60b8d0 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Você não precisa de um nó. Obtenha o **[DIG Browser ↗](https://github.com/D - [Configure o dig-node](./configure.md) — portas, listeners, limite de cache, upstream - [Auto-hospede uma origem remota](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push via dig:// - [Gerencie seu nó](./manage.md) — os RPCs administrativos control.* e a interface My Node +- [O Painel de Controle](./control-panel.md) — opere seu nó inteiramente pela extensão DIG: status ao vivo, espaço de cache reservado (LRU) e — após o pareamento — upstream/stores hospedados/sincronização/peers - [Usando o RPC da rede pública](../rpc/public-network-rpc.md) — o dig RPC que seu nó fala, e como operar um nó na rede - [Instalando a CLI](../digstore/cli/install.md) — `digstore` sozinho (publicar, não servir) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..31a1bb0 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: Панель управления dig-node +description: "Управляйте локальным dig-node из панели управления DIG Chrome extension: зарезервированное пространство кэша .dig и вытеснение по LRU, вышестоящий узел, размещённые хранилища, синхронизация, пиры, статус в реальном времени и сопряжение управляющего токена." +keywords: + - панель управления dig-node + - кэш dig + - вытеснение LRU + - зарезервированное пространство кэша + - сопряжение управляющего токена + - размещённые хранилища + - синхронизация узла + - пиры узла +tags: + - dig-node + - browser + - dig-rpc +--- + +# Панель управления dig-node + +В DIG Chrome extension встроена **панель управления** для вашего локального dig-node. С её помощью вы можете видеть текущий статус узла, решать, сколько дискового пространства зарезервировать под кэшированный контент, а после однократного сопряжения — управлять вышестоящим узлом (upstream), хранилищами, которые узел раздаёт, его синхронизацией и пирами. Для повседневного использования командная строка не требуется. + +Панель управления — это встроенный в расширение аналог экрана управления узлом в DIG Browser: она общается с узлом, работающим на вашей собственной машине, поэтому всё остаётся локальным. + +## Открыть панель + +1. Откройте расширение. +2. Перейдите на вкладку **Network** (Сеть) и выберите **Control** (Управление). (В компактном всплывающем окне показана только сводка; чтобы увидеть каждый раздел на весь экран, используйте **Открыть панель управления**.) + +Панель автоматически определяет узел: + +- **Узел запущен** → отображается экран управления. +- **Узел не найден** → отображается короткая страница с инструкцией по установке узла. Просмотр контента по-прежнему работает — чтение контента переключается на публичную сеть; узел нужен только для экрана управления, описанного ниже. + +## Статус в реальном времени + +Вверху индикатор в реальном времени показывает, находится ли ваш узел в состоянии **Подключён**, **Подключение** или **Отключён**, вместе с его адресом и версией. Индикатор обновляется автоматически — запустите или остановите узел, и индикатор изменится в течение нескольких секунд, без необходимости заново открывать панель или обновлять страницу. + +## Резервирование дискового пространства под кэшированный контент (кэш и LRU) + +Ваш узел ведёт локальный кэш уже полученного контента, поэтому повторные обращения выполняются мгновенно, а вы помогаете раздавать этот контент. У кэша есть **зарезервированный размер** — предел того, сколько диска он может занять. Когда кэш превышает этот предел, узел автоматически удаляет в первую очередь **наименее недавно использованные** элементы (политика «LRU»), поэтому зарезервированное пространство никогда не превышается, а реально используемый вами контент остаётся в кэше. + +Этот раздел доступен сразу — сопряжение для него не требуется. + +**Посмотреть, сколько занято.** Индикатор показывает занятое пространство относительно зарезервированного предела, а также несколько показателей в реальном времени: сколько элементов кэшировано, их общий размер, сколько было вытеснено с момента запуска узла, а также число попаданий и промахов кэша. + +**Задать зарезервированный предел.** Введите новый размер и примените его. Минимум — **64 MiB**; меньшее значение поднимается до этого порога. Если снизить предел ниже текущего использования, это запустит вытеснение самых старых элементов, пока использование не впишется в новый предел. + +**Просмотр и удаление элементов кэша.** Список кэша показывает каждый элемент с его размером, временем последнего использования и **порядком вытеснения** (позиция `0` — элемент, который будет удалён следующим). Вы можете: + +- **Вытеснить один элемент** — удалить один кэшированный элемент прямо сейчас. +- **Очистить всё** — полностью очистить кэш. + +Удаление элементов освобождает только локальный диск; всё, к чему вы обратитесь снова, будет просто заново загружено. + +:::tip +Выделите под кэш как можно больше места на машине, с которой вы часто просматриваете контент, — чем больше резерв, тем меньше повторных загрузок и тем больше контента раздаётся локально. На машине с ограниченным местом задайте меньший резерв; LRU сохранит самые полезные элементы и отбросит остальные. +::: + +## Управление узлом (требуется сопряжение) + +Остальные разделы изменяют конфигурацию узла, поэтому требуют вашего явного разрешения. Поскольку расширение работает в песочнице браузера, оно не может напрямую читать локальный файл разрешений узла — вместо этого вы один раз выполняете **сопряжение**. Сопряжение выдаёт расширению собственный, ограниченный по правам и отзываемый учётные данные; оно никогда не раскрывает мастер-ключ узла, и подтвердить его можно только с компьютера, на котором работает узел. + +### Сопряжение расширения с вашим узлом + +1. В панели управления выберите **Сопряжение**. Расширение покажет **6-значный код** и идентификатор сопряжения. +2. На компьютере, где работает узел, в терминале выполните `dig-node pair`, чтобы увидеть список ожидающих запросов (или сразу выполните `dig-node pair approve `). +3. Убедитесь, что код, показанный в терминале, **совпадает** с кодом в расширении, и подтвердите. Это совпадение — ваша защита: оно гарантирует, что вы подтверждаете именно *это* расширение и ничего другого. +4. Панель управления автоматически переключится в состояние сопряжения. Учётные данные хранятся только в расширении. + +Код сопряжения **истекает через несколько минут**; если ваш код истёк до того, как вы его подтвердили, выберите **Сопряжение** ещё раз, чтобы получить новый. + +Чтобы прекратить использовать эти учётные данные, выберите в панели **Отменить сопряжение** (это просто забывает их локально). Чтобы отозвать их на самом узле, выполните на этом компьютере `dig-node pair revoke ` — при следующем действии панель вернётся в несопряжённое состояние. + +:::note +Сопряжение нужно только для разделов управления ниже. Статус в реальном времени и элементы управления кэшем/LRU выше работают без него. +::: + +### Вышестоящий узел + +Посмотрите, с какого вышестоящего узла (upstream) ваш узел получает контент, и задайте другой. Изменённый вышестоящий узел вступит в силу при следующем запуске узла. + +### Размещённые хранилища + +Смотрите хранилища, которые держит и закрепляет ваш узел, закрепляйте новое хранилище (чтобы узел хранил и раздавал его), открепляйте существующее и проверяйте статус любого хранилища. Закрепление конкретной версии заранее загружает её, чтобы она была готова к раздаче. + +### Синхронизация + +Смотрите, доступна ли аутентифицированная синхронизация всего хранилища целиком, и запускайте синхронизацию для конкретной версии, чтобы узел получил и закэшировал её. + +### Пиры + +Смотрите статус пиринговой сети вашего узла — его соединение с релеем для доступности из-за домашнего маршрутизатора и пиры, с которыми он соединён. + +## Смотрите также + +- [Управление узлом](./manage.md) — административные действия `control.*` и то, как их выполняет браузер +- [Направить клиента на ваш узел](./point-a-consumer.md) — настройка расширения, браузера или CLI на использование вашего узла +- [Настройка dig-node](./configure.md) — порты, предел кэша и вышестоящий узел diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/index.md index 55f54fc..36cfb54 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [Настройка dig-node](./configure.md) — порты, слушатели, лимит кэша, upstream - [Самостоятельный хостинг удалённого источника](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push через dig:// - [Управление вашим узлом](./manage.md) — административные RPC `control.*` и интерфейс My Node +- [Панель управления](./control-panel.md) — управляйте узлом целиком из расширения DIG: статус в реальном времени, зарезервированное место в кэше (LRU) и — после сопряжения — upstream/размещённые хранилища/синхронизация/пиры - [Использование публичного сетевого RPC](../rpc/public-network-rpc.md) — dig RPC, на котором говорит ваш узел, и эксплуатация узла в сети - [Установка CLI](../digstore/cli/install.md) — `digstore` отдельно (публикация, а не обслуживание) diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..dc273ca --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node Kontrol Paneli +description: "DIG Chrome extension'ın Kontrol Paneli'nden yerel dig-node'unuzu yönetin: ayrılmış .dig önbellek alanı ve LRU tahliyesi, üst kaynak, barındırılan depolar, senkronizasyon, eşler, canlı durum ve kontrol jetonu eşleştirmesi." +keywords: + - dig-node kontrol paneli + - dig önbelleği + - LRU tahliyesi + - ayrılmış önbellek alanı + - kontrol jetonu eşleştirmesi + - barındırılan depolar + - düğüm senkronizasyonu + - düğüm eşleri +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node Kontrol Paneli + +DIG Chrome extension, yerel dig-node'unuz için bir **Kontrol Paneli** içerir. Buradan düğümün canlı durumunu görebilir, önbelleğe alınan içerik için ne kadar disk alanı ayıracağınıza karar verebilir ve — tek seferlik bir eşleştirme adımından sonra — düğümün üst kaynağını, barındırdığı depoları, senkronizasyonunu ve eşlerini yönetebilirsiniz. Günlük kullanım için komut satırına gerek yoktur. + +Kontrol Paneli, DIG Browser'ın düğüm yönetimi ekranının uzantı içine gömülmüş karşılığıdır: kendi makinenizde çalışan düğümle konuşur, bu yüzden her şey yerel kalır. + +## Açma + +1. Uzantıyı açın. +2. **Network** (Ağ) sekmesine gidin ve **Control**'ü (Kontrol) seçin. (Kompakt açılır pencere yalnızca bir özet gösterir; her bölümü tam ekran görmek için **Kontrol panelini aç**'ı kullanın.) + +Panel, düğümü otomatik olarak algılar: + +- **Düğüm çalışıyor** → yönetim görünümünü görürsünüz. +- **Düğüm bulunamadı** → nasıl bir tane kurulacağını anlatan kısa bir sayfa görürsünüz. Tarama yine de normal şekilde çalışır — içerik okumaları genel ağa geri döner; bir düğüm yalnızca aşağıdaki yönetim görünümü için gereklidir. + +## Canlı durum + +Üstte, canlı bir gösterge düğümünüzün **Bağlı**, **Bağlanıyor** veya **Bağlantısı Kesik** olup olmadığını, adresi ve sürümüyle birlikte gösterir. Kendiliğinden güncellenir — düğümü başlatın veya durdurun, gösterge birkaç saniye içinde değişir; paneli yeniden açmanıza veya sayfayı yenilemenize gerek kalmaz. + +## Önbelleğe alınan içerik için disk alanı ayırma (önbellek ve LRU) + +Düğümünüz, getirdiği içeriğin yerel bir önbelleğini tutar; böylece tekrar ziyaretler anında gerçekleşir ve siz de o içeriğin sunulmasına yardımcı olursunuz. Önbelleğin **ayrılmış bir boyutu** vardır — kullanabileceği disk alanının üst sınırı. Önbellek bu sınırı aştığında, düğüm otomatik olarak önce **en uzun süredir kullanılmayan** öğeleri kaldırır ("LRU" politikası); böylece ayırdığınız alan hiçbir zaman aşılmaz ve gerçekten kullandığınız içerik önbellekte kalmaya devam eder. + +Bu bölüm hemen kullanılabilir — eşleştirme gerektirmez. + +**Ne kadar kullanıldığını görün.** Bir çubuk, kullanılan alanı ayrılmış üst sınıra göre gösterir; ayrıca birkaç canlı rakam da sunar: önbellekte kaç öğe olduğu, toplam boyutları, düğüm başladığından beri ne kadarının tahliye edildiği ve önbellek isabet/ıskalama sayıları. + +**Ayrılmış üst sınırı belirleyin.** Yeni bir boyut girip uygulayın. Minimum **64 MiB**'dir; daha küçük bir değer bu tabana yükseltilir. Üst sınırı mevcut kullanımın altına düşürmek, kullanım sığana kadar en eski öğelerin tahliyesini tetikler. + +**Önbellekteki öğeleri inceleyin ve kaldırın.** Önbellek listesi her öğeyi boyutu, en son ne zaman kullanıldığı ve **tahliye sırası** (`0` konumu bir sonraki kaldırılacak öğedir) ile birlikte gösterir. Şunları yapabilirsiniz: + +- **Tek bir öğeyi tahliye et** — şimdi tek bir önbellek öğesini kaldırın. +- **Tümünü temizle** — önbelleği tamamen boşaltın. + +Öğeleri kaldırmak yalnızca yerel disk alanını serbest bırakır; yeniden ziyaret ettiğiniz her şey basitçe yeniden getirilir. + +:::tip +Sık tarama yaptığınız bir makinede önbelleğe elinizden geldiğince fazla alan verin — daha büyük bir ayırma, daha az yeniden getirme ve yerel olarak sunulan daha fazla içerik anlamına gelir. Alanı kısıtlı bir makinede daha küçük bir ayırma belirleyin; LRU en yararlı öğeleri tutar ve geri kalanını atar. +::: + +## Düğümü yönetme (eşleştirme gerekir) + +Kalan bölümler düğümün yapılandırmasını değiştirir, bu yüzden açık izninizi gerektirir. Uzantı tarayıcının sandbox'ı içinde çalıştığından, düğümün yerel izin dosyasını doğrudan okuyamaz — bunun yerine bir kez **eşleştirme** yaparsınız. Eşleştirme, uzantıya kapsamı sınırlı ve iptal edilebilir kendi kimlik bilgisini verir; düğümün ana anahtarını asla açığa çıkarmaz ve yalnızca düğümü çalıştıran bilgisayardan onaylanabilir. + +### Uzantıyı düğümünüzle eşleştirme + +1. Kontrol Panelinde **Eşleştir**'i seçin. Uzantı bir **6 haneli kod** ve bir eşleştirme kimliği gösterir. +2. Düğümü çalıştıran bilgisayarda, bir terminalde, bekleyen istekleri listelemek için `dig-node pair` komutunu çalıştırın (veya doğrudan `dig-node pair approve ` komutunu çalıştırın). +3. Terminalde gösterilen kodun uzantıdaki kodla **eşleştiğini** doğrulayın, ardından onaylayın. Bu eşleşme sizin güvenceniz: onayladığınızın *tam olarak bu* uzantı olduğunu ve başka hiçbir şey olmadığını garanti eder. +4. Kontrol Paneli otomatik olarak eşleştirilmiş duruma geçer. Kimlik bilgisi yalnızca uzantı tarafından saklanır. + +Eşleştirme kodunun **süresi birkaç dakika içinde dolar**; onaylamadan önce süresi dolarsa, yeni bir kod için tekrar **Eşleştir**'i seçin. + +Kimlik bilgisini kullanmayı bırakmak için panelde **Eşleştirmeyi Kaldır**'ı seçin (bu, onu yalnızca yerel olarak unutur). Onu düğümün kendisinde iptal etmek için o bilgisayarda `dig-node pair revoke ` komutunu çalıştırın — panel, bir sonraki işleminde eşleştirilmemiş duruma döner. + +:::note +Eşleştirme yalnızca aşağıdaki yönetim bölümleri için gereklidir. Yukarıdaki canlı durum ve önbellek/LRU kontrolleri onsuz da çalışır. +::: + +### Üst kaynak + +Düğümün içerik getirdiği üst kaynağı görüntüleyin ve farklı bir tane belirleyin. Değiştirilen bir üst kaynak, düğüm bir sonraki başlatıldığında etkili olur. + +### Barındırılan depolar + +Düğümünüzün tuttuğu ve sabitlediği depoları görün, yeni bir depoyu sabitleyin (böylece düğüm onu tutar ve sunar), birini sabitlemeyi kaldırın ve herhangi bir deponun durumunu kontrol edin. Belirli bir sürümü sabitlemek, sunulmaya hazır olması için onu önceden getirir. + +### Senkronizasyon + +Kimlik doğrulamalı, depo genelinde senkronizasyonun kullanılabilir olup olmadığını görün ve belirli bir sürüm için düğümün onu getirip önbelleğe almasını sağlayacak bir senkronizasyon başlatın. + +### Eşler + +Düğümünüzün eş ağı durumunu görün — bir ev yönlendiricisinin arkasında ulaşılabilirlik için rölesine bağlantısını ve bağlı olduğu eşleri. + +## İlgili + +- [Düğümünüzü yönetin](./manage.md) — `control.*` yönetici eylemleri ve tarayıcının bunları nasıl yürüttüğü +- [Bir tüketiciyi düğümünüze yönlendirin](./point-a-consumer.md) — uzantıyı, tarayıcıyı veya CLI'yi düğümünüzü kullanacak şekilde ayarlayın +- [dig-node'u yapılandırın](./configure.md) — portlar, önbellek üst sınırı ve üst kaynak diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/index.md index 9689aed..33958d7 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Bir düğüme ihtiyacınız yok. **[DIG Browser'ı ↗](https://github.com/DIG-N - [dig-node'u yapılandırın](./configure.md) — bağlantı noktaları, dinleyiciler, önbellek sınırı, yukarı akış - [Uzak bir kaynağı kendiniz barındırın](../rpc/dig-remote.md) — `digstore serve` + dig:// clone/pull/push - [Düğümünüzü yönetin](./manage.md) — control.* yönetim RPC'leri + Düğümüm arayüzü +- [Kontrol Paneli](./control-panel.md) — düğümünüzü tamamen DIG uzantısından yönetin: canlı durum, ayrılmış önbellek alanı (LRU) ve — eşleştirmeden sonra — yukarı akış/barındırılan depolar/senkronizasyon/eşler - [Genel ağ RPC'sini kullanma](../rpc/public-network-rpc.md) — düğümünüzün konuştuğu dig RPC ve ağda bir düğüm işletme - [CLI'yı kurma](../digstore/cli/install.md) — kendi başına `digstore` (yayınlama, sunma değil) diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..e380a4e --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: Bảng điều khiển dig-node +description: "Quản lý dig-node cục bộ của bạn từ Bảng điều khiển của DIG Chrome extension: dung lượng bộ nhớ đệm .dig được dự trữ và loại bỏ theo LRU, thượng nguồn, kho lưu trữ được host, đồng bộ hóa, peer, trạng thái trực tiếp, và ghép nối token điều khiển." +keywords: + - bảng điều khiển dig-node + - bộ nhớ đệm dig + - loại bỏ theo LRU + - dung lượng bộ nhớ đệm dự trữ + - ghép nối token điều khiển + - kho lưu trữ được host + - đồng bộ hóa node + - peer của node +tags: + - dig-node + - browser + - dig-rpc +--- + +# Bảng điều khiển dig-node + +DIG Chrome extension bao gồm một **Bảng điều khiển** cho dig-node cục bộ của bạn. Từ đó bạn có thể xem trạng thái trực tiếp của node, quyết định dành bao nhiêu dung lượng đĩa cho nội dung được lưu trong bộ nhớ đệm, và — sau một bước ghép nối chỉ cần làm một lần — quản lý thượng nguồn của node, các kho lưu trữ mà nó host, việc đồng bộ hóa và các peer của nó. Việc sử dụng hằng ngày không cần đến dòng lệnh. + +Bảng điều khiển là phiên bản tích hợp sẵn trong tiện ích mở rộng, tương đương với màn hình quản lý node của DIG Browser: nó giao tiếp với node đang chạy trên chính máy của bạn, nên mọi thứ đều ở lại cục bộ. + +## Mở bảng điều khiển + +1. Mở tiện ích mở rộng. +2. Vào tab **Network** (Mạng) và chọn **Control** (Điều khiển). (Cửa sổ popup thu gọn chỉ hiện bản tóm tắt; dùng **Mở bảng điều khiển** để xem từng phần ở chế độ toàn màn hình.) + +Bảng điều khiển tự động phát hiện node: + +- **Node đang chạy** → bạn sẽ thấy màn hình quản lý. +- **Không tìm thấy node nào** → bạn sẽ thấy một trang ngắn hướng dẫn cách cài đặt node. Việc duyệt web vẫn hoạt động bình thường — các lượt đọc nội dung sẽ chuyển về dùng mạng công cộng; node chỉ cần thiết cho màn hình quản lý bên dưới. + +## Trạng thái trực tiếp + +Ở trên cùng, một chỉ báo trực tiếp cho biết node của bạn đang ở trạng thái **Đã kết nối**, **Đang kết nối** hay **Đã ngắt kết nối**, cùng với địa chỉ và phiên bản của nó. Chỉ báo này tự cập nhật — khởi động hoặc dừng node, và chỉ báo sẽ thay đổi trong vài giây, không cần mở lại bảng điều khiển hay tải lại trang. + +## Dự trữ dung lượng đĩa cho nội dung được lưu trong bộ nhớ đệm (bộ nhớ đệm và LRU) + +Node của bạn giữ một bộ nhớ đệm cục bộ cho nội dung mà nó đã lấy về, để những lần truy cập lại là tức thì và bạn cũng góp phần phục vụ nội dung đó. Bộ nhớ đệm có một **dung lượng dự trữ** — mức trần cho lượng đĩa mà nó được phép dùng. Khi bộ nhớ đệm vượt quá mức trần này, node sẽ tự động loại bỏ trước tiên các mục **ít được dùng gần đây nhất** (chính sách "LRU"), nhờ đó dung lượng bạn dự trữ không bao giờ bị vượt quá, còn nội dung bạn thực sự dùng thì vẫn được giữ trong bộ nhớ đệm. + +Phần này khả dụng ngay lập tức — không cần ghép nối. + +**Xem lượng đã dùng.** Một thanh sẽ hiển thị dung lượng đã dùng so với mức trần dự trữ, cùng vài con số trực tiếp khác: có bao nhiêu mục trong bộ nhớ đệm, tổng dung lượng của chúng, đã loại bỏ bao nhiêu kể từ khi node khởi động, và số lần trúng/trượt bộ nhớ đệm. + +**Đặt mức trần dự trữ.** Nhập một dung lượng mới và áp dụng. Mức tối thiểu là **64 MiB**; giá trị nhỏ hơn sẽ được nâng lên mức sàn này. Hạ mức trần xuống thấp hơn lượng đang dùng sẽ kích hoạt việc loại bỏ các mục cũ nhất cho đến khi lượng dùng vừa khít. + +**Xem lại và xóa các mục trong bộ nhớ đệm.** Danh sách các mục trong bộ nhớ đệm hiển thị dung lượng, thời điểm dùng lần cuối, và **thứ tự loại bỏ** của từng mục (vị trí `0` là mục sẽ bị xóa tiếp theo). Bạn có thể: + +- **Loại bỏ một mục** — xóa ngay một mục trong bộ nhớ đệm. +- **Xóa tất cả** — làm trống toàn bộ bộ nhớ đệm. + +Xóa các mục chỉ giải phóng đĩa cục bộ; bất cứ thứ gì bạn truy cập lại đều đơn giản là được lấy về lại. + +:::tip +Hãy dành cho bộ nhớ đệm càng nhiều dung lượng càng tốt trên một máy mà bạn thường xuyên duyệt web — mức dự trữ lớn hơn nghĩa là ít phải lấy lại nội dung hơn và nhiều nội dung được phục vụ cục bộ hơn. Trên một máy có dung lượng hạn chế, hãy đặt mức dự trữ nhỏ hơn; LRU sẽ giữ lại các mục hữu ích nhất và loại bỏ phần còn lại. +::: + +## Quản lý node (cần ghép nối) + +Các phần còn lại thay đổi cấu hình của node, vì vậy chúng cần sự cho phép rõ ràng từ bạn. Vì tiện ích mở rộng chạy trong sandbox của trình duyệt, nó không thể đọc trực tiếp tệp quyền cục bộ của node — thay vào đó bạn **ghép nối** nó một lần. Việc ghép nối cấp cho tiện ích mở rộng một thông tin xác thực riêng, có phạm vi giới hạn và có thể thu hồi; nó không bao giờ để lộ khóa chủ của node, và chỉ có thể được phê duyệt từ chính máy tính đang chạy node. + +### Ghép nối tiện ích mở rộng với node của bạn + +1. Trong Bảng điều khiển, chọn **Ghép nối**. Tiện ích mở rộng sẽ hiện một **mã 6 chữ số** và một id ghép nối. +2. Trên máy tính đang chạy node, trong một terminal, chạy `dig-node pair` để liệt kê các yêu cầu đang chờ (hoặc chạy trực tiếp `dig-node pair approve `). +3. Xác nhận mã hiển thị trong terminal **khớp** với mã trong tiện ích mở rộng, rồi phê duyệt. Sự khớp này chính là biện pháp bảo vệ của bạn: nó đảm bảo bạn đang phê duyệt *đúng* tiện ích mở rộng này và không phải cái nào khác. +4. Bảng điều khiển tự động chuyển sang trạng thái đã ghép nối. Thông tin xác thực chỉ được lưu bởi tiện ích mở rộng. + +Mã ghép nối sẽ **hết hạn sau vài phút**; nếu mã của bạn hết hạn trước khi được phê duyệt, hãy chọn **Ghép nối** lại để lấy mã mới. + +Để ngừng dùng thông tin xác thực đó, chọn **Hủy ghép nối** trong bảng điều khiển (thao tác này chỉ quên nó ở phía cục bộ). Để thu hồi nó ngay trên node, chạy `dig-node pair revoke ` trên máy tính đó — bảng điều khiển sẽ quay về trạng thái chưa ghép nối ở lần thao tác tiếp theo. + +:::note +Ghép nối chỉ cần thiết cho các phần quản lý bên dưới. Trạng thái trực tiếp và các điều khiển bộ nhớ đệm/LRU ở trên vẫn hoạt động mà không cần nó. +::: + +### Thượng nguồn + +Xem thượng nguồn mà node đang lấy nội dung về, và đặt một thượng nguồn khác. Thượng nguồn đã thay đổi sẽ có hiệu lực vào lần khởi động tiếp theo của node. + +### Kho lưu trữ được host + +Xem các kho lưu trữ mà node của bạn đang giữ và ghim, ghim một kho lưu trữ mới (để node giữ và phục vụ nó), bỏ ghim một kho lưu trữ, và kiểm tra trạng thái của bất kỳ kho lưu trữ nào. Ghim một phiên bản cụ thể sẽ lấy trước phiên bản đó để nó sẵn sàng phục vụ. + +### Đồng bộ hóa + +Xem liệu việc đồng bộ hóa toàn bộ kho lưu trữ có xác thực có khả dụng hay không, và với một phiên bản cụ thể, kích hoạt một lần đồng bộ hóa để node lấy về và lưu vào bộ nhớ đệm. + +### Peer + +Xem trạng thái mạng peer của node bạn — kết nối của nó tới relay để có thể được tiếp cận khi ở sau một router gia đình, và các peer mà nó đang kết nối tới. + +## Liên quan + +- [Quản lý node của bạn](./manage.md) — các thao tác quản trị `control.*` và cách trình duyệt điều khiển chúng +- [Trỏ một consumer tới node của bạn](./point-a-consumer.md) — thiết lập tiện ích mở rộng, trình duyệt, hoặc CLI để dùng node của bạn +- [Cấu hình dig-node](./configure.md) — cổng, mức trần bộ nhớ đệm, và thượng nguồn diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/index.md index 3269955..d6cb137 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ Bạn không cần một node. Lấy **[DIG Browser ↗](https://github.com/DIG- - [Cấu hình dig-node](./configure.md) — cổng, listener, giới hạn bộ nhớ đệm, upstream - [Tự lưu trữ một nguồn gốc từ xa](../rpc/dig-remote.md) — `digstore serve` + clone/pull/push qua dig:// - [Quản lý node của bạn](./manage.md) — các RPC quản trị control.* + giao diện My Node +- [Bảng điều khiển](./control-panel.md) — vận hành toàn bộ node của bạn từ tiện ích mở rộng DIG: trạng thái trực tiếp, dung lượng bộ nhớ đệm dành riêng (LRU), và — sau khi ghép nối — upstream/kho lưu trữ được lưu trữ/đồng bộ/peer - [Sử dụng RPC mạng công khai](../rpc/public-network-rpc.md) — dig RPC mà node của bạn nói, và vận hành một node trên mạng lưới - [Cài đặt CLI](../digstore/cli/install.md) — `digstore` một mình (xuất bản, không phải phục vụ) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..655e65f --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node 控制面板 +description: "通过 DIG Chrome extension 的控制面板管理本地 dig-node:预留的 .dig 缓存空间与 LRU 淘汰、上游、托管的存储库、同步、对等节点、实时状态,以及配对控制令牌。" +keywords: + - dig-node 控制面板 + - dig 缓存 + - LRU 淘汰 + - 预留缓存空间 + - 控制令牌配对 + - 托管存储库 + - 节点同步 + - 节点对等 +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node 控制面板 + +DIG Chrome extension 内置了一个用于管理本地 dig-node 的**控制面板**。通过它,你可以查看节点的实时状态、决定为缓存内容预留多少磁盘空间,并且——完成一次性配对步骤后——管理节点的上游、其托管的存储库、同步状态以及对等节点。日常使用无需命令行。 + +控制面板是 DIG Browser 节点管理界面在扩展程序中的内置对应功能:它与运行在你自己机器上的节点通信,因此一切都保留在本地。 + +## 打开它 + +1. 打开扩展程序。 +2. 进入 **Network**(网络)标签页,选择 **Control**(控制)。(紧凑弹出窗口只显示摘要;使用**打开控制面板**可查看每个部分的全屏视图。) + +面板会自动检测节点: + +- **节点正在运行** → 你会看到管理视图。 +- **未找到节点** → 你会看到一个关于如何安装节点的简短页面。浏览功能仍可正常使用——内容读取会回退到公共网络;只有管理视图才需要节点。 + +## 实时状态 + +顶部的实时指示器会显示你的节点处于**已连接**、**正在连接**还是**已断开**状态,并显示其地址和版本。它会自动更新——启动或停止节点后,指示器会在几秒内翻转,无需重新打开面板或刷新页面。 + +## 为缓存内容预留磁盘空间(缓存与 LRU) + +你的节点会在本地缓存已获取的内容,这样重复访问会更快,同时你也在帮助分发这些内容。缓存有一个**预留大小**——即它可以使用的磁盘空间上限。当缓存超过该上限时,节点会自动优先移除**最近最少使用**的项目("LRU" 策略),因此你预留的空间永远不会被超出,而你实际使用的内容会持续保留在缓存中。 + +此部分无需配对即可立即使用。 + +**查看已用空间。** 一个进度条会显示已用空间相对于预留上限的比例,以及若干实时数据:已缓存的项目数量、它们的总大小、自节点启动以来已淘汰的量,以及缓存命中/未命中次数。 + +**设置预留上限。** 输入新的大小并应用。最小值为 **64 MiB**;更小的值会被提升到该下限。将上限降低到低于当前已用空间时,会触发淘汰最旧的项目,直到用量符合要求为止。 + +**查看并移除缓存项目。** 缓存列表会显示每个项目的大小、上次使用时间及其**淘汰顺序**(位置 `0` 表示下一个将被移除的项目)。你可以: + +- **淘汰单个项目** — 立即移除单个缓存项目。 +- **清空全部** — 清空整个缓存。 + +移除项目只会释放本地磁盘空间;你再次访问的任何内容都会被重新获取。 + +:::tip +如果这是一台你经常用来浏览的机器,请为缓存分配尽可能多的空间——更大的预留空间意味着更少的重新获取,以及更多内容在本地提供服务。在空间有限的机器上,设置较小的预留值;LRU 会保留最有用的项目并丢弃其余项目。 +::: + +## 管理节点(需要配对) + +其余各部分会更改节点的配置,因此需要你的明确授权。由于扩展程序运行在浏览器的沙盒中,它无法直接读取节点的本地权限文件——因此你需要先**配对**一次。配对会为扩展程序授予其自己的、范围受限且可撤销的凭据;它永远不会暴露节点的主密钥,并且只能在运行该节点的计算机上批准。 + +### 将扩展程序与你的节点配对 + +1. 在控制面板中,选择**配对**。扩展程序会显示一个 **6 位数代码**和一个配对 ID。 +2. 在运行该节点的计算机上的终端里,运行 `dig-node pair` 以列出待处理的请求(或直接运行 `dig-node pair approve `)。 +3. 确认终端中显示的代码与扩展程序中的代码**一致**,然后批准。这种匹配是你的安全保障:它确保你批准的是*这个*扩展程序,而非其他任何东西。 +4. 控制面板会自动切换到已配对状态。该凭据仅由扩展程序存储。 + +配对代码会**在几分钟后过期**;如果你在批准之前代码已过期,请再次选择**配对**以获取新代码。 + +要停止使用该凭据,请在面板中选择**取消配对**(这只会在本地忘记它)。要在节点本身上撤销它,请在该计算机上运行 `dig-node pair revoke `——面板会在下一次操作时返回到未配对状态。 + +:::note +配对仅是下面管理部分所需要的。上面的实时状态与缓存/LRU 控制无需配对即可使用。 +::: + +### 上游 + +查看节点获取内容所用的上游,并可设置不同的上游。更改后的上游会在节点下次启动时生效。 + +### 托管的存储库 + +查看你的节点持有并固定的存储库,固定一个新的存储库(让节点保留并提供服务)、取消固定某个存储库,并检查任意存储库的状态。固定特定版本会预先获取它,以便随时可以提供服务。 + +### 同步 + +查看是否可以进行经过身份验证的整库同步,并针对特定版本触发同步,使节点获取并缓存它。 + +### 对等节点 + +查看你节点的对等网络状态——它与中继的连接情况(用于在家庭路由器背后实现可达性),以及它当前连接的对等节点。 + +## 相关内容 + +- [管理你的节点](./manage.md) — `control.*` 管理操作以及浏览器如何驱动它们 +- [将客户端指向你的节点](./point-a-consumer.md) — 设置扩展程序、浏览器或 CLI 以使用你的节点 +- [配置 dig-node](./configure.md) — 端口、缓存上限与上游 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/index.md index 1c0b455..6bcebc9 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [配置 dig-node](./configure.md) —— 端口、监听器、缓存上限、上游节点 - [自托管一个远程源](../rpc/dig-remote.md) —— `digstore serve` + dig:// 的 clone/pull/push - [管理你的节点](./manage.md) —— control.* 管理类 RPC 与 My Node 界面 +- [控制面板](./control-panel.md) —— 完全通过 DIG 扩展运行你的节点：实时状态、预留缓存空间（LRU），配对后还可管理上游/托管仓库/同步/节点 - [使用公共网络 RPC](../rpc/public-network-rpc.md) —— 你的节点所使用的 dig RPC，以及如何在网络上运营一个节点 - [安装 CLI](../digstore/cli/install.md) —— 单独安装 `digstore`（用于发布，而非提供服务） diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md new file mode 100644 index 0000000..4dcdda6 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/control-panel.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 8 +title: dig-node 控制面板 +description: "透過 DIG Chrome extension 的控制面板管理本機 dig-node:保留的 .dig 快取空間與 LRU 淘汰、上游、託管的儲存庫、同步、對等節點、即時狀態,以及配對控制權杖。" +keywords: + - dig-node 控制面板 + - dig 快取 + - LRU 淘汰 + - 保留快取空間 + - 控制權杖配對 + - 託管儲存庫 + - 節點同步 + - 節點對等 +tags: + - dig-node + - browser + - dig-rpc +--- + +# dig-node 控制面板 + +DIG Chrome extension 內建了一個管理本機 dig-node 的**控制面板**。透過它,你可以查看節點的即時狀態、決定要為快取內容保留多少磁碟空間,並且——在完成一次性配對步驟後——管理節點的上游、其託管的儲存庫、同步狀態以及對等節點。日常使用不需要命令列。 + +控制面板是 DIG Browser 節點管理畫面在擴充功能中的內建對應功能:它會與執行在你自己機器上的節點通訊,因此一切都保留在本機。 + +## 開啟它 + +1. 開啟擴充功能。 +2. 前往 **Network**(網路)分頁,選擇 **Control**(控制)。(精簡彈出視窗僅顯示摘要;使用**開啟控制面板**可檢視每個區塊的全螢幕畫面。) + +面板會自動偵測節點: + +- **節點執行中** → 你會看到管理畫面。 +- **找不到節點** → 你會看到一個說明如何安裝節點的簡短頁面。瀏覽功能仍可正常使用——內容讀取會回退到公共網路;只有管理畫面才需要節點。 + +## 即時狀態 + +頂部的即時指示器會顯示你的節點處於**已連線**、**連線中**還是**已中斷連線**狀態,並顯示其位址與版本。它會自動更新——啟動或停止節點後,指示器會在數秒內翻轉,不需要重新開啟面板或重新整理頁面。 + +## 為快取內容保留磁碟空間(快取與 LRU) + +你的節點會在本機快取已擷取的內容,讓重複造訪更快,同時你也在協助分發這些內容。快取有一個**保留大小**——也就是它可以使用的磁碟空間上限。當快取超過該上限時,節點會自動優先移除**最近最少使用**的項目(「LRU」策略),因此你保留的空間永遠不會被超出,而你實際使用的內容會持續留在快取中。 + +此區塊不需要配對即可立即使用。 + +**查看已用空間。** 一個進度條會顯示已用空間相對於保留上限的比例,以及幾項即時數據:已快取的項目數量、其總大小、自節點啟動以來已淘汰的量,以及快取命中/未命中次數。 + +**設定保留上限。** 輸入新的大小並套用。最小值為 **64 MiB**;較小的值會被提升到該下限。將上限降低到低於目前用量時,會觸發淘汰最舊的項目,直到用量符合要求為止。 + +**檢視並移除快取項目。** 快取清單會顯示每個項目的大小、上次使用時間及其**淘汰順序**(位置 `0` 表示下一個會被移除的項目)。你可以: + +- **淘汰單一項目** — 立即移除單一快取項目。 +- **全部清除** — 清空整個快取。 + +移除項目只會釋放本機磁碟空間;你再次造訪的任何內容都會被重新擷取。 + +:::tip +如果這是一台你經常用來瀏覽的機器,請為快取分配盡可能多的空間——較大的保留空間代表較少的重新擷取,以及更多內容在本機提供服務。在空間有限的機器上,設定較小的保留值;LRU 會保留最有用的項目並捨棄其餘項目。 +::: + +## 管理節點(需要配對) + +其餘各區塊會變更節點的設定,因此需要你的明確授權。由於擴充功能是在瀏覽器的沙盒中執行,它無法直接讀取節點的本機權限檔案——因此你需要先**配對**一次。配對會授予擴充功能它自己的、範圍受限且可撤銷的憑證;它永遠不會揭露節點的主金鑰,並且只能在執行該節點的電腦上核准。 + +### 將擴充功能與你的節點配對 + +1. 在控制面板中,選擇**配對**。擴充功能會顯示一組 **6 位數代碼**與一個配對 ID。 +2. 在執行該節點的電腦上開啟終端機,執行 `dig-node pair` 以列出待處理的請求(或直接執行 `dig-node pair approve `)。 +3. 確認終端機中顯示的代碼與擴充功能中的代碼**相符**,然後核准。這項比對是你的安全保障:它確保你核准的是*這個*擴充功能,而非其他任何東西。 +4. 控制面板會自動切換到已配對狀態。憑證僅由擴充功能儲存。 + +配對代碼會**在幾分鐘後過期**;若你在核准之前代碼已過期,請再次選擇**配對**以取得新代碼。 + +若要停止使用該憑證,請在面板中選擇**取消配對**(這只會在本機忘記它)。若要在節點本身撤銷它,請在該電腦上執行 `dig-node pair revoke `——面板會在下一次動作時回到未配對狀態。 + +:::note +配對僅是下方管理區塊所需要的。上方的即時狀態與快取/LRU 控制不需要配對即可使用。 +::: + +### 上游 + +檢視節點擷取內容所用的上游,並可設定不同的上游。變更後的上游會在節點下次啟動時生效。 + +### 託管的儲存庫 + +檢視你節點持有並固定的儲存庫,固定一個新的儲存庫(讓節點保留並提供服務)、取消固定某個儲存庫,並檢查任何儲存庫的狀態。固定特定版本會預先擷取它,以便隨時可以提供服務。 + +### 同步 + +檢視是否可以進行已驗證的整庫同步,並針對特定版本觸發同步,使節點擷取並快取它。 + +### 對等節點 + +檢視你節點的對等網路狀態——它與中繼的連線狀況(用於在家用路由器後方達成可達性),以及它目前連線的對等節點。 + +## 相關內容 + +- [管理你的節點](./manage.md) — `control.*` 管理動作,以及瀏覽器如何驅動它們 +- [將用戶端指向你的節點](./point-a-consumer.md) — 設定擴充功能、瀏覽器或 CLI 以使用你的節點 +- [設定 dig-node](./configure.md) — 連接埠、快取上限與上游 diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/index.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/index.md index 2cdfbed..3ad5364 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/index.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/run-a-node/index.md @@ -71,6 +71,7 @@ curl -fsSL https://dig.net/install.sh | sh - [設定 dig-node](./configure.md)——連接埠、監聽器、快取上限、上游來源 - [自行託管遠端來源](../rpc/dig-remote.md)——`digstore serve` 加上 dig:// clone/pull/push - [管理你的節點](./manage.md)——control.* 管理用 RPC 與「我的節點」介面 +- [控制面板](./control-panel.md)——完全透過 DIG 擴充功能執行你的節點：即時狀態、保留快取空間(LRU)，配對後還可管理上游/託管倉庫/同步/節點 - [使用公開網路 RPC](../rpc/public-network-rpc.md)——你的節點所提供的 dig RPC，以及如何在網路上運行一個節點 - [安裝 CLI](../digstore/cli/install.md)——單獨安裝 `digstore`（用於發布，而非提供服務） diff --git a/package.json b/package.json index 7ba8d29..d147eaf 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "docs-dig-net", - "version": "0.3.17", + "version": "0.3.18", "private": true, "scripts": { "docusaurus": "docusaurus", diff --git a/sidebars.ts b/sidebars.ts index 8550388..b85e9dd 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -116,6 +116,7 @@ const sidebars: SidebarsConfig = { 'rpc/dig-remote', 'rpc/conformance', 'run-a-node/manage', + 'run-a-node/control-panel', ], }, { diff --git a/static/knowledge-graph.json b/static/knowledge-graph.json index 1d8ec26..886d41d 100644 --- a/static/knowledge-graph.json +++ b/static/knowledge-graph.json @@ -1051,6 +1051,17 @@ "dig-rpc" ] }, + { + "id": "/docs/run-a-node/control-panel", + "type": "doc", + "title": "The dig-node Control Panel", + "url": "https://docs.dig.net/docs/run-a-node/control-panel", + "tags": [ + "dig-node", + "browser", + "dig-rpc" + ] + }, { "id": "/docs/run-a-node", "type": "doc", @@ -2965,6 +2976,16 @@ "to": "concept:dig-rpc", "type": "part-of" }, + { + "from": "/docs/run-a-node/control-panel", + "to": "concept:browser", + "type": "part-of" + }, + { + "from": "/docs/run-a-node/control-panel", + "to": "concept:dig-rpc", + "type": "part-of" + }, { "from": "/docs/run-a-node", "to": "concept:dig-rpc", @@ -4690,6 +4711,21 @@ "to": "/docs/rpc/conformance", "type": "see-also" }, + { + "from": "/docs/run-a-node/control-panel", + "to": "/docs/run-a-node/manage", + "type": "see-also" + }, + { + "from": "/docs/run-a-node/control-panel", + "to": "/docs/run-a-node/point-a-consumer", + "type": "see-also" + }, + { + "from": "/docs/run-a-node/control-panel", + "to": "/docs/run-a-node/configure", + "type": "see-also" + }, { "from": "/docs/run-a-node", "to": "/docs/run-a-node/apt", @@ -4720,6 +4756,11 @@ "to": "/docs/run-a-node/manage", "type": "see-also" }, + { + "from": "/docs/run-a-node", + "to": "/docs/run-a-node/control-panel", + "type": "see-also" + }, { "from": "/docs/run-a-node", "to": "/docs/rpc/public-network-rpc", @@ -4730,6 +4771,11 @@ "to": "/docs/digstore/cli/install", "type": "see-also" }, + { + "from": "/docs/run-a-node/manage", + "to": "/docs/run-a-node/control-panel", + "type": "see-also" + }, { "from": "/docs/run-a-node/manage", "to": "/docs/run-a-node/configure", diff --git a/static/llms.txt b/static/llms.txt index 977bcd5..8574b29 100644 --- a/static/llms.txt +++ b/static/llms.txt @@ -84,6 +84,7 @@ The docs are organized in two top-level sections: **Using DIG** (one track per a - [Point a consumer at your node](https://docs.dig.net/docs/run-a-node/point-a-consumer): make the DIG Browser/extension read local-first (dig.local→localhost, else rpc.dig.net) and share one .dig cache; every byte is still verified client-side. - [Configure dig-node](https://docs.dig.net/docs/run-a-node/configure): listeners/ports, the cache cap, and the upstream the node blind-fetches from, via config + DIGNODE_* env vars. - [Manage your node](https://docs.dig.net/docs/run-a-node/manage): the control.* admin RPCs (status, cache, peers/upstream) and the DIG Browser My Node UI that drives them — distinct from the public read RPC. +- [The dig-node Control Panel](https://docs.dig.net/docs/run-a-node/control-panel): manage a local dig-node from the DIG Chrome extension — reserved .dig cache space + LRU eviction (view used/cap, set the reserved cap, evict/clear), upstream, hosted stores, sync, peers, live status, and the control-token pairing step. ## Protocol spec (protocol developers — the authoritative protocol reference; implementation is the source of truth) diff --git a/static/openrpc-node.json b/static/openrpc-node.json index 26dee1e..801f778 100644 --- a/static/openrpc-node.json +++ b/static/openrpc-node.json @@ -2,7 +2,7 @@ "openrpc": "1.2.6", "info": { "title": "dig RPC — node profile (local dig-node / in-process DIG Browser)", - "version": "0.3.17", + "version": "0.3.18", "description": "The NODE PROFILE: a distinct, smaller surface than the network profile. Of the byte methods it implements ONLY dig.getContent (local-first, else proxy); everything else proxies upstream or returns -32601. It ADDS node-only methods the security model depends on — chiefly dig.getAnchoredRoot (the CHIP-0035 on-chain head, the trusted root for mandatory root-pinning), dig.stage, and cache.*. Gate on dig.methods rather than assuming one uniform surface. See https://docs.dig.net/docs/protocol/dig-rpc#node-profile.", "license": { "name": "GPL-2.0", diff --git a/static/openrpc.json b/static/openrpc.json index 35ea8ca..50a96ae 100644 --- a/static/openrpc.json +++ b/static/openrpc.json @@ -2,7 +2,7 @@ "openrpc": "1.2.6", "info": { "title": "dig RPC — DIG Network Content Interface (network profile)", - "version": "0.3.17", + "version": "0.3.18", "description": "The network-wide read interface for DIG content over JSON-RPC 2.0 — the NETWORK PROFILE served by the canonical node at rpc.dig.net. Blind by construction (the node holds no URN and no key), verifiable without trust (merkle inclusion proofs against the chain-anchored root), and streamable at any size. There is no `decoy` field on the wire and no CDN. See https://docs.dig.net/docs/protocol/dig-rpc.", "license": { "name": "GPL-2.0",