├── LICENSE ├── README.md ├── de └── README.md ├── es └── README.md ├── fr └── README.md ├── it └── README.md ├── ru └── README.md ├── tr └── README.md └── zh └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2024 codeesura 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # zkSync Era Node Setup Guide 2 | 3 | This guide explains step-by-step how to set up a `zkSync Era` node on Ubuntu Linux. 4 | 5 | ## System Requirements 6 | 7 | - CPU: A relatively modern CPU is recommended. 8 | - RAM: 32 GB 9 | - Storage: 300 GB, with the state growing about 1TB per month. 10 | - Network: 100 Mbps connection (1 Gbps+ recommended) 11 | 12 | ### Server Rental 13 | 14 | If you need a server, you can rent one from Hetzner. Additionally, if you sign up using this referral link, you will receive a 20 EUR credit. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Step 1: Install Visual Studio Code (On Local Computer) 19 | 20 | 1. **Download and Install Visual Studio Code:** 21 | [Visual Studio Code Download Page](https://code.visualstudio.com/) 22 | 23 | - Once downloaded, follow the installation wizard to install Visual Studio Code. 24 | 25 | 2. **Install the SSH Extension:** 26 | - Open Visual Studio Code. 27 | - Click on the `Extensions` icon in the left sidebar. 28 | - Type `Remote - SSH` in the search bar and install the extension developed by Microsoft. 29 | 30 | ## Step 2: Connect to the Server via SSH (From Local Computer) 31 | 32 | 1. **Connect to SSH in Visual Studio Code:** 33 | 34 | - Press `Ctrl+Shift+P` in Visual Studio Code and select `Remote-SSH: Connect to Host...`. 35 | - Enter your server address in the format `ssh root@ip_address`. 36 | - Enter your password or SSH key to complete the connection. 37 | 38 | **Note:** Replace `ip_address` with the actual IP address of your server. 39 | 40 | 2. **Verify the Connection:** 41 | 42 | - If the connection is successful, the name of the connected server will appear in the lower-left corner of the Visual Studio Code window. 43 | 44 | 3. **Open the Terminal:** 45 | - After connecting to the server in Visual Studio Code, you can open the terminal by clicking on `Terminal` > `New Terminal` in the top menu. 46 | - Alternatively, you can open the terminal by pressing `Ctrl+` (Control key and the backtick key, located below the ESC key). 47 | 48 | ## Step 3: Install Docker and Docker Compose (On Server) 49 | 50 | After successfully connecting to the server, execute these commands on the server. 51 | 52 | ### Docker Installation 53 | 54 | 1. **Update System Packages:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Install Docker:** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **Verify Docker Service is Running:** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **Verify Docker Installation:** 73 | 74 | ```sh 75 | docker --version 76 | ``` 77 | 78 | ### Docker Compose Installation 79 | 80 | 1. **Download Docker Compose:** 81 | 82 | ```sh 83 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 84 | ``` 85 | 86 | 2. **Give Execute Permission to Docker Compose:** 87 | 88 | ```sh 89 | sudo chmod +x /usr/local/bin/docker-compose 90 | ``` 91 | 92 | 3. **Verify Installation:** 93 | ```sh 94 | docker-compose --version 95 | ``` 96 | 97 | ## Step 4: Start the zkSync Era Node (On Server) 98 | 99 | 1. **Install Git (if not already installed):** 100 | 101 | ```sh 102 | sudo apt install git 103 | ``` 104 | 105 | 2. **Clone the Repository:** 106 | 107 | ```sh 108 | git clone https://github.com/matter-labs/zksync-era.git 109 | ``` 110 | 111 | 3. **Navigate to the Cloned Directories:** 112 | 113 | ```sh 114 | cd zksync-era/docs/guides/external-node 115 | cd docker-compose-examples 116 | ``` 117 | 118 | 4. **Start the Node Using Docker Compose:** 119 | 120 | ```sh 121 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 122 | ``` 123 | 124 | 5. **Verify Running Containers:** 125 | 126 | ```sh 127 | docker ps 128 | ``` 129 | 130 | This command lists currently running Docker containers. You should see the containers related to the `zkSync Era` node. 131 | 132 | 6. **View and Follow the Last 100 Logs:** 133 | ```sh 134 | docker logs -f --tail 100 docker-compose-examples_external-node_1 135 | ``` 136 | 137 | Press `Ctrl+C` to exit the log view. This will not stop your node; it will continue to run in the background. 138 | 139 | ## Step 5: Access the Dashboard via Port Forwarding (On Local Computer) 140 | 141 | After running Docker, you can access a dashboard on port 3000. To view this dashboard from your local computer, you need to set up port forwarding in Visual Studio Code. 142 | 143 | 1. **Set Up Port Forwarding:** 144 | 145 | - Press `Ctrl+Shift+P` to open the command palette. 146 | - Type `Forward a Port` and select the option. 147 | - Enter `3000` for the port number and press Enter. 148 | 149 | Alternatively: 150 | 151 | - Click on the `PORTS` section in the bottom right corner of Visual Studio Code. 152 | - Select `Forward Port...` from the menu. 153 | - Enter `3000` for the port number and press Enter. 154 | 155 | 2. **Access the Dashboard:** 156 | 157 | - Open your web browser and go to `http://localhost:3000/d/0/external-node`. 158 | - You should now have access to the dashboard. 159 | 160 | This step allows you to easily view the dashboard of the application running on your remote server from your local computer. 161 | 162 | ## Additional Information 163 | 164 | - **View Container Logs:** 165 | 166 | ```sh 167 | docker logs 168 | ``` 169 | 170 | - **Stop the Node:** 171 | ```sh 172 | docker-compose -f mainnet-external-node-docker-compose.yml down 173 | ``` 174 | -------------------------------------------------------------------------------- /de/README.md: -------------------------------------------------------------------------------- 1 | # zkSync Era Node Einrichtungsanleitung 2 | 3 | Diese Anleitung erklärt Schritt für Schritt, wie Sie einen `zkSync Era` Node auf Ubuntu Linux einrichten. 4 | 5 | ## Systemanforderungen 6 | 7 | - CPU: Ein relativ moderner Prozessor wird empfohlen. 8 | - RAM: 32 GB 9 | - Speicher: 300 GB, wobei der Zustand etwa 1 TB pro Monat zunimmt. 10 | - Netzwerk: 100 Mbit/s Verbindung (1 Gbit/s+ empfohlen) 11 | 12 | ### Servermiete 13 | 14 | Falls Sie einen Server benötigen, können Sie einen bei Hetzner mieten. Zusätzlich erhalten Sie einen 20 EUR Guthaben, wenn Sie sich über diesen Empfehlungslink anmelden. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Schritt 1: Visual Studio Code Installation (Auf dem lokalen Computer) 19 | 20 | 1. **Visual Studio Code herunterladen und installieren:** 21 | [Visual Studio Code Download-Seite](https://code.visualstudio.com/) 22 | 23 | - Nach dem Download folgen Sie dem Installationsassistenten, um Visual Studio Code zu installieren. 24 | 25 | 2. **SSH-Erweiterung installieren:** 26 | - Öffnen Sie Visual Studio Code. 27 | - Klicken Sie auf das `Erweiterungen`-Symbol in der linken Seitenleiste. 28 | - Geben Sie `Remote - SSH` in die Suchleiste ein und installieren Sie die von Microsoft entwickelte Erweiterung. 29 | 30 | ## Schritt 2: Verbindung zum Server über SSH (Vom lokalen Computer) 31 | 32 | 1. **Über SSH in Visual Studio Code verbinden:** 33 | 34 | - Drücken Sie `Ctrl+Shift+P` in Visual Studio Code und wählen Sie `Remote-SSH: Connect to Host...`. 35 | - Geben Sie Ihre Serveradresse im Format `ssh root@ip_adresse` ein. 36 | - Geben Sie Ihr Passwort oder Ihren SSH-Schlüssel ein, um die Verbindung abzuschließen. 37 | 38 | **Hinweis:** Ersetzen Sie `ip_adresse` durch die tatsächliche IP-Adresse Ihres Servers. 39 | 40 | 2. **Verbindung bestätigen:** 41 | 42 | - Wenn die Verbindung erfolgreich ist, erscheint der Name des verbundenen Servers in der unteren linken Ecke des Visual Studio Code-Fensters. 43 | 44 | 3. **Terminal öffnen:** 45 | - Nachdem Sie die Verbindung zum Server in Visual Studio Code hergestellt haben, können Sie das Terminal öffnen, indem Sie im oberen Menü auf `Terminal` > `Neues Terminal` klicken. 46 | - Alternativ können Sie das Terminal öffnen, indem Sie `Ctrl+` (Steuerungstaste und die Rückwärtstaste, die sich unter der ESC-Taste befindet) drücken. 47 | 48 | ## Schritt 3: Docker und Docker Compose Installation (Auf dem Server) 49 | 50 | Nachdem die Verbindung zum Server erfolgreich hergestellt wurde, führen Sie diese Befehle auf dem Server aus. 51 | 52 | ### Docker-Installation 53 | 54 | 1. **Systempakete aktualisieren:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Docker installieren:** 61 | ```sh 62 | sudo apt install docker.io 63 | ``` 64 | 3. **Überprüfen, ob der Docker-Dienst läuft:** 65 | 66 | ```sh 67 | sudo systemctl status docker 68 | ``` 69 | 70 | 4. **Docker-Installation überprüfen:** 71 | ```sh 72 | docker --version 73 | ``` 74 | 75 | ### Docker Compose Installation 76 | 77 | 1. **Docker Compose herunterladen:** 78 | ```sh 79 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 80 | ``` 81 | 2. **Ausführungsberechtigung für Docker Compose erteilen:** 82 | 83 | ```sh 84 | sudo chmod +x /usr/local/bin/docker-compose 85 | ``` 86 | 87 | 3. **Installation überprüfen:** 88 | ```sh 89 | docker-compose --version 90 | ``` 91 | 92 | ## Schritt 4: zkSync Era Node starten (Auf dem Server) 93 | 94 | 1. **Git installieren (falls noch nicht installiert):** 95 | 96 | ```sh 97 | sudo apt install git 98 | ``` 99 | 100 | 2. **Repository klonen:** 101 | 102 | ```sh 103 | git clone https://github.com/matter-labs/zksync-era.git 104 | ``` 105 | 106 | 3. **Zu den geklonten Verzeichnissen navigieren:** 107 | 108 | ```sh 109 | cd zksync-era/docs/guides/external-node 110 | cd docker-compose-examples 111 | ``` 112 | 113 | 4. **Node mit Docker Compose starten:** 114 | 115 | ```sh 116 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 117 | ``` 118 | 119 | 5. **Laufende Container überprüfen:** 120 | 121 | ```sh 122 | docker ps 123 | ``` 124 | 125 | Dieser Befehl listet die derzeit laufenden Docker-Container auf. Sie sollten die Container sehen, die zum `zkSync Era` Node gehören. 126 | 127 | 6. **Die letzten 100 Logs anzeigen und folgen:** 128 | ```sh 129 | docker logs -f --tail 100 docker-compose-examples_external-node_1 130 | ``` 131 | Drücken Sie `Ctrl+C`, um die Log-Ansicht zu verlassen. Dies wird Ihren Node nicht stoppen; er läuft weiterhin im Hintergrund. 132 | 133 | ## Schritt 5: Zugriff auf das Dashboard über Portweiterleitung (Auf dem lokalen Computer) 134 | 135 | Nach dem Starten von Docker können Sie auf ein Dashboard auf Port 3000 zugreifen. Um dieses Dashboard von Ihrem lokalen Computer aus anzuzeigen, müssen Sie die Portweiterleitung in Visual Studio Code einrichten. 136 | 137 | 1. **Portweiterleitung einrichten:** 138 | 139 | - Drücken Sie `Ctrl+Shift+P`, um die Befehls-Palette zu öffnen. 140 | - Geben Sie `Forward a Port` ein und wählen Sie die Option. 141 | - Geben Sie `3000` als Portnummer ein und drücken Sie Enter. 142 | 143 | Alternativ: 144 | 145 | - Klicken Sie auf den Abschnitt `PORTS` in der unteren rechten Ecke von Visual Studio Code. 146 | - Wählen Sie im Menü `Forward Port...`. 147 | - Geben Sie `3000` als Portnummer ein und drücken Sie Enter. 148 | 149 | 2. **Zugriff auf das Dashboard:** 150 | 151 | - Öffnen Sie Ihren Webbrowser und gehen Sie zu `http://localhost:3000/d/0/external-node`. 152 | - Sie sollten jetzt Zugriff auf das Dashboard haben. 153 | 154 | Dieser Schritt ermöglicht es Ihnen, das Dashboard der auf Ihrem Remote-Server laufenden Anwendung einfach von Ihrem lokalen Computer aus anzuzeigen. 155 | 156 | ## Zusätzliche Informationen 157 | 158 | - **Container-Logs anzeigen:** 159 | 160 | ```sh 161 | docker logs 162 | ``` 163 | 164 | - **Node stoppen:** 165 | ```sh 166 | docker-compose -f mainnet-external-node-docker-compose.yml down 167 | ``` 168 | -------------------------------------------------------------------------------- /es/README.md: -------------------------------------------------------------------------------- 1 | # Guía de Configuración del Nodo zkSync Era 2 | 3 | Esta guía explica paso a paso cómo configurar un nodo `zkSync Era` en Ubuntu Linux. 4 | 5 | ## Requisitos del Sistema 6 | 7 | - CPU: Se recomienda una CPU relativamente moderna. 8 | - RAM: 32 GB 9 | - Almacenamiento: 300 GB, con un crecimiento del estado de aproximadamente 1 TB por mes. 10 | - Red: Conexión de 100 Mbps (se recomienda 1 Gbps+) 11 | 12 | ### Alquiler de Servidor 13 | 14 | Si necesita un servidor, puede alquilar uno de Hetzner. Además, si se registra utilizando este enlace de referencia, recibirá un crédito de 20 EUR. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Paso 1: Instalación de Visual Studio Code (En el Computador Local) 19 | 20 | 1. **Descargar e Instalar Visual Studio Code:** 21 | [Página de Descarga de Visual Studio Code](https://code.visualstudio.com/) 22 | 23 | - Una vez descargado, siga el asistente de instalación para instalar Visual Studio Code. 24 | 25 | 2. **Instalar la Extensión de SSH:** 26 | - Abra Visual Studio Code. 27 | - Haga clic en el icono de `Extensiones` en la barra lateral izquierda. 28 | - Escriba `Remote - SSH` en la barra de búsqueda e instale la extensión desarrollada por Microsoft. 29 | 30 | ## Paso 2: Conectarse al Servidor vía SSH (Desde el Computador Local) 31 | 32 | 1. **Conectarse a SSH en Visual Studio Code:** 33 | 34 | - Presione `Ctrl+Shift+P` en Visual Studio Code y seleccione `Remote-SSH: Connect to Host...`. 35 | - Ingrese la dirección de su servidor en el formato `ssh root@ip_address`. 36 | - Ingrese su contraseña o clave SSH para completar la conexión. 37 | 38 | **Nota:** Reemplace `ip_address` con la dirección IP real de su servidor. 39 | 40 | 2. **Verificar la Conexión:** 41 | 42 | - Si la conexión es exitosa, el nombre del servidor conectado aparecerá en la esquina inferior izquierda de la ventana de Visual Studio Code. 43 | 44 | 3. **Abrir el Terminal:** 45 | - Después de conectarse al servidor en Visual Studio Code, puede abrir el terminal haciendo clic en `Terminal` > `Nuevo Terminal` en el menú superior. 46 | - Alternativamente, puede abrir el terminal presionando `Ctrl+` (tecla Control y la tecla de comillas invertidas, ubicada debajo de la tecla ESC). 47 | 48 | ## Paso 3: Instalación de Docker y Docker Compose (En el Servidor) 49 | 50 | Después de conectarse con éxito al servidor, ejecute estos comandos en el servidor. 51 | 52 | ### Instalación de Docker 53 | 54 | 1. **Actualizar los Paquetes del Sistema:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Instalar Docker:** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **Verificar que el Servicio de Docker está en Ejecución:** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **Verificar la Instalación de Docker:** 73 | ```sh 74 | docker --version 75 | ``` 76 | 77 | ### Instalación de Docker Compose 78 | 79 | 1. **Descargar Docker Compose:** 80 | 81 | ```sh 82 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 83 | ``` 84 | 85 | 2. **Conceder Permiso de Ejecución a Docker Compose:** 86 | 87 | ```sh 88 | sudo chmod +x /usr/local/bin/docker-compose 89 | ``` 90 | 91 | 3. **Verificar la Instalación:** 92 | ```sh 93 | docker-compose --version 94 | ``` 95 | 96 | ## Paso 4: Iniciar el Nodo zkSync Era (En el Servidor) 97 | 98 | 1. **Instalar Git (si no está instalado):** 99 | 100 | ```sh 101 | sudo apt install git 102 | ``` 103 | 104 | 2. **Clonar el Repositorio:** 105 | 106 | ```sh 107 | git clone https://github.com/matter-labs/zksync-era.git 108 | ``` 109 | 110 | 3. **Navegar a los Directorios Clonados:** 111 | 112 | ```sh 113 | cd zksync-era/docs/guides/external-node 114 | cd docker-compose-examples 115 | ``` 116 | 117 | 4. **Iniciar el Nodo Usando Docker Compose:** 118 | 119 | ```sh 120 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 121 | ``` 122 | 123 | 5. **Verificar los Contenedores en Ejecución:** 124 | 125 | ```sh 126 | docker ps 127 | ``` 128 | 129 | Este comando lista los contenedores Docker que están en ejecución. Debería ver los contenedores relacionados con el nodo `zkSync Era`. 130 | 131 | 6. **Ver y Seguir los Últimos 100 Logs:** 132 | ```sh 133 | docker logs -f --tail 100 docker-compose-examples_external-node_1 134 | ``` 135 | 136 | Presione `Ctrl+C` para salir de la vista de logs. Esto no detendrá su nodo; continuará ejecutándose en segundo plano. 137 | 138 | ## Paso 5: Acceder al Dashboard mediante Reenvío de Puertos (En el Computador Local) 139 | 140 | Después de ejecutar Docker, puede acceder a un dashboard en el puerto 3000. Para ver este dashboard desde su computador local, debe configurar el reenvío de puertos en Visual Studio Code. 141 | 142 | 1. **Configurar el Reenvío de Puertos:** 143 | 144 | - Presione `Ctrl+Shift+P` para abrir la paleta de comandos. 145 | - Escriba `Forward a Port` y seleccione la opción. 146 | - Ingrese `3000` como número de puerto y presione Enter. 147 | 148 | Alternativamente: 149 | 150 | - Haga clic en la sección `PORTS` en la esquina inferior derecha de Visual Studio Code. 151 | - Seleccione `Forward Port...` en el menú. 152 | - Ingrese `3000` como número de puerto y presione Enter. 153 | 154 | 2. **Acceder al Dashboard:** 155 | 156 | - Abra su navegador web y vaya a `http://localhost:3000/d/0/external-node`. 157 | - Ahora debería tener acceso al dashboard. 158 | 159 | Este paso le permite ver fácilmente el dashboard de la aplicación que se ejecuta en su servidor remoto desde su computador local. 160 | 161 | ## Información Adicional 162 | 163 | - **Ver Logs de los Contenedores:** 164 | 165 | ```sh 166 | docker logs 167 | ``` 168 | 169 | - **Detener el Nodo:** 170 | ```sh 171 | docker-compose -f mainnet-external-node-docker-compose.yml down 172 | ``` 173 | -------------------------------------------------------------------------------- /fr/README.md: -------------------------------------------------------------------------------- 1 | # Guide de Configuration du Nœud zkSync Era 2 | 3 | Ce guide explique étape par étape comment configurer un nœud `zkSync Era` sur Ubuntu Linux. 4 | 5 | ## Exigences Système 6 | 7 | - CPU: Un processeur relativement moderne est recommandé. 8 | - RAM: 32 Go 9 | - Stockage: 300 Go, avec une croissance de l'état d'environ 1 To par mois. 10 | - Réseau: Connexion de 100 Mbps (1 Gbps+ recommandé) 11 | 12 | ### Location de Serveur 13 | 14 | Si vous avez besoin d'un serveur, vous pouvez en louer un chez Hetzner. De plus, si vous vous inscrivez en utilisant ce lien de parrainage, vous recevrez un crédit de 20 EUR. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Étape 1: Installation de Visual Studio Code (Sur l'Ordinateur Local) 19 | 20 | 1. **Télécharger et Installer Visual Studio Code:** 21 | [Page de Téléchargement de Visual Studio Code](https://code.visualstudio.com/) 22 | 23 | - Une fois téléchargé, suivez l'assistant d'installation pour installer Visual Studio Code. 24 | 25 | 2. **Installer l'Extension SSH:** 26 | - Ouvrez Visual Studio Code. 27 | - Cliquez sur l'icône des `Extensions` dans la barre latérale gauche. 28 | - Tapez `Remote - SSH` dans la barre de recherche et installez l'extension développée par Microsoft. 29 | 30 | ## Étape 2: Connexion au Serveur via SSH (Depuis l'Ordinateur Local) 31 | 32 | 1. **Se Connecter à SSH dans Visual Studio Code:** 33 | 34 | - Appuyez sur `Ctrl+Shift+P` dans Visual Studio Code et sélectionnez `Remote-SSH: Connect to Host...`. 35 | - Entrez l'adresse de votre serveur au format `ssh root@adresse_ip`. 36 | - Entrez votre mot de passe ou votre clé SSH pour compléter la connexion. 37 | 38 | **Remarque:** Remplacez `adresse_ip` par l'adresse IP réelle de votre serveur. 39 | 40 | 2. **Vérification de la Connexion:** 41 | 42 | - Si la connexion est réussie, le nom du serveur connecté apparaîtra dans le coin inférieur gauche de la fenêtre de Visual Studio Code. 43 | 44 | 3. **Ouvrir le Terminal:** 45 | - Après avoir connecté le serveur dans Visual Studio Code, vous pouvez ouvrir le terminal en cliquant sur `Terminal` > `Nouveau Terminal` dans le menu supérieur. 46 | - Alternativement, vous pouvez ouvrir le terminal en appuyant sur `Ctrl+` (touche Control et la touche backtick, située sous la touche ESC). 47 | 48 | ## Étape 3: Installation de Docker et Docker Compose (Sur le Serveur) 49 | 50 | Après vous être connecté avec succès au serveur, exécutez ces commandes sur le serveur. 51 | 52 | ### Installation de Docker 53 | 54 | 1. **Mettre à Jour les Paquets du Système:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Installer Docker:** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **Vérifier que le Service Docker est en Cours d'Exécution:** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **Vérifier l'Installation de Docker:** 73 | 74 | ```sh 75 | docker --version 76 | ``` 77 | 78 | ### Installation de Docker Compose 79 | 80 | 1. **Télécharger Docker Compose:** 81 | 82 | ```sh 83 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 84 | ``` 85 | 86 | 2. **Accorder la Permission d'Exécution à Docker Compose:** 87 | ```sh 88 | sudo chmod +x /usr/local/bin/docker-compose 89 | ``` 90 | 3. **Vérifier l'Installation:** 91 | ```sh 92 | docker-compose --version 93 | ``` 94 | 95 | ## Étape 4: Démarrer le Nœud zkSync Era (Sur le Serveur) 96 | 97 | 1. **Installer Git (si ce n'est pas déjà fait):** 98 | 99 | ```sh 100 | sudo apt install git 101 | ``` 102 | 103 | 2. **Cloner le Répertoire:** 104 | 105 | ```sh 106 | git clone https://github.com/matter-labs/zksync-era.git 107 | ``` 108 | 109 | 3. **Naviguer vers les Répertoires Clonés:** 110 | 111 | ```sh 112 | cd zksync-era/docs/guides/external-node 113 | cd docker-compose-examples 114 | ``` 115 | 116 | 4. **Démarrer le Nœud en Utilisant Docker Compose:** 117 | 118 | ```sh 119 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 120 | ``` 121 | 122 | 5. **Vérifier les Conteneurs en Cours d'Exécution:** 123 | 124 | ```sh 125 | docker ps 126 | ``` 127 | 128 | Cette commande liste les conteneurs Docker en cours d'exécution. Vous devriez voir les conteneurs liés au nœud `zkSync Era`. 129 | 130 | 6. **Afficher et Suivre les 100 Derniers Journaux:** 131 | ```sh 132 | docker logs -f --tail 100 docker-compose-examples_external-node_1 133 | ``` 134 | 135 | Appuyez sur `Ctrl+C` pour quitter la vue des journaux. Cela n'arrêtera pas votre nœud; il continuera à fonctionner en arrière-plan. 136 | 137 | ## Étape 5: Accéder au Tableau de Bord via le Transfert de Port (Sur l'Ordinateur Local) 138 | 139 | Après avoir exécuté Docker, vous pouvez accéder à un tableau de bord sur le port 3000. Pour visualiser ce tableau de bord depuis votre ordinateur local, vous devez configurer le transfert de port dans Visual Studio Code. 140 | 141 | 1. **Configurer le Transfert de Port:** 142 | 143 | - Appuyez sur `Ctrl+Shift+P` pour ouvrir la palette de commandes. 144 | - Tapez `Forward a Port` et sélectionnez l'option. 145 | - Entrez `3000` comme numéro de port et appuyez sur Entrée. 146 | 147 | Alternativement: 148 | 149 | - Cliquez sur la section `PORTS` dans le coin inférieur droit de Visual Studio Code. 150 | - Sélectionnez `Forward Port...` dans le menu. 151 | - Entrez `3000` comme numéro de port et appuyez sur Entrée. 152 | 153 | 2. **Accéder au Tableau de Bord:** 154 | 155 | - Ouvrez votre navigateur web et allez à `http://localhost:3000/d/0/external-node`. 156 | - Vous devriez maintenant avoir accès au tableau de bord. 157 | 158 | Cette étape vous permet de visualiser facilement le tableau de bord de l'application en cours d'exécution sur votre serveur distant depuis votre ordinateur local. 159 | 160 | ## Informations Supplémentaires 161 | 162 | - **Afficher les Journaux des Conteneurs:** 163 | 164 | ```sh 165 | docker logs 166 | ``` 167 | 168 | - **Arrêter le Nœud:** 169 | ```sh 170 | docker-compose -f mainnet-external-node-docker-compose.yml down 171 | ``` 172 | -------------------------------------------------------------------------------- /it/README.md: -------------------------------------------------------------------------------- 1 | # Guida alla Configurazione del Nodo zkSync Era 2 | 3 | Questa guida spiega passo dopo passo come configurare un nodo `zkSync Era` su Ubuntu Linux. 4 | 5 | ## Requisiti di Sistema 6 | 7 | - CPU: Si consiglia una CPU relativamente moderna. 8 | - RAM: 32 GB 9 | - Archiviazione: 300 GB, con una crescita dello stato di circa 1 TB al mese. 10 | - Rete: Connessione da 100 Mbps (si consiglia 1 Gbps+) 11 | 12 | ### Noleggio del Server 13 | 14 | Se hai bisogno di un server, puoi noleggiarne uno da Hetzner. Inoltre, se ti registri utilizzando questo link di riferimento, riceverai un credito di 20 EUR. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Passaggio 1: Installazione di Visual Studio Code (Sul Computer Locale) 19 | 20 | 1. **Scaricare e Installare Visual Studio Code:** 21 | [Pagina di Download di Visual Studio Code](https://code.visualstudio.com/) 22 | 23 | - Una volta scaricato, segui la procedura guidata di installazione per installare Visual Studio Code. 24 | 25 | 2. **Installare l'Estensione SSH:** 26 | - Apri Visual Studio Code. 27 | - Clicca sull'icona delle `Estensioni` nella barra laterale sinistra. 28 | - Digita `Remote - SSH` nella barra di ricerca e installa l'estensione sviluppata da Microsoft. 29 | 30 | ## Passaggio 2: Connessione al Server tramite SSH (Dal Computer Locale) 31 | 32 | 1. **Connettersi a SSH in Visual Studio Code:** 33 | 34 | - Premi `Ctrl+Shift+P` in Visual Studio Code e seleziona `Remote-SSH: Connect to Host...`. 35 | - Inserisci l'indirizzo del tuo server nel formato `ssh root@indirizzo_ip`. 36 | - Inserisci la tua password o chiave SSH per completare la connessione. 37 | 38 | **Nota:** Sostituisci `indirizzo_ip` con l'indirizzo IP reale del tuo server. 39 | 40 | 2. **Verifica della Connessione:** 41 | 42 | - Se la connessione è riuscita, il nome del server connesso apparirà nell'angolo in basso a sinistra della finestra di Visual Studio Code. 43 | 44 | 3. **Aprire il Terminale:** 45 | - Dopo aver connesso il server in Visual Studio Code, puoi aprire il terminale cliccando su `Terminale` > `Nuovo Terminale` nel menu in alto. 46 | - In alternativa, puoi aprire il terminale premendo `Ctrl+` (tasto Control e il tasto del backtick, situato sotto il tasto ESC). 47 | 48 | ## Passaggio 3: Installazione di Docker e Docker Compose (Sul Server) 49 | 50 | Dopo esserti connesso con successo al server, esegui questi comandi sul server. 51 | 52 | ### Installazione di Docker 53 | 54 | 1. **Aggiornare i Pacchetti di Sistema:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Installare Docker:** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **Verificare che il Servizio Docker sia in Esecuzione:** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **Verificare l'Installazione di Docker:** 73 | ```sh 74 | docker --version 75 | ``` 76 | 77 | ### Installazione di Docker Compose 78 | 79 | 1. **Scaricare Docker Compose:** 80 | 81 | ```sh 82 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 83 | ``` 84 | 85 | 2. **Concedere il Permesso di Esecuzione a Docker Compose:** 86 | ```sh 87 | sudo chmod +x /usr/local/bin/docker-compose 88 | ``` 89 | 3. **Verificare l'Installazione:** 90 | ```sh 91 | docker-compose --version 92 | ``` 93 | 94 | ## Passaggio 4: Avviare il Nodo zkSync Era (Sul Server) 95 | 96 | 1. **Installare Git (se non già installato):** 97 | 98 | ```sh 99 | sudo apt install git 100 | ``` 101 | 102 | 2. **Clonare il Repository:** 103 | 104 | ```sh 105 | git clone https://github.com/matter-labs/zksync-era.git 106 | ``` 107 | 108 | 3. **Navigare nelle Directory Clonate:** 109 | 110 | ```sh 111 | cd zksync-era/docs/guides/external-node 112 | cd docker-compose-examples 113 | ``` 114 | 115 | 4. **Avviare il Nodo Usando Docker Compose:** 116 | 117 | ```sh 118 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 119 | ``` 120 | 121 | 5. **Verificare i Contenitori in Esecuzione:** 122 | 123 | ```sh 124 | docker ps 125 | ``` 126 | 127 | Questo comando elenca i contenitori Docker attualmente in esecuzione. Dovresti vedere i contenitori relativi al nodo `zkSync Era`. 128 | 129 | 6. **Visualizzare e Seguire gli Ultimi 100 Log:** 130 | ```sh 131 | docker logs -f --tail 100 docker-compose-examples_external-node_1 132 | ``` 133 | 134 | Premi `Ctrl+C` per uscire dalla visualizzazione dei log. Questo non fermerà il tuo nodo; continuerà a funzionare in background. 135 | 136 | ## Passaggio 5: Accesso alla Dashboard tramite Forwarding delle Porte (Sul Computer Locale) 137 | 138 | Dopo aver eseguito Docker, puoi accedere a una dashboard sulla porta 3000. Per visualizzare questa dashboard dal tuo computer locale, devi configurare il forwarding delle porte in Visual Studio Code. 139 | 140 | 1. **Configurare il Forwarding delle Porte:** 141 | 142 | - Premi `Ctrl+Shift+P` per aprire la palette dei comandi. 143 | - Digita `Forward a Port` e seleziona l'opzione. 144 | - Inserisci `3000` come numero di porta e premi Invio. 145 | 146 | In alternativa: 147 | 148 | - Clicca sulla sezione `PORTS` nell'angolo in basso a destra di Visual Studio Code. 149 | - Seleziona `Forward Port...` dal menu. 150 | - Inserisci `3000` come numero di porta e premi Invio. 151 | 152 | 2. **Accesso alla Dashboard:** 153 | 154 | - Apri il tuo browser web e vai su `http://localhost:3000/d/0/external-node`. 155 | - Ora dovresti avere accesso alla dashboard. 156 | 157 | Questo passaggio ti permette di visualizzare facilmente la dashboard dell'applicazione in esecuzione sul tuo server remoto dal tuo computer locale. 158 | 159 | ## Informazioni Aggiuntive 160 | 161 | - **Visualizzare i Log dei Contenitori:** 162 | 163 | ```sh 164 | docker logs 165 | ``` 166 | 167 | - **Arrestare il Nodo:** 168 | ```sh 169 | docker-compose -f mainnet-external-node-docker-compose.yml down 170 | ``` 171 | -------------------------------------------------------------------------------- /ru/README.md: -------------------------------------------------------------------------------- 1 | # Руководство по настройке узла zkSync Era 2 | 3 | Это руководство объясняет шаг за шагом, как настроить узел `zkSync Era` на Ubuntu Linux. 4 | 5 | ## Системные требования 6 | 7 | - ЦП: Рекомендуется относительно современный процессор. 8 | - ОЗУ: 32 ГБ 9 | - Хранилище: 300 ГБ, с приростом состояния около 1 ТБ в месяц. 10 | - Сеть: Подключение 100 Мбит/с (рекомендуется 1 Гбит/с и выше) 11 | 12 | ### Аренда Сервера 13 | 14 | Если вам нужен сервер, вы можете арендовать его у Hetzner. Кроме того, если вы зарегистрируетесь по этой реферальной ссылке, вы получите кредит в размере 20 евро. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Шаг 1: Установка Visual Studio Code (на локальном компьютере) 19 | 20 | 1. **Скачать и установить Visual Studio Code:** 21 | [Страница загрузки Visual Studio Code](https://code.visualstudio.com/) 22 | 23 | - После загрузки следуйте мастеру установки для установки Visual Studio Code. 24 | 25 | 2. **Установить расширение SSH:** 26 | - Откройте Visual Studio Code. 27 | - Щелкните на значок `Расширения` на левой боковой панели. 28 | - Введите `Remote - SSH` в строке поиска и установите расширение, разработанное Microsoft. 29 | 30 | ## Шаг 2: Подключение к серверу через SSH (с локального компьютера) 31 | 32 | 1. **Подключение к SSH в Visual Studio Code:** 33 | 34 | - Нажмите `Ctrl+Shift+P` в Visual Studio Code и выберите `Remote-SSH: Connect to Host...`. 35 | - Введите адрес вашего сервера в формате `ssh root@ip_address`. 36 | - Введите ваш пароль или SSH-ключ для завершения подключения. 37 | 38 | **Примечание:** Замените `ip_address` на фактический IP-адрес вашего сервера. 39 | 40 | 2. **Проверка подключения:** 41 | 42 | - Если подключение прошло успешно, имя подключенного сервера появится в нижнем левом углу окна Visual Studio Code. 43 | 44 | 3. **Открытие терминала:** 45 | - После подключения к серверу в Visual Studio Code вы можете открыть терминал, нажав `Терминал` > `Новый терминал` в верхнем меню. 46 | - Либо нажмите `Ctrl+` (клавиша Control и клавиша обратного апострофа, расположенная под клавишей ESC). 47 | 48 | ## Шаг 3: Установка Docker и Docker Compose (на сервере) 49 | 50 | После успешного подключения к серверу выполните следующие команды на сервере. 51 | 52 | ### Установка Docker 53 | 54 | 1. **Обновить системные пакеты:** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **Установить Docker:** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **Проверить, что служба Docker работает:** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **Проверить установку Docker:** 73 | ```sh 74 | docker --version 75 | ``` 76 | 77 | ### Установка Docker Compose 78 | 79 | 1. **Скачать Docker Compose:** 80 | 81 | ```sh 82 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 83 | ``` 84 | 85 | 2. **Предоставить разрешение на выполнение Docker Compose:** 86 | 87 | ```sh 88 | sudo chmod +x /usr/local/bin/docker-compose 89 | ``` 90 | 91 | 3. **Проверить установку:** 92 | ```sh 93 | docker-compose --version 94 | ``` 95 | 96 | ## Шаг 4: Запуск узла zkSync Era (на сервере) 97 | 98 | 1. **Установить Git (если не установлен):** 99 | 100 | ```sh 101 | sudo apt install git 102 | ``` 103 | 104 | 2. **Клонировать репозиторий:** 105 | 106 | ```sh 107 | git clone https://github.com/matter-labs/zksync-era.git 108 | ``` 109 | 110 | 3. **Перейти в клонированные каталоги:** 111 | 112 | ```sh 113 | cd zksync-era/docs/guides/external-node 114 | cd docker-compose-examples 115 | ``` 116 | 117 | 4. **Запустить узел с помощью Docker Compose:** 118 | 119 | ```sh 120 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 121 | ``` 122 | 123 | 5. **Проверить работающие контейнеры:** 124 | 125 | ```sh 126 | docker ps 127 | ``` 128 | 129 | Эта команда выводит список работающих контейнеров Docker. Вы должны увидеть контейнеры, связанные с узлом `zkSync Era`. 130 | 131 | 6. **Просмотр и отслеживание последних 100 журналов:** 132 | ```sh 133 | docker logs -f --tail 100 docker-compose-examples_external-node_1 134 | ``` 135 | Нажмите `Ctrl+C`, чтобы выйти из просмотра журнала. Это не остановит ваш узел; он продолжит работать в фоновом режиме. 136 | 137 | ## Шаг 5: Доступ к панели управления через перенаправление порта (на локальном компьютере) 138 | 139 | После запуска Docker вы можете получить доступ к панели управления на порту 3000. Чтобы просмотреть эту панель управления с вашего локального компьютера, вам необходимо настроить перенаправление порта в Visual Studio Code. 140 | 141 | 1. **Настройка перенаправления порта:** 142 | 143 | - Нажмите `Ctrl+Shift+P`, чтобы открыть палитру команд. 144 | - Введите `Forward a Port` и выберите этот вариант. 145 | - Введите `3000` в качестве номера порта и нажмите Enter. 146 | 147 | Либо: 148 | 149 | - Нажмите на раздел `PORTS` в правом нижнем углу Visual Studio Code. 150 | - Выберите `Forward Port...` в меню. 151 | - Введите `3000` в качестве номера порта и нажмите Enter. 152 | 153 | 2. **Доступ к панели управления:** 154 | 155 | - Откройте веб-браузер и перейдите по адресу `http://localhost:3000/d/0/external-node`. 156 | - Теперь у вас должен быть доступ к панели управления. 157 | 158 | Этот шаг позволяет легко просматривать панель управления работающего на вашем удаленном сервере приложения с вашего локального компьютера. 159 | 160 | ## Дополнительная информация 161 | 162 | - **Просмотр журналов контейнеров:** 163 | 164 | ```sh 165 | docker logs 166 | ``` 167 | 168 | - **Остановить узел:** 169 | ```sh 170 | docker-compose -f mainnet-external-node-docker-compose.yml down 171 | ``` 172 | -------------------------------------------------------------------------------- /tr/README.md: -------------------------------------------------------------------------------- 1 | # zkSync Era Node Kurulum Rehberi 2 | 3 | Bu rehber, Ubuntu Linux üzerinde `zkSync Era` düğümünü nasıl kuracağınızı adım adım açıklamaktadır. 4 | 5 | ## Sistem Gereksinimleri 6 | 7 | - CPU: A relatively modern CPU is recommended. 8 | - RAM: 32 GB 9 | - Storage: 300 GB, with the state growing about 1TB per month. 10 | - Network: 100 Mbps connection (1 Gbps+ recommended) 11 | 12 | ### Sunucu Kiralama 13 | 14 | Eğer bir sunucuya ihtiyacınız varsa, Hetzner üzerinden sunucu kiralayabilirsiniz. Ayrıca, bu referans linkini kullanarak kaydolursanız 20 EUR kredi kazanabilirsiniz. 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## Adım 1: Visual Studio Code Kurulumu (Yerel Bilgisayarda) 19 | 20 | 1. **Visual Studio Code'u İndirin ve Kurun:** 21 | [Visual Studio Code İndirme Sayfası](https://code.visualstudio.com/) 22 | 23 | - İndirme tamamlandığında, kurulum sihirbazını takip ederek Visual Studio Code'u kurun. 24 | 25 | 2. **SSH Eklentisini Kurun:** 26 | - Visual Studio Code'u açın. 27 | - Sol kenar çubuğunda `Extensions` (Uzantılar) sekmesine tıklayın. 28 | - Arama çubuğuna `Remote - SSH` yazın ve Microsoft tarafından geliştirilen uzantıyı kurun. 29 | 30 | ## Adım 2: Sunucuya SSH ile Bağlanma (Yerel Bilgisayardan) 31 | 32 | 1. **Visual Studio Code'da SSH ile Bağlanın:** 33 | - Visual Studio Code'da `Ctrl+Shift+P` tuşlarına basın ve `Remote-SSH: Connect to Host...` seçeneğini seçin. 34 | - Açılan metin kutusuna sunucu adresinizi `ssh root@ip_adresi` formatında girin. 35 | - Şifre veya SSH anahtarınızı girerek bağlantıyı tamamlayın. 36 | 37 | **Not:** `ip_adresi` yerine sunucunuzun gerçek IP adresini yazmalısınız. 38 | 39 | 2. **Bağlantı Doğrulaması:** 40 | - Bağlantı başarılı olursa, Visual Studio Code penceresinin sol alt köşesinde bağlı olduğunuz sunucunun adı görünecektir. 41 | 42 | 43 | 3. **Terminali Açma:** 44 | - Visual Studio Code'da sunucuya bağlandıktan sonra, ekranın üst menüsünde `Terminal` > `New Terminal` seçeneğine tıklayarak terminali açabilirsiniz. 45 | - Alternatif olarak, klavyenizde `Ctrl+` tuşlarına basarak terminali açabilirsiniz (Ctrl ve sola eğik çizgi tuşu, ESC tuşunun hemen altında bulunur). 46 | 47 | ## Adım 3: Docker ve Docker Compose Kurulumu (Sunucuda) 48 | 49 | Sunucuya başarıyla bağlandıktan sonra, bu işlemleri ve kod bloklarını sunucuda çalıştıracağız. 50 | 51 | ### Docker Kurulumu 52 | 53 | 1. **Sistem Paketlerini Güncelleyin:** 54 | ```sh 55 | sudo apt update 56 | ``` 57 | 58 | 2. **Docker'ı Kurun:** 59 | ```sh 60 | sudo apt install docker.io 61 | ``` 62 | 63 | 3. **Docker Servisinin Çalıştığını Doğrulayın:** 64 | ```sh 65 | sudo systemctl status docker 66 | ``` 67 | 68 | 4. **Docker Kurulumunu Doğrulayın:** 69 | ```sh 70 | docker --version 71 | ``` 72 | 73 | ### Docker Compose Kurulumu 74 | 75 | 1. **Docker Compose’u İndirin:** 76 | ```sh 77 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 78 | ``` 79 | 80 | 2. **Docker Compose’a Çalıştırma İzni Verin:** 81 | ```sh 82 | sudo chmod +x /usr/local/bin/docker-compose 83 | ``` 84 | 85 | 3. **Kurulumu Doğrulayın:** 86 | ```sh 87 | docker-compose --version 88 | ``` 89 | 90 | ## Adım 4: zkSync Era Düğümünü Başlatma (Sunucuda) 91 | 92 | 1. **Git'i Yükleyin (Eğer yüklü değilse):** 93 | ```sh 94 | sudo apt install git 95 | ``` 96 | 97 | 2. **Depoyu Klonlayın:** 98 | ```sh 99 | git clone https://github.com/matter-labs/zksync-era.git 100 | ``` 101 | 102 | 3. **Klonlanan Dizinlere Gidin:** 103 | ```sh 104 | cd zksync-era/docs/guides/external-node 105 | cd docker-compose-examples 106 | ``` 107 | 108 | 4. **Docker Compose ile Düğümü Başlatın:** 109 | ```sh 110 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 111 | ``` 112 | 113 | 5. **Konteynerlerin Çalıştığını Doğrulayın:** 114 | ```sh 115 | docker ps 116 | ``` 117 | 118 | Bu komut, şu anda çalışan Docker konteynerlerini listeler. `zkSync Era` düğümüne ait konteynerler listede görünmelidir. 119 | 120 | 6. **Son 100 Log Kaydını Görüntüleyin ve Takip Edin:** 121 | ```sh 122 | docker logs -f --tail 100 docker-compose-examples_external-node_1 123 | ``` 124 | 125 | Loglardan çıkmak için ctrl + c tuşuna basabilirsiniz. Bu işlem, düğümünüzün çalışmasını durdurmaz; düğüm arka planda çalışmaya devam eder. 126 | 127 | ## Adım 5: Dashboard'a Erişim için Port Forwarding (Yerel Bilgisayarda) 128 | 129 | Docker çalıştırdıktan sonra, 3000 portunda bir dashboard'a erişebilirsiniz. Bu dashboard'u yerel bilgisayarınızdan görüntülemek için Visual Studio Code'da port forwarding yapmanız gerekecek. 130 | 131 | 1. **Port Forwarding Yapın:** 132 | 133 | - `Ctrl+Shift+P` tuşlarına basarak komut paletini açın. 134 | - `Forward a Port` yazın ve seçeneği seçin. 135 | - Port numarasını `3000` olarak girin ve Enter tuşuna basın. 136 | 137 | Alternatif olarak: 138 | 139 | - Visual Studio Code'un sağ alt köşesinde bulunan `PORTS` bölümüne tıklayın. 140 | - Açılan menüde `Forward Port...` seçeneğine tıklayın. 141 | - Port numarasını `3000` olarak girin ve Enter tuşuna basın. 142 | 143 | 2. **Dashboard'a Erişim:** 144 | 145 | - Tarayıcınızı açın ve `http://localhost:3000/d/0/external-node` adresine gidin. 146 | - Dashboard'a erişiminiz sağlanmış olacaktır. 147 | 148 | Bu adım, uzaktaki sunucunuzda çalışan uygulamanın dashboard'unu yerel bilgisayarınızdan kolayca görüntülemenizi sağlar. 149 | 150 | ## Ek Bilgiler 151 | 152 | - **Konteynerlerin Loglarını Görmek İçin:** 153 | docker logs 154 | 155 | - **Düğümü Durdurmak İçin:** 156 | docker-compose -f mainnet-external-node-docker-compose.yml down 157 | 158 | -------------------------------------------------------------------------------- /zh/README.md: -------------------------------------------------------------------------------- 1 | # zkSync Era 节点配置指南 2 | 3 | 本指南逐步解释如何在 Ubuntu Linux 上配置 `zkSync Era` 节点。 4 | 5 | ## 系统要求 6 | 7 | - CPU：建议使用相对现代的 CPU。 8 | - 内存：32 GB 9 | - 存储：300 GB，状态增长约为每月 1 TB。 10 | - 网络：100 Mbps 连接（建议 1 Gbps 以上） 11 | 12 | ### 服务器租赁 13 | 14 | 如果您需要服务器，您可以从 Hetzner 租用。此外，如果您使用此推荐链接注册，您将获得 20 欧元的信用额度。 15 | 16 | [Hetzner](https://hetzner.cloud/?ref=fu2umOyLCWhh) 17 | 18 | ## 第一步：安装 Visual Studio Code（在本地计算机上） 19 | 20 | 1. **下载并安装 Visual Studio Code：** 21 | [Visual Studio Code 下载页面](https://code.visualstudio.com/) 22 | 23 | - 下载完成后，按照安装向导安装 Visual Studio Code。 24 | 25 | 2. **安装 SSH 扩展：** 26 | - 打开 Visual Studio Code。 27 | - 点击左侧边栏的 `扩展` 图标。 28 | - 在搜索栏中输入 `Remote - SSH`，然后安装 Microsoft 开发的扩展。 29 | 30 | ## 第二步：通过 SSH 连接到服务器（从本地计算机） 31 | 32 | 1. **在 Visual Studio Code 中连接到 SSH：** 33 | 34 | - 在 Visual Studio Code 中按 `Ctrl+Shift+P`，选择 `Remote-SSH: Connect to Host...`。 35 | - 输入服务器地址，格式为 `ssh root@ip_address`。 36 | - 输入您的密码或 SSH 密钥以完成连接。 37 | 38 | **注意：** 将 `ip_address` 替换为服务器的实际 IP 地址。 39 | 40 | 2. **验证连接：** 41 | 42 | - 如果连接成功，连接的服务器名称将显示在 Visual Studio Code 窗口的左下角。 43 | 44 | 3. **打开终端：** 45 | - 连接到服务器后，可以通过点击顶部菜单的 `终端` > `新终端` 打开终端。 46 | - 或者，可以按 `Ctrl+`（Control 键和位于 ESC 键下方的反引号键）打开终端。 47 | 48 | ## 第三步：安装 Docker 和 Docker Compose（在服务器上） 49 | 50 | 成功连接到服务器后，在服务器上执行这些命令。 51 | 52 | ### 安装 Docker 53 | 54 | 1. **更新系统包：** 55 | 56 | ```sh 57 | sudo apt update 58 | ``` 59 | 60 | 2. **安装 Docker：** 61 | 62 | ```sh 63 | sudo apt install docker.io 64 | ``` 65 | 66 | 3. **验证 Docker 服务正在运行：** 67 | 68 | ```sh 69 | sudo systemctl status docker 70 | ``` 71 | 72 | 4. **验证 Docker 安装：** 73 | ```sh 74 | docker --version 75 | ``` 76 | 77 | ### 安装 Docker Compose 78 | 79 | 1. **下载 Docker Compose：** 80 | 81 | ```sh 82 | sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 83 | ``` 84 | 85 | 2. **授予 Docker Compose 执行权限：** 86 | 87 | ```sh 88 | sudo chmod +x /usr/local/bin/docker-compose 89 | ``` 90 | 91 | 3. **验证安装：** 92 | ```sh 93 | docker-compose --version 94 | ``` 95 | 96 | ## 第四步：启动 zkSync Era 节点（在服务器上） 97 | 98 | 1. **安装 Git（如果尚未安装）：** 99 | 100 | ```sh 101 | sudo apt install git 102 | ``` 103 | 104 | 2. **克隆仓库：** 105 | 106 | ```sh 107 | git clone https://github.com/matter-labs/zksync-era.git 108 | ``` 109 | 110 | 3. **导航到克隆的目录：** 111 | 112 | ```sh 113 | cd zksync-era/docs/guides/external-node 114 | cd docker-compose-examples 115 | ``` 116 | 117 | 4. **使用 Docker Compose 启动节点：** 118 | 119 | ```sh 120 | docker-compose -f mainnet-external-node-docker-compose.yml up -d 121 | ``` 122 | 123 | 5. **验证正在运行的容器：** 124 | 125 | ```sh 126 | docker ps 127 | ``` 128 | 129 | 此命令列出当前正在运行的 Docker 容器。您应该会看到与 `zkSync Era` 节点相关的容器。 130 | 131 | 6. **查看并跟踪最后 100 个日志：** 132 | ```sh 133 | docker logs -f --tail 100 docker-compose-examples_external-node_1 134 | ``` 135 | 136 | 按 `Ctrl+C` 退出日志视图。这不会停止您的节点；它将继续在后台运行。 137 | 138 | ## 第五步：通过端口转发访问仪表板（在本地计算机上） 139 | 140 | 运行 Docker 后，您可以通过端口 3000 访问仪表板。要从本地计算机查看此仪表板，您需要在 Visual Studio Code 中配置端口转发。 141 | 142 | 1. **配置端口转发：** 143 | 144 | - 按 `Ctrl+Shift+P` 打开命令面板。 145 | - 输入 `Forward a Port` 并选择该选项。 146 | - 输入 `3000` 作为端口号并按回车键。 147 | 148 | 或者： 149 | 150 | - 点击 Visual Studio Code 右下角的 `PORTS` 部分。 151 | - 从菜单中选择 `Forward Port...`。 152 | - 输入 `3000` 作为端口号并按回车键。 153 | 154 | 2. **访问仪表板：** 155 | 156 | - 打开您的 Web 浏览器，转到 `http://localhost:3000/d/0/external-node`。 157 | - 您现在应该可以访问仪表板了。 158 | 159 | 此步骤使您可以轻松地从本地计算机查看在远程服务器上运行的应用程序的仪表板。 160 | 161 | ## 其他信息 162 | 163 | - **查看容器日志：** 164 | 165 | ```sh 166 | docker logs 167 | ``` 168 | 169 | - **停止节点：** 170 | ```sh 171 | docker-compose -f mainnet-external-node-docker-compose.yml down 172 | ``` 173 | --------------------------------------------------------------------------------