메인 콘텐츠로 건너뛰기
Change page

자체 이더리움 노드 가동하기

페이지 마지막 업데이트됨: 2026년 2월 26일

myelinated-wackerowm (opens in a new tab)
mnelsonBTm (opens in a new tab)
wackeroww (opens in a new tab)
+19

자체 노드를 실행하면 다양한 이점을 얻고 새로운 가능성을 열며 생태계를 지원하는 데 도움이 됩니다. 이 페이지에서는 자체 노드를 가동하고 이더리움 트랜잭션 검증에 참여하는 방법을 안내합니다.

병합(The Merge) 이후 이더리움 노드를 실행하려면 실행 레이어(EL) 클라이언트와 합의 레이어(CL) 클라이언트, 이렇게 두 개의 클라이언트가 필요하다는 점에 유의하세요. 이 페이지에서는 이 두 클라이언트를 설치, 구성 및 연결하여 이더리움 노드를 실행하는 방법을 보여줍니다.

필수 구성 요소

이더리움 노드가 무엇인지, 그리고 왜 클라이언트를 실행해야 하는지 이해해야 합니다. 이 내용은 노드와 클라이언트에서 다룹니다.

노드 실행이라는 주제를 처음 접하시거나 기술적인 부담이 적은 방법을 찾고 계신다면, 먼저 이더리움 노드 실행에 대한 사용자 친화적인 소개 자료를 확인하시는 것을 추천합니다.

접근 방식 선택

노드 가동의 첫 번째 단계는 접근 방식을 선택하는 것입니다. 요구사항과 다양한 가능성을 바탕으로 클라이언트 구현(실행 및 합의 클라이언트 모두), 환경(하드웨어, 시스템), 클라이언트 설정 매개변수를 선택해야 합니다.

이 페이지에서는 이러한 결정을 내리는 데 도움을 드리고, 여러분의 이더리움 인스턴스를 실행하는 가장 적합한 방법을 찾는 데 도움을 드릴 것입니다.

클라이언트 구현 중에서 선택하려면, 사용 가능한 모든 메인넷 지원 실행 클라이언트와 합의 클라이언트를 살펴보고 클라이언트 다양성에 대해 알아보세요.

클라이언트의 요구사항을 고려하여 자체 하드웨어에서 실행할지 또는 클라우드에서 실행할지 결정하세요.

환경을 준비한 후, 초보자 친화적인 인터페이스를 사용하거나 고급 옵션이 있는 터미널을 사용하여 수동으로 선택한 클라이언트를 설치하세요.

노드가 실행되고 동기화되면 사용할 준비가 된 것이지만, 유지 관리에도 계속 신경 써야 합니다.

클라이언트 설정

환경 및 하드웨어

로컬 또는 클라우드

이더리움 클라이언트는 일반 소비자용 컴퓨터에서 실행할 수 있으며, 예를 들어 채굴기와 같은 특수 하드웨어가 필요하지 않습니다. 따라서 필요에 따라 노드를 배포하는 데 다양한 옵션이 있습니다. 간단하게 설명하기 위해 로컬 물리적 머신과 클라우드 서버 양쪽에서 노드를 실행하는 경우를 생각해 보겠습니다.

  • 클라우드
    • 공급자는 높은 서버 가동 시간과 고정 공인 IP 주소를 제공합니다.
    • 전용 서버나 가상 서버를 이용하는 것이 직접 구축하는 것보다 더 편할 수 있습니다.
    • 단점은 서버 제공업체라는 제3자를 신뢰해야 한다는 점입니다.
    • 풀 노드에 필요한 저장 공간 크기 때문에, 대여 서버의 가격이 비싸질 수 있습니다.
  • 자체 하드웨어
    • 더 신뢰가 필요 없고 자주적인 접근 방식
    • 일회성 투자
    • 사전 구성된 머신을 구매하는 옵션
    • 머신과 네트워킹을 물리적으로 준비, 유지 관리하고 잠재적인 문제를 해결해야 합니다.

두 옵션 모두 위에서 요약한 바와 같이 서로 다른 장점을 가지고 있습니다. 클라우드 솔루션을 찾고 있다면, 많은 전통적인 클라우드 컴퓨팅 제공업체 외에도 노드 배포에 중점을 둔 서비스도 있습니다. 호스팅된 노드에 대한 더 많은 옵션을 보려면 서비스형 노드를 확인하세요.

하드웨어

그러나 검열 저항적인 탈중앙화 네트워크는 클라우드 제공업체에 의존해서는 안 됩니다. 대신, 자체 로컬 하드웨어에서 노드를 실행하는 것이 생태계에 더 건강합니다. 추정치 (opens in a new tab)에 따르면 상당수의 노드가 클라우드에서 실행되고 있으며, 이는 단일 장애점이 될 수 있습니다.

이더리움 클라이언트는 컴퓨터, 노트북, 서버, 심지어 단일 보드 컴퓨터에서도 실행할 수 있습니다. 개인용 컴퓨터에서 클라이언트를 실행하는 것도 가능하지만, 노드 전용 머신을 사용하면 주 컴퓨터에 미치는 영향을 최소화하면서 성능과 보안을 크게 향상시킬 수 있습니다.

자체 하드웨어를 사용하는 것은 매우 쉬울 수 있습니다. 기술적인 지식이 있는 사람들을 위한 고급 설정뿐만 아니라 많은 간단한 옵션이 있습니다. 그럼 여러분의 머신에서 이더리움 클라이언트를 실행하기 위한 요구사항과 수단을 살펴보겠습니다.

요구사항

하드웨어 요구사항은 클라이언트마다 다르지만, 노드는 동기화 상태만 유지하면 되므로 일반적으로 그렇게 높지 않습니다. 훨씬 더 많은 컴퓨팅 파워를 필요로 하는 채굴과 혼동하지 마세요. 하지만 더 강력한 하드웨어를 사용하면 동기화 시간과 성능이 향상됩니다.

클라이언트를 설치하기 전에 컴퓨터에 실행할 수 있는 충분한 리소스가 있는지 확인하십시오. 최소 및 권장 요구사항은 아래에서 확인할 수 있습니다.

하드웨어의 병목 현상은 대부분 디스크 공간입니다. 이더리움 블록체인을 동기화하는 것은 입출력이 매우 많고 많은 공간을 필요로 합니다. 동기화 후에도 수백 GB의 여유 공간이 있는 솔리드 스테이트 드라이브(SSD)를 사용하는 것이 가장 좋습니다.

데이터베이스의 크기와 초기 동기화 속도는 선택한 클라이언트, 구성 및 동기화 전략에 따라 다릅니다.

또한 인터넷 연결이 대역폭 상한 (opens in a new tab)에 의해 제한되지 않는지 확인하세요. 초기 동기화 및 네트워크로 브로드캐스트되는 데이터가 제한을 초과할 수 있으므로 무제한 연결을 사용하는 것이 좋습니다.

운영 체제

모든 클라이언트는 주요 운영 체제(Linux, MacOS, Windows)를 지원합니다. 이는 자신에게 가장 적합한 운영 체제(OS)가 설치된 일반 데스크톱이나 서버 컴퓨터에서 노드를 실행할 수 있음을 의미합니다. 잠재적인 문제와 보안 취약점을 피하기 위해 OS를 최신 상태로 유지하십시오.

최소 요구사항
  • 2코어 이상 CPU
  • 8GB RAM
  • 2TB SSD
  • 10 MBit/s 이상 대역폭
권장 사양
  • 4코어 이상의 빠른 CPU
  • 16GB 이상 RAM
  • 2TB 이상의 빠른 SSD
  • 25 MBit/s 이상 대역폭

선택한 동기화 모드와 클라이언트는 공간 요구사항에 영향을 미치지만, 아래에 각 클라이언트에 필요한 디스크 공간을 추정해 두었습니다.

클라이언트디스크 크기(스냅 동기화)디스크 크기(전체 아카이브)
Besu800GB+12TB+
Erigon해당 없음2.5TB+
Geth500GB+12TB+
Nethermind500GB+12TB+
Reth해당 없음2.2TB+
  • 참고: Erigon과 Reth는 스냅 동기화를 제공하지 않지만, 전체 정리(Full Pruning)는 가능합니다(Erigon의 경우 약 2TB, Reth의 경우 약 1.2TB).

합의 클라이언트의 경우, 공간 요구사항은 클라이언트 구현 및 활성화된 기능(예: 검증인 슬래셔)에 따라 다르지만, 일반적으로 비콘 데이터에 추가로 200GB가 필요하다고 생각하면 됩니다. 검증인 수가 많아지면 대역폭 부하도 증가합니다. 이 분석 (opens in a new tab)에서 합의 클라이언트 요구사항에 대한 자세한 내용을 확인할 수 있습니다.

플러그 앤 플레이 솔루션

자체 하드웨어로 노드를 실행하는 가장 쉬운 방법은 플러그 앤 플레이 박스를 사용하는 것입니다. 공급업체의 사전 구성된 머신은 가장 간단한 경험을 제공합니다. 주문하고, 연결하고, 실행하면 됩니다. 소프트웨어를 모니터링하고 제어하기 위한 직관적인 가이드와 대시보드를 통해 모든 것이 사전 구성되어 자동으로 실행됩니다.

단일 보드 컴퓨터의 이더리움

이더리움 노드를 실행하는 쉽고 저렴한 방법은 라즈베리 파이(Raspberry Pi)와 같은 ARM 아키텍처를 가진 단일 보드 컴퓨터를 사용하는 것입니다. ARM 기반 이더리움(Ethereum on ARM) (opens in a new tab)은 라즈베리 파이 및 기타 ARM 보드를 위한 여러 실행 및 합의 클라이언트의 실행하기 쉬운 이미지를 제공합니다.

이러한 작고 저렴하며 효율적인 장치는 집에서 노드를 실행하는 데 이상적이지만 성능이 제한적이라는 점을 명심하십시오.

노드 가동하기

실제 클라이언트 설정은 자동화된 런처를 사용하거나 클라이언트 소프트웨어를 직접 설정하여 수동으로 수행할 수 있습니다.

고급 사용자가 아닌 경우, 설치를 안내하고 클라이언트 설정 프로세스를 자동화하는 소프트웨어인 런처를 사용하는 것이 좋습니다. 하지만 터미널 사용 경험이 있다면 수동 설정 단계도 쉽게 따라 할 수 있을 것입니다.

가이드 설정

여러 사용자 친화적인 프로젝트는 클라이언트 설정 경험을 향상시키는 것을 목표로 합니다. 이러한 런처는 자동 클라이언트 설치 및 구성을 제공하며, 일부는 클라이언트의 가이드 설정 및 모니터링을 위한 그래픽 인터페이스를 제공하기도 합니다.

다음은 몇 번의 클릭만으로 클라이언트를 설치하고 제어하는 데 도움이 되는 몇 가지 프로젝트입니다.

  • DappNode (opens in a new tab) - DappNode는 공급업체의 머신만 제공하는 것이 아닙니다. 소프트웨어, 실제 노드 런처 및 많은 기능을 갖춘 제어 센터는 임의의 하드웨어에서 사용할 수 있습니다.
  • EthPillar (opens in a new tab) - 풀 노드를 설정하는 가장 빠르고 쉬운 방법입니다. 원라이너 설정 도구 및 노드 관리 TUI. 무료입니다. 오픈 소스. 단독 스테이커에 의한 이더리움을 위한 공공재입니다. ARM64 및 AMD64 지원.
  • eth-docker (opens in a new tab) - 쉽고 안전한 스테이킹에 중점을 둔 Docker를 사용한 자동 설정으로, 기본적인 터미널 및 Docker 지식이 필요하며, 약간 더 고급 사용자에게 권장됩니다.
  • Stereum (opens in a new tab) - GUI 설정 가이드, 제어 센터 및 기타 여러 기능과 함께 SSH 연결을 통해 원격 서버에 클라이언트를 설치하기 위한 런처입니다.
  • NiceNode (opens in a new tab) - 컴퓨터에서 노드를 실행하기 위한 간단한 사용자 경험을 제공하는 런처입니다. 클라이언트를 선택하고 몇 번의 클릭만으로 시작하세요. 아직 개발 중입니다.
  • Sedge (opens in a new tab) - CLI 마법사를 사용하여 Docker 구성을 자동으로 생성하는 노드 설정 도구입니다. Nethermind에서 Go로 작성되었습니다.

수동 클라이언트 설정

다른 옵션은 클라이언트 소프트웨어를 수동으로 다운로드, 확인 및 구성하는 것입니다. 일부 클라이언트는 그래픽 인터페이스를 제공하지만, 수동 설정은 여전히 터미널에 대한 기본적인 기술이 필요하지만 훨씬 더 많은 다용성을 제공합니다.

앞서 설명했듯이, 자체 이더리움 노드를 설정하려면 합의 및 실행 클라이언트 쌍을 실행해야 합니다. 일부 클라이언트는 다른 종류의 라이트 클라이언트를 포함할 수 있으며 다른 소프트웨어 없이도 동기화할 수 있습니다. 하지만 완전한 무신뢰 검증을 위해서는 두 구현이 모두 필요합니다.

클라이언트 소프트웨어 받기

먼저 선호하는 실행 클라이언트와 합의 클라이언트 소프트웨어를 구해야 합니다.

운영 체제와 아키텍처에 맞는 실행 가능한 애플리케이션이나 설치 패키지를 간단히 다운로드할 수 있습니다. 다운로드한 패키지의 서명과 체크섬을 항상 확인하십시오. 일부 클라이언트는 더 쉬운 설치 및 업데이트를 위해 리포지토리 또는 Docker 이미지를 제공하기도 합니다. 모든 클라이언트는 오픈 소스이므로 소스에서 직접 빌드할 수도 있습니다. 이것은 더 고급 방법이지만, 경우에 따라 필요할 수 있습니다.

각 클라이언트 설치 지침은 위 클라이언트 목록에 링크된 문서에서 제공됩니다.

다음은 사전 빌드된 바이너리 또는 설치 지침을 찾을 수 있는 클라이언트의 릴리스 페이지입니다.

실행 클라이언트

클라이언트 다양성은 실행 레이어의 문제라는 점도 주목할 가치가 있습니다. 독자들은 소수 실행 클라이언트를 실행하는 것을 고려하는 것이 좋습니다.

합의 클라이언트

클라이언트 다양성은 검증인을 실행하는 합의 노드에 매우 중요합니다. 대부분의 검증인이 단일 클라이언트 구현을 실행하면 네트워크 보안이 위험에 처합니다. 따라서 소수 클라이언트를 선택하는 것을 고려하는 것이 좋습니다.

최신 네트워크 클라이언트 사용 현황 보기 (opens in a new tab) 및 클라이언트 다양성에 대해 자세히 알아보세요.

소프트웨어 확인

인터넷에서 소프트웨어를 다운로드할 때는 무결성을 확인하는 것이 좋습니다. 이 단계는 선택 사항이지만, 특히 이더리움 클라이언트와 같은 중요한 인프라 구성 요소의 경우 잠재적인 공격 벡터를 인식하고 이를 피하는 것이 중요합니다. 사전 빌드된 바이너리를 다운로드했다면, 이를 신뢰해야 하며 공격자가 실행 파일을 악성 파일로 바꿀 수 있는 위험을 감수해야 합니다.

개발자들은 릴리스된 바이너리를 PGP 키로 서명하므로, 여러분이 실행하는 소프트웨어가 정확히 그들이 만든 것임을 암호학적으로 확인할 수 있습니다. 개발자들이 사용하는 공개 키를 얻기만 하면 되며, 이는 클라이언트 릴리스 페이지나 문서에서 찾을 수 있습니다. 클라이언트 릴리스와 서명을 다운로드한 후, GnuPG (opens in a new tab)와 같은 PGP 구현을 사용하여 쉽게 확인할 수 있습니다. Linux (opens in a new tab) 또는 Windows/MacOS (opens in a new tab)에서 gpg를 사용하여 오픈 소스 소프트웨어를 확인하는 튜토리얼을 확인하십시오.

또 다른 확인 방법은 다운로드한 소프트웨어의 해시(고유한 암호화 지문)가 개발자가 제공한 것과 일치하는지 확인하는 것입니다. 이것은 PGP를 사용하는 것보다 훨씬 쉬우며, 일부 클라이언트는 이 옵션만 제공합니다. 다운로드한 소프트웨어에서 해시 함수를 실행하고 릴리스 페이지의 것과 비교하기만 하면 됩니다. 예를 들어,

1sha256sum teku-22.6.1.tar.gz
2
39b2f8c1f8d4dab0404ce70ea314ff4b3c77e9d27aff9d1e4c1933a5439767dde

클라이언트 설정

클라이언트 소프트웨어를 설치, 다운로드 또는 컴파일한 후에는 실행할 준비가 된 것입니다. 이는 적절한 구성으로 실행해야 함을 의미합니다. 클라이언트는 다양한 기능을 활성화할 수 있는 풍부한 구성 옵션을 제공합니다.

클라이언트 성능과 데이터 사용량에 상당한 영향을 미칠 수 있는 옵션부터 시작하겠습니다. 동기화 모드는 블록체인 데이터를 다운로드하고 검증하는 다양한 방법을 나타냅니다. 노드를 시작하기 전에 사용할 네트워크와 동기화 모드를 결정해야 합니다. 가장 중요하게 고려해야 할 사항은 클라이언트에 필요한 디스크 공간과 동기화 시간입니다. 기본 동기화 모드가 무엇인지 확인하려면 클라이언트 문서를 주의 깊게 살펴보십시오. 그것이 마음에 들지 않으면 보안 수준, 사용 가능한 데이터 및 비용에 따라 다른 것을 선택하십시오. 동기화 알고리즘 외에도 다양한 종류의 오래된 데이터를 정리하도록 설정할 수도 있습니다. 정리를 사용하면 오래된 데이터를 삭제할 수 있습니다. 즉, 최근 블록에서 도달할 수 없는 상태 트리 노드를 제거합니다.

다른 기본 구성 옵션으로는 네트워크(메인넷 또는 테스트넷) 선택, RPC 또는 웹소켓을 위한 HTTP 엔드포인트 활성화 등이 있습니다. 모든 기능과 옵션은 클라이언트 문서에서 찾을 수 있습니다. 다양한 클라이언트 구성은 CLI 또는 구성 파일에서 직접 해당 플래그로 클라이언트를 실행하여 설정할 수 있습니다. 각 클라이언트는 약간씩 다릅니다. 구성 옵션에 대한 자세한 내용은 항상 공식 문서나 도움말 페이지를 참조하십시오.

테스트 목적으로, 테스트넷 네트워크 중 하나에서 클라이언트를 실행하는 것을 선호할 수 있습니다. 지원되는 네트워크 개요 보기.

기본 구성을 갖춘 실행 클라이언트 실행 예제는 다음 섹션에서 찾을 수 있습니다.

실행 클라이언트 시작하기

이더리움 클라이언트 소프트웨어를 시작하기 전에 환경이 준비되었는지 마지막으로 확인하십시오. 예를 들어, 다음을 확인하십시오.

  • 선택한 네트워크와 동기화 모드를 고려하여 충분한 디스크 공간이 있는지 확인합니다.
  • 메모리와 CPU가 다른 프로그램에 의해 중단되지 않았는지 확인합니다.
  • 운영 체제가 최신 버전으로 업데이트되었는지 확인합니다.
  • 시스템의 시간과 날짜가 정확한지 확인합니다.
  • 라우터와 방화벽이 수신 포트에서 연결을 허용하는지 확인합니다. 기본적으로 이더리움 클라이언트는 수신기(TCP) 포트와 검색(UDP) 포트를 사용하며, 둘 다 기본적으로 30303입니다.

모든 것이 올바르게 작동하는지 확인하기 위해 먼저 테스트넷에서 클라이언트를 실행하십시오.

기본값이 아닌 클라이언트 설정은 시작 시 선언해야 합니다. 플래그나 구성 파일을 사용하여 선호하는 구성을 선언할 수 있습니다. 각 클라이언트의 기능 집합과 구성 구문은 다릅니다. 자세한 내용은 클라이언트 문서를 확인하십시오.

실행 및 합의 클라이언트는 Engine API (opens in a new tab)에 명시된 인증된 엔드포인트를 통해 통신합니다. 합의 클라이언트에 연결하려면 실행 클라이언트는 알려진 경로에 jwtsecret (opens in a new tab)을 생성해야 합니다. 보안 및 안정성상의 이유로 클라이언트는 동일한 머신에서 실행되어야 하며, 두 클라이언트 모두 로컬 RPC 연결을 인증하는 데 사용되므로 이 경로를 알아야 합니다. 실행 클라이언트는 또한 인증된 API에 대한 수신 포트를 정의해야 합니다.

이 토큰은 클라이언트 소프트웨어에 의해 자동으로 생성되지만, 경우에 따라 직접 생성해야 할 수도 있습니다. OpenSSL (opens in a new tab)을 사용하여 생성할 수 있습니다.

1openssl rand -hex 32 > jwtsecret

실행 클라이언트 실행하기

이 섹션에서는 실행 클라이언트를 시작하는 방법을 안내합니다. 이는 다음과 같은 설정으로 클라이언트를 시작하는 기본 구성의 예시일 뿐입니다.

  • 연결할 네트워크를 지정합니다. 이 예제에서는 메인넷입니다.
  • 블록체인을 포함한 모든 데이터가 저장될 데이터 디렉터리를 정의합니다.
    • 경로를 실제 경로로 대체해야 합니다. 예를 들어 외부 드라이브를 가리키도록 합니다.
  • 클라이언트와 통신하기 위한 인터페이스를 활성화합니다.
    • 합의 클라이언트와 통신하기 위한 JSON-RPC 및 Engine API 포함
  • 인증된 API를 위한 jwtsecret 경로를 정의합니다.
    • 예제 경로를 클라이언트가 액세스할 수 있는 실제 경로로 대체해야 합니다. 예: /tmp/jwtsecret

이것은 기본적인 예제일 뿐이며, 다른 모든 설정은 기본값으로 설정됩니다. 기본값, 설정 및 기능에 대해 자세히 알아보려면 각 클라이언트의 문서를 주의 깊게 살펴보십시오. 검증인 실행, 모니터링 등과 같은 더 많은 기능을 사용하려면 특정 클라이언트의 문서를 참조하십시오.

예제의 백슬래시 ``는 서식 목적으로만 사용되며, 구성 플래그는 한 줄로 정의할 수 있습니다.

Besu 실행

이 예제는 메인넷에서 Besu를 시작하고, 블록체인 데이터를 /data/ethereum에 기본 형식으로 저장하며, 합의 클라이언트 연결을 위해 JSON-RPC 및 Engine RPC를 활성화합니다. Engine API는 토큰 jwtsecret로 인증되며 localhost에서의 호출만 허용됩니다.

1besu --network=mainnet \
2    --data-path=/data/ethereum \
3    --rpc-http-enabled=true \
4    --engine-rpc-enabled=true \
5    --engine-host-allowlist="*" \
6    --engine-jwt-enabled=true \
7    --engine-jwt-secret=/path/to/jwtsecret

Besu는 또한 일련의 질문을 하고 구성 파일을 생성하는 런처 옵션도 함께 제공됩니다. 다음을 사용하여 대화형 런처를 실행합니다.

1besu --Xlauncher

Besu 문서 (opens in a new tab)에는 추가 옵션과 구성 세부 정보가 포함되어 있습니다.

Erigon 실행

이 예제는 메인넷에서 Erigon을 시작하고, /data/ethereum에 블록체인 데이터를 저장하며, JSON-RPC를 활성화하고, 허용되는 네임스페이스를 정의하며, jwtsecret 경로로 정의된 합의 클라이언트 연결을 위한 인증을 활성화합니다.

1erigon --chain mainnet \
2    --datadir /data/ethereum  \
3    --http --http.api=engine,eth,web3,net \
4    --authrpc.jwtsecret=/path/to/jwtsecret

Erigon은 기본적으로 8GB HDD로 전체 동기화를 수행하며, 이로 인해 2TB 이상의 아카이브 데이터가 생성됩니다. datadir이 충분한 여유 공간이 있는 디스크를 가리키는지 확인하거나, 다양한 종류의 데이터를 정리할 수 있는 --prune 플래그를 살펴보십시오. 자세한 내용은 Erigon의 --help를 확인하십시오.

Geth 실행

이 예제는 메인넷에서 Geth를 시작하고, /data/ethereum에 블록체인 데이터를 저장하며, JSON-RPC를 활성화하고 허용되는 네임스페이스를 정의합니다. 또한 합의 클라이언트 연결을 위한 인증을 활성화하며, 이는 jwtsecret 경로와 허용되는 연결을 정의하는 옵션(이 예제에서는 localhost에서만)이 필요합니다.

1geth --mainnet \
2    --datadir "/data/ethereum" \
3    --http --authrpc.addr localhost \
4    --authrpc.vhosts="localhost" \
5    --authrpc.port 8551
6    --authrpc.jwtsecret=/path/to/jwtsecret

모든 구성 옵션에 대한 문서 (opens in a new tab)를 확인하고 합의 클라이언트와 함께 Geth 실행 (opens in a new tab)에 대해 자세히 알아보십시오.

Nethermind 실행

Nethermind는 다양한 설치 옵션 (opens in a new tab)을 제공합니다. 패키지에는 가이드 설정이 포함된 런처를 비롯한 다양한 바이너리가 포함되어 있어 대화형으로 구성을 생성하는 데 도움이 됩니다. 또는 실행 파일 자체인 Runner를 찾아 구성 플래그와 함께 실행할 수 있습니다. JSON-RPC는 기본적으로 활성화되어 있습니다.

1Nethermind.Runner --config mainnet \
2    --datadir /data/ethereum \
3    --JsonRpc.JwtSecretFile=/path/to/jwtsecret

Nethermind 문서는 합의 클라이언트와 함께 Nethermind를 실행하는 완벽한 가이드 (opens in a new tab)를 제공합니다.

실행 클라이언트는 핵심 기능, 선택된 엔드포인트를 초기화하고 피어를 찾기 시작합니다. 피어를 성공적으로 발견한 후 클라이언트는 동기화를 시작합니다. 실행 클라이언트는 합의 클라이언트로부터의 연결을 기다립니다. 클라이언트가 현재 상태로 성공적으로 동기화되면 현재 블록체인 데이터를 사용할 수 있습니다.

Reth 실행

이 예제는 기본 데이터 위치를 사용하여 메인넷에서 Reth를 시작합니다. JSON-RPC 및 Engine RPC 인증을 활성화하여 jwtsecret 경로로 정의된 합의 클라이언트에 연결하며, localhost에서의 호출만 허용됩니다.

1reth node \
2    --authrpc.jwtsecret /path/to/jwtsecret \
3    --authrpc.addr 127.0.0.1 \
4    --authrpc.port 8551

기본 데이터 디렉터리에 대해 자세히 알아보려면 Reth 구성 (opens in a new tab)을 참조하십시오. Reth의 문서 (opens in a new tab)에는 추가 옵션과 구성 세부 정보가 포함되어 있습니다.

합의 클라이언트 시작하기

합의 클라이언트는 실행 클라이언트와의 로컬 RPC 연결을 설정하기 위해 올바른 포트 구성으로 시작해야 합니다. 합의 클라이언트는 노출된 실행 클라이언트 포트를 구성 인수로 사용하여 실행해야 합니다.

합의 클라이언트는 또한 둘 사이의 RPC 연결을 인증하기 위해 실행 클라이언트의 jwt-secret 경로가 필요합니다. 위의 실행 예제와 유사하게, 각 합의 클라이언트에는 jwt 토큰 파일 경로를 인수로 받는 구성 플래그가 있습니다. 이는 실행 클라이언트에 제공된 jwtsecret 경로와 일치해야 합니다.

검증인을 실행할 계획이라면, 수수료 수령인의 이더리움 주소를 지정하는 구성 플래그를 추가해야 합니다. 이곳에 검증인에 대한 이더 보상이 누적됩니다. 각 합의 클라이언트에는 --suggested-fee-recipient=0xabcd1과 같은 옵션이 있으며, 이는 이더리움 주소를 인수로 받습니다.

테스트넷에서 비콘 노드를 시작할 때, 체크포인트 동기화 (opens in a new tab)를 위한 공개 엔드포인트를 사용하여 동기화 시간을 크게 절약할 수 있습니다.

합의 클라이언트 실행하기

Lighthouse 실행

Lighthouse를 실행하기 전에 Lighthouse Book (opens in a new tab)에서 설치 및 구성 방법을 자세히 알아보십시오.

1lighthouse beacon_node \
2    --network mainnet \
3    --datadir /data/ethereum \
4    --http \
5    --execution-endpoint http://127.0.0.1:8551 \
6    --execution-jwt /path/to/jwtsecret
Lodestar 실행

Lodestar 소프트웨어를 컴파일하거나 Docker 이미지를 다운로드하여 설치하십시오. 문서 (opens in a new tab)와 더 포괄적인 설정 가이드 (opens in a new tab)에서 자세히 알아보십시오.

1lodestar beacon \
2    --dataDir="/data/ethereum" \
3    --network=mainnet \
4    --eth1.enabled=true \
5    --execution.urls="http://127.0.0.1:8551" \
6    --jwt-secret="/path/to/jwtsecret"
Nimbus 실행

Nimbus에는 합의 및 실행 클라이언트가 모두 포함되어 있습니다. 매우 낮은 컴퓨팅 파워를 가진 다양한 장치에서도 실행할 수 있습니다. 의존성 및 Nimbus 자체를 설치 (opens in a new tab)한 후, 합의 클라이언트를 실행할 수 있습니다.

1nimbus_beacon_node \
2    --network=mainnet \
3    --web3-url=http://127.0.0.1:8551 \
4    --rest \
5    --jwt-secret="/path/to/jwtsecret"
Prysm 실행

Prysm은 쉬운 자동 설치를 허용하는 스크립트와 함께 제공됩니다. 자세한 내용은 Prysm 문서 (opens in a new tab)에서 찾을 수 있습니다.

1./prysm.sh beacon-chain \
2    --mainnet \
3    --datadir /data/ethereum  \
4    --execution-endpoint=http://localhost:8551  \
5    --jwt-secret=/path/to/jwtsecret
Teku 실행
1teku --network mainnet \
2    --data-path "/data/ethereum" \
3    --ee-endpoint http://localhost:8551 \
4    --ee-jwt-secret-file "/path/to/jwtsecret"

합의 클라이언트가 실행 클라이언트에 연결하여 예치 계약을 읽고 검증인을 식별하면, 다른 비콘 노드 피어에도 연결하여 제네시스로부터 합의 슬롯을 동기화하기 시작합니다. 비콘 노드가 현재 에포크에 도달하면, 비콘 API를 검증인에게 사용할 수 있게 됩니다. 비콘 노드 API (opens in a new tab)에 대해 자세히 알아보세요.

검증인 추가하기

합의 클라이언트는 검증인이 연결할 비콘 노드 역할을 합니다. 각 합의 클라이언트에는 해당 문서에 자세히 설명된 자체 검증인 소프트웨어가 있습니다.

자체 검증인을 실행하면 이더리움 네트워크를 지원하는 가장 영향력 있고 신뢰가 필요 없는 방법인 단독 스테이킹이 가능합니다. 그러나 이를 위해서는 32 ETH의 예치금이 필요합니다. 더 적은 금액으로 자체 노드에서 검증인을 실행하려면 Rocket Pool (opens in a new tab)과 같은 무허가 노드 운영자를 갖춘 탈중앙화 풀에 관심이 있을 수 있습니다.

스테이킹 및 검증인 키 생성을 시작하는 가장 쉬운 방법은 Hoodi 테스트넷 스테이킹 런치패드 (opens in a new tab)를 사용하는 것입니다. 이를 통해 Hoodi에서 노드를 실행 (opens in a new tab)하여 설정을 테스트할 수 있습니다. 메인넷 준비가 되면 메인넷 스테이킹 런치패드 (opens in a new tab)를 사용하여 이 단계를 반복할 수 있습니다.

스테이킹 옵션에 대한 개요는 스테이킹 페이지를 참조하십시오.

노드 사용하기

실행 클라이언트는 트랜잭션을 제출하고, 스마트 계약과 상호 작용하거나 이더리움 네트워크에 배포하는 등 다양한 방식으로 사용할 수 있는 RPC API 엔드포인트를 제공합니다.

클라이언트마다 RPC 엔드포인트 구현이 다릅니다. 하지만 모든 클라이언트에서 사용할 수 있는 표준 JSON-RPC가 있습니다. 개요는 JSON-RPC 문서를 읽어보십시오. 이더리움 네트워크의 정보가 필요한 애플리케이션은 이 RPC를 사용할 수 있습니다. 예를 들어, 인기 있는 지갑인 MetaMask는 강력한 개인 정보 보호 및 보안 이점을 제공하는 자체 RPC 엔드포인트에 연결 (opens in a new tab)할 수 있습니다.

모든 합의 클라이언트는 Curl (opens in a new tab)과 같은 도구를 사용하여 요청을 보내 합의 클라이언트의 상태를 확인하거나 블록 및 합의 데이터를 다운로드하는 데 사용할 수 있는 비콘 API (opens in a new tab)를 노출합니다. 이에 대한 자세한 정보는 각 합의 클라이언트의 문서에서 찾을 수 있습니다.

RPC 연결하기

실행 클라이언트 JSON-RPC의 기본 포트는 8545이지만, 구성에서 로컬 엔드포인트의 포트를 수정할 수 있습니다. 기본적으로 RPC 인터페이스는 컴퓨터의 localhost에서만 연결할 수 있습니다. 원격으로 액세스할 수 있도록 하려면 주소를 0.0.0.0으로 변경하여 공개적으로 노출할 수 있습니다. 이렇게 하면 로컬 네트워크 및 공용 IP 주소를 통해 연결할 수 있습니다. 대부분의 경우 라우터에서 포트 포워딩을 설정해야 합니다.

인터넷에 포트를 노출하는 것은 인터넷상의 모든 사람이 노드를 제어할 수 있게 하므로 주의해서 접근하십시오. 클라이언트를 지갑으로 사용하는 경우, 악의적인 행위자가 노드에 액세스하여 시스템을 다운시키거나 자금을 훔칠 수 있습니다.

이를 해결하는 방법은 잠재적으로 유해한 RPC 메서드가 수정되지 않도록 하는 것입니다. 예를 들어, Geth에서는 --http.api web3,eth,txpool과 같은 플래그로 수정 가능한 메서드를 선언할 수 있습니다.

RPC 인터페이스에 대한 액세스는 엣지 레이어 API 또는 Nginx와 같은 웹 서버 애플리케이션을 개발하고 이를 클라이언트의 로컬 주소 및 포트에 연결하여 확장할 수 있습니다. 중간 계층을 활용하면 개발자는 RPC 인터페이스에 대한 보안 https 연결을 위해 인증서를 설정할 수도 있습니다.

웹 서버, 프록시 또는 외부용 Rest API를 설정하는 것이 노드의 RPC 엔드포인트에 대한 액세스를 제공하는 유일한 방법은 아닙니다. 공개적으로 연결 가능한 엔드포인트를 설정하는 또 다른 개인 정보 보호 방법은 자체 Tor (opens in a new tab) 어니언 서비스에서 노드를 호스팅하는 것입니다. 이렇게 하면 고정 공용 IP 주소나 열린 포트 없이 로컬 네트워크 외부에서 RPC에 연결할 수 있습니다. 그러나 이 구성을 사용하면 모든 애플리케이션에서 지원되지 않는 Tor 네트워크를 통해서만 RPC 엔드포인트에 액세스할 수 있으며 연결 문제가 발생할 수 있습니다.

이를 위해서는 자신만의 어니언 서비스 (opens in a new tab)를 만들어야 합니다. 자체 호스팅을 위해 어니언 서비스 설정에 대한 문서 (opens in a new tab)를 확인하십시오. RPC 포트로 프록시하는 웹 서버를 가리키거나 그냥 RPC로 직접 가리킬 수 있습니다.

마지막으로, 내부 네트워크에 대한 액세스를 제공하는 가장 인기 있는 방법 중 하나는 VPN 연결을 통하는 것입니다. 사용 사례와 노드에 액세스해야 하는 사용자 수에 따라 보안 VPN 연결이 옵션이 될 수 있습니다. OpenVPN (opens in a new tab)은 업계 표준 SSL/TLS 프로토콜을 사용하여 OSI 레이어 2 또는 3 보안 네트워크 확장을 구현하는 모든 기능을 갖춘 SSL VPN으로, 인증서, 스마트카드 및/또는 사용자 이름/비밀번호 자격 증명을 기반으로 하는 유연한 클라이언트 인증 방법을 지원하며, VPN 가상 인터페이스에 적용되는 방화벽 규칙을 사용하여 사용자 또는 그룹별 액세스 제어 정책을 허용합니다.

노드 운영하기

노드가 제대로 실행되고 있는지 확인하기 위해 정기적으로 모니터링해야 합니다. 가끔 유지 관리를 해야 할 수도 있습니다.

노드를 온라인 상태로 유지하기

노드가 항상 온라인 상태일 필요는 없지만, 네트워크와 동기화 상태를 유지하기 위해 가능한 한 온라인 상태를 유지해야 합니다. 다시 시작하기 위해 종료할 수 있지만 다음 사항에 유의하십시오.

  • 최근 상태가 아직 디스크에 기록되는 중이면 종료하는 데 몇 분이 걸릴 수 있습니다.
  • 강제 종료는 데이터베이스를 손상시켜 전체 노드를 다시 동기화해야 할 수 있습니다.
  • 클라이언트가 네트워크와 동기화되지 않으며 다시 시작할 때 다시 동기화해야 합니다. 노드가 마지막으로 종료된 위치에서 동기화를 시작할 수 있지만, 오프라인 상태였던 기간에 따라 프로세스에 시간이 걸릴 수 있습니다.

이는 합의 레이어 검증인 노드에는 적용되지 않습니다. 노드를 오프라인으로 전환하면 노드에 의존하는 모든 서비스에 영향을 미칩니다. 스테이킹 목적으로 노드를 실행하는 경우 가동 중지 시간을 최대한 최소화해야 합니다.

클라이언트 서비스 생성하기

시작 시 클라이언트를 자동으로 실행하는 서비스를 만드는 것을 고려하십시오. 예를 들어, Linux 서버에서는 systemd와 같은 서비스로 클라이언트를 적절한 구성으로 실행하고, 제한된 권한을 가진 사용자 아래에서 실행하며 자동으로 다시 시작하는 것이 좋은 방법입니다.

클라이언트 업데이트하기

클라이언트 소프트웨어를 최신 보안 패치, 기능 및 EIP로 최신 상태로 유지해야 합니다. 특히 하드 포크 전에는 올바른 클라이언트 버전을 실행하고 있는지 확인하십시오.

중요한 네트워크 업데이트 전에 EF는 블로그 (opens in a new tab)에 게시물을 올립니다. 노드에 업데이트가 필요할 때 메일로 알림을 받으려면 이러한 공지사항을 구독 (opens in a new tab)할 수 있습니다.

클라이언트 업데이트는 매우 간단합니다. 각 클라이언트의 문서에는 구체적인 지침이 있지만, 일반적으로 최신 버전을 다운로드하고 새 실행 파일로 클라이언트를 다시 시작하는 과정입니다. 클라이언트는 업데이트가 적용된 상태에서 중단된 지점부터 다시 시작해야 합니다.

각 클라이언트 구현에는 피어 투 피어 프로토콜에서 사용되지만 명령줄에서도 액세스할 수 있는 사람이 읽을 수 있는 버전 문자열이 있습니다. 이 버전 문자열을 통해 사용자는 올바른 버전을 실행하고 있는지 확인할 수 있으며, 블록 탐색기 및 기타 분석 도구는 네트워크를 통해 특정 클라이언트의 분포를 정량화하는 데 관심이 있습니다. 버전 문자열에 대한 자세한 정보는 개별 클라이언트 문서를 참조하십시오.

추가 서비스 실행하기

자체 노드를 실행하면 이더리움 클라이언트 RPC에 직접 액세스해야 하는 서비스를 사용할 수 있습니다. 이들은 레이어 2 솔루션, 지갑용 백엔드, 블록 탐색기, 개발자 도구 및 기타 이더리움 인프라와 같이 이더리움 위에 구축된 서비스입니다.

노드 모니터링하기

노드를 제대로 모니터링하려면 메트릭을 수집하는 것을 고려하십시오. 클라이언트는 노드에 대한 포괄적인 데이터를 얻을 수 있도록 메트릭 엔드포인트를 제공합니다. InfluxDB (opens in a new tab) 또는 Prometheus (opens in a new tab)와 같은 도구를 사용하여 데이터베이스를 만들고, Grafana (opens in a new tab)와 같은 소프트웨어에서 시각화 및 차트로 변환할 수 있습니다. 이 소프트웨어를 사용하기 위한 많은 설정이 있으며, 노드와 네트워크 전체를 시각화할 수 있는 다양한 Grafana 대시보드가 있습니다. 예를 들어, Geth 모니터링 튜토리얼을 확인하십시오.

모니터링의 일환으로 머신의 성능을 주시하십시오. 노드의 초기 동기화 중에 클라이언트 소프트웨어는 CPU와 RAM에 매우 부담을 줄 수 있습니다. Grafana 외에도 htop 또는 uptime과 같은 OS가 제공하는 도구를 사용하여 이를 수행할 수 있습니다.

더 읽어보기

관련 주제

이 문서가 도움이 되셨나요?