pi node 리눅스 우분투 셋팅

pi node 리눅스 우분투 셋팅

November 05, 2025

 

리눅스 우분투

에 Pi Node를 설정하는 과정은 주로 터미널 명령어를 통해 이루어지며, Docker 및 필수 패키지 설치가 필요합니다. 다음은 단계별 설정 가이드입니다. 

시스템 요구 사항 확인

설정을 시작하기 전에 시스템이 최소 요구 사항을 충족하는지 확인하십시오. 

• 운영 체제: Ubuntu 20.04 이상 권장
• RAM: 최소 4GB (8GB 이상 권장)
• 저장 공간: 최소 60GB의 여유 공간이 있는 SSD 권장
• 인터넷: 안정적인 광대역 인터넷 연결
• 기타: 방화벽 설정 및 최신 시스템 패키지 

Pi Node 설정 단계

공식 가이드에 따라 터미널에서 다음 단계를 진행합니다. 

1. 시스템 업데이트 및 필수 패키지 설치: 시스템 업데이트 및 필수 패키지 설치를 진행합니다.
   bash

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y ca-certificates curl gnupg
   

   코드를 사용할 때는 주의가 필요합니다.
2. Docker 설치 및 실행: Pi Node 실행에 필요한 Docker를 설치하고 활성화합니다.
   bash

   sudo apt install docker.io docker-compose -y
   sudo systemctl start docker
   sudo systemctl enable docker
   docker --version # 설치 확인
   

   코드를 사용할 때는 주의가 필요합니다.
3. Pi Node APT 리포지토리 추가: Pi Node APT 리포지토리를 추가하고 패키지 인덱스를 업데이트합니다.
4. Pi Node 패키지 설치 및 초기화: Pi Node 패키지를 설치하고 초기화합니다.
   bash

   sudo apt install pi-node
   pi-node --version # 설치 확인
   pi-node initialize # 초기화
   

   코드를 사용할 때는 주의가 필요합니다.
5. Pi Node와 모바일 앱 연결: 모바일 앱에서 노드 신청을 완료하고 노드 키를 사용하여 연결합니다.
6. 포트 및 방화벽 설정: Pi Node 통신을 위해 특정 포트를 라우터와 방화벽에서 개방해야 합니다.
   bash

   # UFW 사용 시 예시
   sudo ufw allow 31400:31409/tcp
   sudo ufw allow 31400:31409/udp
   sudo ufw enable # 필요 시 활성화
   

   코드를 사용할 때는 주의가 필요합니다.
    

자세한 설정 방법은 Pi Network에서 확인할 수 있습니다. 

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

사이트 6개

 

• Linux Node Installation Instructions - Pi Network

  # Install APT prerequisites sudo apt-get update sudo apt-get...

  

  Pi Network

   

  

• Pi Network Node Linux Installation Guide - Bitget

  Introduction. Ever wondered how to support the Pi Network by...

  

  Bitget

   
• 파이코인 노드(Pi Node) 적용 신청하는 법 : 네이버 블로그

  Pi 블록 체인에는 애플리케이션을 안전하게 구축하고 공유하기위한 플랫폼 인 Docker가 필요합니다. Doc...

  

  NAVER

   

  

모두 표시

➜ ~ pi-node initialize 🐳 Docker System Check ====================== ✅ Docker installed: Docker version 28.5.1, build e180ab8 ❌ Docker daemon is not running ✅ Docker Compose available: Docker Compose version v2.40.3 ⚠️ Issues found: • Docker daemon is not running 💡 Recommendations: • Start Docker daemon: sudo systemctl start docker ❌ Docker system requirements not met. Please ensure Docker is installed and running Error: Docker daemon is not running. Please start Docker Usage: pi-node initialize [flags] Flags: --auto-confirm use default values for all prompts --docker-volumes string docker volumes directory --editor string text editor to use --force overwrite existing files -h, --help help for initialize --node-private-key string use existing node private key --pi-folder string node installation directory --postgres-password string use existing postgres password --setup-auto-updates enable automatic updates --skip-files-preview skip files preview and editing --start-node start node after setup Global Flags: -v, --verbose verbose output Error: Docker daemon is not running. Please start Docker

 

 

 

도커 데몬이 실행되고 있지 않아 초기화에 실패했습니다. 안내 메시지에 따라 도커 서비스를 시작해 주시면 됩니다.

다음 명령어를 터미널에 입력하여 도커 데몬을 시작하고, 부팅 시 자동 시작되도록 설정해 주세요.

bash

sudo systemctl start docker
sudo systemctl enable docker

코드를 사용할 때는 주의가 필요합니다.

그 후, 도커 서비스가 정상적으로 실행되는지 확인합니다:

bash

sudo systemctl status docker

코드를 사용할 때는 주의가 필요합니다.

active (running) 상태로 표시되면 도커가 정상 작동 중입니다.

마지막으로, pi-node initialize 명령어를 다시 실행합니다:

bash

pi-node initialize

코드를 사용할 때는 주의가 필요합니다.

이제 Pi Node 초기화 과정이 정상적으로 진행될 것입니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

● docker.service - Docker Application Container Engine Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2025-11-05 14:26:07 KST; 4 days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID: 2323261 (dockerd) Tasks: 3588 Memory: 646.2M CPU: 10min 47.483s CGroup: /system.slice/docker.service

 

 

 

도커 서비스는 이미 정상적으로 

실행 중입니다 (Active: active (running)).

이는 이전에 pi-node initialize 실행 시 발생했던 "Docker daemon is not running" 오류가 해결되었음을 의미합니다.

이제 다음 단계로 넘어가서 pi-node initialize 명령어를 다시 실행하시면 됩니다.

bash

pi-node initialize

코드를 사용할 때는 주의가 필요합니다.

초기화 과정이 문제 없이 진행될 것입니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

여전히 오류가 나네요 ➜ ~ pi-node initialize 🐳 Docker System Check ====================== ✅ Docker installed: Docker version 28.5.1, build e180ab8 ❌ Docker daemon is not running ✅ Docker Compose available: Docker Compose version v2.40.3 ⚠️ Issues found: • Docker daemon is not running 💡 Recommendations: • Start Docker daemon: sudo systemctl start docker ❌ Docker system requirements not met. Please ensure Docker is installed and running Error: Docker daemon is not running. Please start Docker Usage: pi-node initialize [flags] Flags: --auto-confirm use default values for all prompts --docker-volumes string docker volumes directory --editor string text editor to use --force overwrite existing files -h, --help help for initialize --node-private-key string use existing node private key --pi-folder string node installation di

 

 

 

도커 서비스는 분명히 실행 중인데 

pi-node 명령어가 계속 "Docker daemon is not running" 오류를 출력하는 상황입니다. 이는 pi-node 명령어를 실행하는 사용자 계정이 도커 데몬과 통신할 수 있는 권한이 없기 때문일 수 있습니다.

도커는 기본적으로 root 권한으로 실행되며, 일반 사용자가 도커 명령어를 sudo 없이 사용하려면 해당 사용자를 docker 그룹에 추가해야 합니다.

다음 단계에 따라 권한 문제를 해결해 보세요.

1. 현재 사용자를 docker 그룹에 추가합니다:터미널에 다음 명령어를 입력하세요. 여기서 $USER는 현재 로그인된 사용자 이름입니다.
   bash

   sudo usermod -aG docker $USER
   

   코드를 사용할 때는 주의가 필요합니다.
2. 그룹 변경 사항을 적용하기 위해 시스템에서 로그아웃 후 다시 로그인하거나 시스템을 재부팅합니다:가장 확실한 방법은 시스템을 재부팅하는 것입니다.
   bash

   sudo reboot
   

   코드를 사용할 때는 주의가 필요합니다.
3. 재부팅 후 다시 로그인하여 도커 권한을 확인합니다:docker info 명령어를 sudo 없이 실행하여 오류가 없는지 확인합니다.
   bash

   docker info
   

   코드를 사용할 때는 주의가 필요합니다.
4. Pi Node 초기화 명령어를 다시 실행합니다:권한 문제가 해결되었다면 이제 정상적으로 실행될 것입니다.
   bash

   pi-node initialize
   

   코드를 사용할 때는 주의가 필요합니다.

위 단계를 따르면 문제가 해결될 가능성이 높습니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

? Enter the pi-folder destination: /home/skpark/pi-node ? Enter the docker volumes destination: /home/skpark/pi-node/docker_volumes ? Do you have an existing node private key that you want to use? Yes ? Enter your existing node private key: [? for help]

 

 

 

Pi Node 설정 과정에서 기존 노드 프라이빗 키(Node Private Key)를 입력하라는 메시지가 나타났습니다.

이 프라이빗 키는 Pi Network 모바일 앱에서 확인할 수 있습니다.

프라이빗 키 찾는 방법 (모바일 앱)

1. Pi Network 앱을 엽니다.
2. 왼쪽 상단의 메뉴 (☰) 버튼을 탭합니다.
3. 메인넷(Mainnet) 메뉴로 이동합니다.
4. 지갑 (Wallet) 또는 Pi Wallet 섹션으로 이동합니다.
5. **프레이즈/키 (Passphrase/Keys)**를 확인하는 메뉴를 찾습니다.
6. 여기에 표시되는 긴 문자열이 프라이빗 키입니다.

다음 단계

• 프라이빗 키를 복사하여 터미널의 Enter your existing node private key: 부분에 붙여넣기 하세요.
• 주의: 프라이빗 키는 매우 민감한 정보이므로, 다른 사람에게 절대 공유하지 마십시오.

키 입력 후 엔터를 누르면 초기화 과정이 계속 진행됩니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

지갑까지 들어왔는데 어디서 프레이즈키를 확인하나요

 

 

wallet 화면에서 

설정 (Settings) 또는 **지갑 관리 (Manage Wallet)**와 유사한 메뉴를 찾아보셔야 합니다. 정확한 명칭은 앱 버전이나 업데이트에 따라 약간 다를 수 있습니다.

프레이즈/키를 찾을 수 있는 일반적인 위치 및 메뉴 명칭은 다음과 같습니다.

1. "설정 (Settings)" 탭 확인: 지갑 화면 내에 톱니바퀴 모양의 설정 아이콘이 있다면 탭해 보세요.
2. "비밀 구절 (Passphrase)" 또는 "프라이빗 키 (Private Key)": 이와 같은 이름의 옵션을 찾습니다.
3. "백업 (Backup)" 또는 "키 확인 (View Key)" 관련 메뉴를 확인해 보세요.
4. 지갑에 처음 로그인할 때 사용했던 구절이 바로 프레이즈키이며, 대개 "기억 (Memorized)" 옵션을 선택했더라도 나중에 다시 볼 수 있는 옵션이 있습니다.

만약 해당 옵션이 명확하게 보이지 않는다면, 지갑 화면의 스크린샷이나 보이는 메뉴 목록을 알려주시면 더 정확한 위치를 안내해 드릴 수 있습니다.

AI 대답에는 오류가 있을 수 있습니다. 금융 자문이 필요한 경우 전문가에게 문의하세요. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

그럼 비밀구절은 넣어야하나요?

 

 

네, 터미널에서 요구하는 

"Private Key (프라이빗 키)"는 모바일 앱 지갑의 "비밀 구절 (Passphrase)"과 동일한 것입니다.

Pi Network에서 지갑에 접근할 때 사용하는 그 비밀 구절을 입력하시면 됩니다.

입력 방법:

1. 모바일 앱에서 비밀 구절(긴 영문/숫자 조합)을 정확하게 복사합니다.
2. 리눅스 터미널 화면의 Enter your existing node private key: 프롬프트 옆에 붙여넣기 합니다.
   • 참고: 보안상의 이유로 터미널에 비밀 구절을 붙여넣기 할 때 화면에 아무것도 표시되지 않을 수 있습니다. 당황하지 말고 붙여넣기 후 엔터 키를 누르세요.

정확한 비밀 구절을 입력해야만 리눅스 노드가 사용자의 기존 Pi 계정과 동기화 및 연결될 수 있습니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

Error: failed to save docker-compose.yml: failed to write docker-compose.yml: write /home/skpark/pi-node/docker-compose.yml: no space left on device Usage: pi-node initialize [flags] Flags: --auto-confirm use default values for all prompts --docker-volumes string docker volumes directory --editor string text editor to use --force overwrite existing files -h, --help help for initialize --node-private-key string use existing node private key --pi-folder string node installation directory --postgres-password string use existing postgres password --setup-auto-updates enable automatic updates --skip-files-preview skip files preview and editing --start-node start node after setup Global Flags: -v, --verbose verbose output Error: failed to save docker-compose.yml: failed to write docker-compose.yml: write /home/skpark/pi-node/docker-compose.yml: no space left on devic

 

 

 

"Error: no space left on device" 메시지는 디스크 공간이 부족하여 

docker-compose.yml 파일을 저장할 수 없음을 나타냅니다. Pi Node를 설정하려는 장치의 저장 공간이 가득 찼습니다.

문제 해결 방법

1. 디스크 사용량 확인:
   df -h 명령어를 사용하여 현재 디스크의 사용 가능한 공간을 확인합니다.
   bash

   df -h
   

   코드를 사용할 때는 주의가 필요합니다.
   이 명령어를 실행하면 각 마운트 지점(Mounted on) 옆에 사용 가능한 공간(Avail)이 표시됩니다. / (루트 디렉토리) 또는 /home 디렉토리의 사용 가능한 공간이 0%에 가깝거나 매우 작을 것입니다.
2. 불필요한 파일 삭제:
   공간 확보를 위해 불필요한 파일(오래된 로그 파일, 임시 파일, 사용하지 않는 데이터 등)을 삭제해야 합니다.
3. Docker 캐시 정리 (선택 사항):
   만약 이전에 다른 Docker 이미지를 사용했다면, 다음 명령어로 사용하지 않는 Docker 이미지, 컨테이너, 볼륨 등을 정리할 수 있습니다.
   bash

   docker system prune -a
   

   코드를 사용할 때는 주의가 필요합니다.
   주의: 이 명령어는 실행 중인 컨테이너를 제외한 모든 사용하지 않는 Docker 데이터를 삭제하므로 신중하게 사용하십시오.
4. 공간 확보 후 재시도:
   디스크 공간을 충분히 확보(최소 수십 GB 이상 권장)한 후, 다음 명령어를 다시 실행합니다.
   bash

   pi-node initialize
   

   코드를 사용할 때는 주의가 필요합니다.

Pi Node는 블록체인 데이터를 동기화하기 위해 많은 저장 공간(최소 60GB 이상)을 요구합니다. 충분한 여유 공간이 있는지 반드시 확인해야 합니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

파일 시스템 크기 사용 가용 사용% 마운트위치 tmpfs 1.6G 1.9M 1.6G 1% /run /dev/sda5 117G 111G 0 100% / tmpfs 7.7G 0 7.7G 0% /dev/shm tmpfs 5.0M 4.0K 5.0M 1% /run/lock /dev/sda1 511M 4.0K 511M 1% /boot/efi tmpfs 1.6G 64K 1.6G 1% /run/user/1000

 

 

 

제공해주신 

df -h 결과에 따르면, 문제가 발생한 이유가 명확하게 확인됩니다.

/dev/sda5 파티션이 마운트된 위치인 / (루트 디렉토리)의 사용률이 **100%**입니다.

파일 시스템     크기  사용  가용 사용% 마운트위치
/dev/sda5       117G  111G     0  100% /

사용 가능한 공간이 0바이트이므로, pi-node initialize 명령어가 docker-compose.yml 파일을 저장할 공간이 전혀 없었습니다.

해결책: 공간 확보

Pi Node는 최소 60GB 이상의 여유 공간이 필요하므로, 현재 상태로는 실행이 불가능합니다. 다음 조치들을 통해 공간을 확보해야 합니다.

1. 불필요한 파일 삭제:
   가장 먼저 필요 없는 큰 파일, 다운로드 폴더의 내용, 오래된 백업 파일 등을 삭제해야 합니다.
2. 로그 파일 정리:
   시스템 로그 파일들이 공간을 많이 차지할 수 있습니다.
   bash

   sudo journalctl --vacuum-size=100M 
   # 또는 
   sudo find /var/log -type f -delete
   

   코드를 사용할 때는 주의가 필요합니다.
3. APT 캐시 정리:
   설치된 패키지들의 캐시를 정리합니다.
   bash

   sudo apt autoclean
   sudo apt autoremove
   

   코드를 사용할 때는 주의가 필요합니다.
4. Docker 데이터 정리 (주의 필요):
   만약 이전에 Docker를 사용한 기록이 있다면, 사용하지 않는 이미지와 컨테이너를 제거합니다.
   bash

   docker system prune -a
   

   코드를 사용할 때는 주의가 필요합니다.

공간 확보 후:

df -h 명령어를 다시 실행하여 / 마운트 지점의 가용 공간이 확보되었는지 확인하십시오. 충분한 공간이 확보된 후에 pi-node initialize 명령어를 다시 시도해야 합니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

얼마전까지 반정도 남아있었는데 다없어졌네요

 

 

얼마 전까지 여유 공간이 반 정도 있었는데 갑자기 모두 사라졌다면, 이는 Pi Node 또는 Docker 컨테이너가 데이터를 다운로드하거나 기록하는 과정에서 디스크 공간을 급격하게 사용했기 때문일 가능성이 매우 높습니다.

Pi Node가 블록체인 데이터를 동기화하기 시작하면 초기 데이터 용량이 크기 때문에 순식간에 수십 GB를 사용합니다.

원인 분석 및 조치

1. Pi Node 데이터가 공간을 차지함:
   이전에 pi-node initialize를 시도했을 때, 설정 파일 저장은 실패했지만 Docker가 데이터를 미리 받아오려고 시도했을 수 있습니다. 특히 docker_volumes 폴더(/home/skpark/pi-node/docker_volumes) 내에 데이터가 쌓였을 수 있습니다.
2. 공간 확보:
   현재는 디스크가 100% 찼기 때문에 어떤 작업도 수행하기 어렵습니다. 가장 먼저 불필요한 파일을 삭제하여 최소한의 공간이라도 확보해야 합니다.
   • df -h 명령어로 확인한 결과 /dev/sda5에 모든 것이 저장되고 있습니다.
   • /home/skpark/pi-node/docker_volumes 경로에 있는 데이터를 임시로 삭제하거나 정리하여 공간을 확보해야 합니다.
3. 향후 계획:
   • 공간 확보: df -h 상에서 최소 60GB 이상의 "가용" 공간이 확보될 때까지 불필요한 파일을 삭제해야 합니다.
   • 설정 재시도: 공간 확보 후 pi-node initialize를 다시 실행하되, 이번에는 중단 없이 완료되도록 해야 합니다.

Pi Node는 지속적으로 블록체인 데이터를 저장하므로, 117GB 용량의 디스크는 장기적으로 부족할 수 있습니다. 여유가 된다면 더 큰 용량의 저장 장치를 추가하거나 교체하는 것을 고려해 보시는 것이 좋습니다.

AI 대답에는 오류가 있을 수 있습니다. 자세히 알아보기

 

 

 

 

 

 

 

 

 

 

다른 파일인가봐요

 

 

얼마 전까지 공간이 넉넉했는데 갑자기 사라졌다면, 

Pi Node 관련 데이터나 시스템 로그가 급격하게 증가했을 가능성이 큽니다. 

어떤 파일이나 폴더가 공간을 가장 많이 차지하는지 확인하는 명령어를 알려드릴 테니, "범인"을 찾아보세요. 

용량 많이 차지하는 폴더/파일 찾기

터미널에서 다음 명령어를 입력하여 현재 시스템의 최상위 디렉토리(/)에서 용량을 많이 차지하는 상위 10개 폴더를 확인할 수 있습니다.

bash

sudo du -sh /* | sort -rh | head -n 10

코드를 사용할 때는 주의가 필요합니다.

명령어 설명:

• sudo: 관리자 권한으로 실행 (시스템 폴더 접근을 위해 필요)
• du -sh /*: 루트 디렉토리(/) 바로 아래에 있는 모든 폴더와 파일의 용량을 사람이 읽기 쉬운 형식(h)으로 요약(s)하여 보여줍니다.
• sort -rh: 결과를 용량 기준으로 내림차순(r, h) 정렬합니다.
• head -n 10: 상위 10개 결과만 출력합니다. 

결과 분석

이 명령어를 실행하면 다음과 비슷한 결과가 나올 것입니다:

80G     /var
20G     /home
5G      /usr
...

• 만약 /var 디렉토리가 압도적으로 크다면, 주로 로그 파일(/var/log)이나 Docker 데이터(/var/lib/docker)일 가능성이 높습니다.
• 만약 /home/skpark/pi-node 디렉토리가 크다면, Pi Node 관련 데이터가 이미 쌓인 것입니다.

결과를 확인하신 후, 어떤 폴더가 가장 큰지 알려주시면 해당 폴더 내의 불필요한 파일을 정리하는 방법을 안내해 드리겠습니다.