ipfs 데스크탑
0.39.0
IPFS 데스크탑은 완전한 IPFS 노드, 편리한 OS 메뉴 표시줄/작업 표시줄 바로가기, 올인원 파일 관리자, 피어 맵 및 콘텐츠 탐색기 등 편리한 데스크탑 앱에서 IPFS의 모든 기능을 제공합니다.
IPFS 데스크톱을 사용하면 터미널을 건드릴 필요 없이 IPFS에 익숙해질 수 있습니다. 또는 이미 경험이 있는 경우 명령줄과 함께 강력한 메뉴 표시줄/작업 표시줄 바로가기를 사용하여 IPFS 작업 흐름을 더 빠르게 만드세요.
확실하지 않은 경우 자동 업데이트 메커니즘이 내장된 패키지 형식 중 하나를 선택하세요.
맥: ipfs-desktop-0.39.0-mac.dmg
윈도우: IPFS-Desktop-Setup-0.39.0.exe
리눅스: ipfs-desktop-0.39.0-linux-x86_64.AppImage
업데이트를 직접 관리하려면 아래의 다른 패키지 형식을 참조하세요.
IPFS 데스크탑
Linux에서 시스템 트레이 메뉴가 누락되는 이유는 무엇입니까?
Debian 11에서 IPFS 데스크탑을 설치할 수 없는 이유는 무엇입니까?
Debian 10에서 IPFS 데스크탑을 시작할 수 없는 이유는 무엇입니까?
내 IPFS 구성 및 로그 파일은 어디에 있습니까?
IPFS 데스크탑은 IPFS 저장소 위치를 어떻게 선택합니까?
IPFS 데스크탑은 어떤 버전의 IPFS를 사용합니까?
IPFS 데스크탑은 어떤 플래그로 부팅됩니까?
repo.lock 오류가 발생했습니다. 이 문제를 어떻게 해결합니까?
네트워크 오류가 발생했습니다(예: Error fetching ). 어떻게 해야 하나요?
도움이 더 필요해요!
번역
개발자 노트
스코틀랜드 사람
윈도우
리눅스/FreeBSD
소스에서 설치
시스템 시작 시 노드를 시작하고 OS에서 제어하세요.
파일, 폴더, 스크린샷을 IPFS로 빠르게 가져오기
노드의 콘텐츠를 쉽게 관리
전 세계 IPFS 동료를 시각화하세요
IPFS 파일의 "Merkle Forest" 탐색
IPFS 파일 및 링크에 대한 OS 전반의 지원을 즐기세요
진행하면서 IPFS 명령을 배우십시오.
빠른 설치 바로가기
목차
특징
설치하다
기여하다
FAQ 및 문제 해결
특허
IPFS 데스크탑은 완전한 IPFS 노드(kubo 실행)와 IPFS 웹 UI를 하나의 편리한 데스크탑 앱으로 결합합니다. 또한 다양한 일반 IPFS 작업에 쉽게 액세스할 수 있도록 OS 메뉴 표시줄/시스템 트레이에 메뉴를 추가합니다.
컴퓨터에 이미 IPFS 노드가 있는 경우 IPFS 데스크탑은 해당 노드에 대한 제어판 및 파일 브라우저 역할을 합니다. 노드가 없으면 노드가 노드를 설치합니다. 어느 쪽이든 IPFS 데스크탑은 자동으로 업데이트를 확인합니다.
IPFS 데스크탑을 사용하면 OS 메뉴 표시줄/시스템 트레이의 IPFS 로고 메뉴에서 바로 노드를 중지하거나 다시 시작할 수 있습니다. Mac 및 Windows 사용자의 경우 시스템 시작 시 IPFS 데스크탑이 실행되도록 설정하여 컴퓨터가 켜져 있을 때마다 노드가 실행되도록 할 수도 있습니다.
다양하고 편리한 방법으로 파일과 폴더를 IPFS 노드로 가져옵니다.
항목을 IPFS 데스크탑의 Files 화면으로 끌어서 놓기
컴퓨터 또는 IPFS 콘텐츠 ID(CID)의 항목을 추가하려면 Files 화면에서 Import 버튼을 클릭하세요.
(Windows) 파일/폴더 아이콘을 마우스 오른쪽 버튼으로 클릭하면 팝업 메뉴에서 IPFS에 추가할 수 있습니다.
(Mac) 메뉴 표시줄에 있는 IPFS 로고에 파일/폴더를 끌어다 놓습니다.
또한 IPFS 로고 메뉴 아래의 Take Screenshot 명령을 사용하여 스크린샷을 찍고 이를 노드로 가져오고 한 번의 클릭으로 공유 가능한 링크를 클립보드에 복사할 수 있습니다.
IPFS 데스크탑의 Files 화면은 노드 내용 작업을 위한 쉽고 친숙한 인터페이스를 제공합니다.
파일 및 폴더의 이름을 쉽게 바꾸거나 이동하거나 제거할 수 있습니다.
IPFS 데스크탑에서 직접 다양한 일반 파일 형식을 미리 봅니다.
파일/폴더의 IPFS 콘텐츠 ID(CID) 또는 공유 가능한 링크를 클립보드에 복사하세요.
IPFS 노드 또는 (곧 제공 예정!) 타사 고정 서비스에 파일을 "고정"합니다.
Peers 화면을 방문하여 어떤 노드에 연결되어 있는지, 어디에 있는지, 사용 중인 연결 등을 확인하세요.
Explore 화면을 사용하여 몇 가지 예제 데이터세트 또는 자신의 파일을 탐색하고 IPFS에 저장된 항목이 콘텐츠 주소가 지정된 조각으로 어떻게 분류되는지 직접 확인하세요.
IPFS 데스크탑을 사용하면 대부분의 운영 체제(Mac, Windows 및 일부 Linux 버전)에서 ipfs:// 및 ipns:// 를 포함한 프로토콜을 지원할 수 있습니다. 즉, 컴퓨터의 앱이 해당 프로토콜 식별자 중 하나로 시작하는 링크를 열려고 하면(예: 웹 브라우저에서 ipns://en.wikipedia-on-ipfs.org 링크를 발견하는 경우) IPFS 데스크탑에서 자동으로 열립니다.
ipfs:// 및 ipns:// 주소에 대한 더 나은 경험을 위해 IPFS Companion을 설치하여 즐겨 사용하는 브라우저에 지원을 추가하는 것이 좋습니다!
명령줄에서 IPFS를 사용하는 방법을 배우고 싶다면 IPFS 데스크탑의 CLI 교사 모드를 통해 일반적인 IPFS 명령을 확인할 수 있습니다. 이 기능을 켜려면 Settings 화면에서 CLI Tutor Mode 상자를 선택하기만 하면 됩니다.
릴리스 노트와 IPFS 데스크탑의 이전 버전은 릴리스 페이지에서 찾을 수 있습니다.
좋아하는 패키지 관리자가 보이지 않나요? 패키지 관리자 페이지를 방문하여 이에 대한 지원을 추가하도록 도와주세요!
설치 프로그램: ipfs-desktop-0.39.0-mac.dmg
Homebrew (커뮤니티 유지): brew install --cask ipfs
ℹ️ 기존 사용자의 업데이트 확인:
설치 프로그램: IPFS-Desktop-Setup-0.39.0.exe
Chocolatey (커뮤니티 관리): choco install ipfs-desktop
Scoop (커뮤니티 유지): scoop bucket add extras; scoop install extras/ipfs-desktop
WinGet (커뮤니티 유지): winget install IPFS.IPFS-Desktop
ℹ️ 기존 사용자의 업데이트 확인:
AppImage : ipfs-desktop-0.39.0-linux-x86_64.AppImage
Tarball(tar.gz) (배포판용 패키지를 빌드하는 데 사용): ipfs-desktop-0.39.0-linux-x64.tar.xz
데비안(DEB) (실험적): ipfs-desktop-0.39.0-linux-amd64.deb
Red Hat(RPM) (실험적): ipfs-desktop-0.39.0-linux-x86_64.rpm
FreeBSD (실험적): ipfs-desktop-0.39.0-linux-x64.freebsd(Linux 바이너리 호환성을 활성화해야 함)
Snapcraft 지원은 제한 문제로 인해 더 이상 사용되지 않으며 권장되지 않습니다. 대신 .AppImage 사용하세요.
ℹ️ 기존 사용자의 업데이트 확인:
추가 타사 패키지가 있지만 내장된 자동 업데이트 메커니즘이 비활성화되어 있습니다. 대신 업데이트 주기는 각 커뮤니티에서 유지 관리됩니다.
소스에서 IPFS 데스크탑을 설치하고 실행하려면 다음도 필요합니다.
Node.js – 현재 LTS 선택
node-gyp 에 필요한 플랫폼별 종속성
그런 다음 아래 단계에 따라 소스 코드를 복제하고, 종속 항목을 설치하고, 앱을 실행하세요.
자식 클론 https://github.com/ipfs/ipfs-desktop.gitcd ipfs-desktop npm ci npm 실행 빌드 npm 시작
빌드 참고 사항:
npm ciipfs-or-gateway npm 패키지를 사용하여 IPFS에서 전자로 실행될 webui 코드를 다운로드합니다. 자세한 내용은 빌드 프로세스 및 webui 코드를 참조하세요.
IPFS 데스크탑 자체는 Kubo와 IPFS Webui가 독립형 방식으로 함께 작동하고 트레이 및 상황별 통합과 같은 다른 OS 특정 기능에 액세스할 수 있도록 하는 간단한 컨테이너입니다. IPFS Webui에 액세스하는 방법에는 여러 가지가 있습니다.
https://webui.ipfs.io/#/welcome
http://127.0.0.1:5001/webui(kubo와 함께 제공)
IPFS 데스크탑 자체
이러한 IPFS Webui 인스턴스는 모두 동일하지만 약간 다르게 배송됩니다. 다운로드 중인 파일은 IPFS Webui의 특정 릴리스입니다. 즉, v4.1.1에는 IPFS Webui 릴리스 페이지에서 확인할 수 있는 콘텐츠 식별자(CID) bafybeiamycmd52xvg6k3nzr6z3n33de6a2teyhquhj4kspdtnvetnkrfim 이 있습니다.
IPFS 데스크탑에 대한 모든 기여를 환영합니다! 시작하는 가장 좋은 방법은 현재 열려 있는 문제를 확인하고(또는 "도움말 구함"이라고 표시된 문제에 대해 구체적으로 드릴다운) 흥미로운 것을 찾는 것입니다. 모든 문제는 IPFS 프로젝트 전체에서 사용되는 표준 레이블 분류 체계에 따라 분류되므로 주제별로 드릴링할 수도 있습니다(예: UX 관련 문제).
어떻게 기여하든 IPFS 기여 지침과 IPFS 커뮤니티 행동 강령을 읽고 따르십시오.
귀하의 언어로 번역에 기여하는 것은 특히 가치가 있습니다! 우리는 국제화를 관리하기 위해 Transifex를 사용합니다. 즉, 번역을 추가하기 위해 코드 한 줄도 변경할 필요가 없습니다. Transifex 계정에 가입하기만 하면 됩니다.
IPFS 데스크탑 앱에는 IPFS 웹 UI 및 IPLD 탐색기의 텍스트가 포함되어 있으므로 모든 텍스트를 보려면 세 가지 Transifex 프로젝트에 모두 참여해야 합니다.
https://www.transifex.com/ipfs/ipfs-desktop/
https://www.transifex.com/ipfs/ipfs-webui/
https://www.transifex.com/ipfs/ipld-explorer/
개발자를 위한 참고 사항: 우리는 영어를 정보 소스로 사용합니다. 즉, 새 텍스트를 추가하는 경우 ./assets/locales/en.json 에 추가하면 자동으로 Transifex에서 다른 언어로 전파됩니다.
릴리스 체크리스트를 포함하여 IPFS 데스크톱 해킹에 대한 자세한 내용은 전체 개발자 노트를 참조하세요.
IPFS 데스크탑은 Electron을 사용하여 구축되었으며 불행하게도 열악한 시스템 트레이 지원은 Electron 앱의 오랜 문제였습니다.
Electron v9.3.0 문서에 따라 문제 해결을 시도해 볼 수도 있습니다:
Linux에서는 지원되는 경우 앱 표시기가 사용됩니다. 그렇지 않으면 GtkStatusIcon 사용됩니다
앱 표시기만 지원하는 Linux 배포판에서는 트레이 아이콘이 작동하도록 하려면 libappindicator1 설치해야 합니다.
이전 시스템 트레이가 IPFS Desktop v0.13에 다시 포함된 것을 발견했다면 이는 Electron 팀이 StatusNotifier 에 대한 지원을 제거하고 XEmbed 라는 Linux의 이전 트레이 인터페이스를 복원했기 때문입니다.
데비안 패키지는 더 이상 데비안 11에 존재하지 않는 libappindicator3-1 에 의존합니다.
누락된 종속성을 직접 설치하거나 .AppImage 대신 사용해야 합니다.
일부 Linux 사용자는 IPFS 데스크탑을 시작하려고 할 때 다음 오류 중 하나를 볼 수 있습니다:
앱 아이콘을 두 번 클릭하여 실행하는 경우:
SUID 샌드박스 도우미 바이너리가 발견되었지만 올바르게 구성되지 않았습니다. 샌드박싱 없이 실행하는 대신 지금은 중단하겠습니다. chrome-sandbox가 루트 소유이고 모드가 4755인지 확인해야 합니다.
터미널에서 시작할 때:
$ ipfs-desktop$Trace/중단점 트랩
이는 Electron/Chrome 및 일부 강화된 커널에서 알려진 문제입니다. 자세한 내용은 여기에서 확인할 수 있지만 해결 방법은 다음 추가 매개변수를 사용하여 터미널에서 IPFS 데스크탑을 시작하는 것입니다.
$ ipfs-desktop --샌드박스 없음
중요한
IPFS 데스크탑 앱 구성은 Kubo IPFS 노드의 구성 및 저장소와 별개입니다.
Advanced 하위 메뉴에서 Open Logs Directory 또는 Open Configuration File 선택하여 IPFS 로고 메뉴에서 데스크탑 앱 및 로그 파일을 열 수 있습니다. 또는 다음과 같이 OS에서 찾으십시오.
맥: ~/Library/Application Support/IPFS Desktop/
윈도우: %appdata%/IPFS Desktop/
리눅스: ~/.config/IPFS Desktop/
중요한
IPFS 데스크탑은 데스크탑 앱과 별도로 자체 구성 및 저장소를 갖는 IPFS 노드의 Kubo 구현을 사용합니다.
IPFS 데스크탑은 ipfsd-ctl을 사용하여 Kubo 저장소를 찾습니다.
먼저 IPFS_PATH 환경 변수를 확인합니다.
설정되지 않은 경우 $HOME/.ipfs 로 대체됩니다. 첫 번째 실행이 성공하자마자 저장소 위치 정보가 구성 파일에 저장되어 정보의 출처가 됩니다.
IPFS 로고 메뉴에서 Kubo 저장소 디렉터리를 열려면 Advanced 하위 메뉴에서 Open Repository Directory 선택하세요.
IPFS 데스크탑에는 Kubo의 자체 내장 바이너리가 포함되어 있습니다( kubo 버전은 package.json 에 정의되어 있음). IPFS 데스크톱 사용에 대한 QA를 통과한 최신 버전의 Kubo입니다.
About 하위 메뉴를 보면 IPFS 로고 메뉴에서 실행 중인 IPFS 버전을 확인할 수 있습니다.
기본적으로 IPFS 데스크탑은 --migrate=true --enable-gc=true 플래그를 사용하여 IPFS 데몬을 시작합니다.
Advanced 하위 메뉴에서 Open Configuration File 선택하여 IPFS 데스크탑 구성 파일에서 이를 변경할 수 있습니다.
repo.lock 오류가 발생했습니다. 이 문제를 어떻게 해결합니까?일반적으로 이는 이전 프로세스가 저장소 디렉터리에서 저장소 잠금(파일이 사용 중임을 나타내는 표시)을 제거할 수 없음을 의미합니다. 이 작업은 자동으로 처리되어야 하지만 그렇지 않은 경우도 있습니다. 이 오류가 발생하면 일반적으로 실행 중인 IPFS 데몬이나 응용 프로그램을 종료한 후 이 파일을 안전하게 삭제할 수 있습니다. 간단한 과정은 다음과 같습니다:
ipfs 프로세스를 중지합니다.
저장소 내에 있는 잠금 파일을 수동으로 삭제합니다.
ipfs 데스크탑(또는 repo.lock 오류를 수신한 다른 프로세스)을 다시 시작해 보십시오.
Error fetching ). 어떻게 해야 하나요?업그레이드할 때 IPFS는 마이그레이션을 수행해야 할 수 있으며 이를 위해서는 마이그레이션에 필요한 정보를 다운로드하기 위한 안정적인 연결이 필요합니다. 때로는 인터넷 연결이 실패하거나 방화벽이나 바이러스 백신에 의해 차단되어 네트워크 오류가 발생할 수 있습니다. 문제를 제출하기 전에 다음을 시도해 보십시오.
인터넷에 연결되어 있는지 확인하세요.
방화벽이나 바이러스 백신이 P2P 트래픽과 같은 요청을 차단하고 있지 않은지 확인하세요.
IPFS 데스크탑을 다시 시작하여 다시 시도하십시오.
Kubo 데몬이 시작되지 않으면 ipfsd-ctl에서 이러한 오류가 나타납니다. 다음은 이 오류가 발생할 수 있는 몇 가지 시나리오입니다.
이는 이전에 컴퓨터에서 실행한 것보다 이전 버전의 ipfs-desktop 또는 Kubo를 실행하려고 시도하고 있음을 의미합니다. ipfs-desktop에 포함된 각 Kubo 버전은 특정 IPFS 저장소 버전과 연결되어 있으며, https://github.com/ipfs/fs-repo-migrations#when-should-i- migration에서 확인할 수 있습니다.
이상적인 솔루션은 상향 마이그레이션이 자동으로 발생하므로 최신 버전의 ipfs-desktop을 실행하고 있는지 확인하는 것입니다.
PATH 에 IPFS 데스크탑과 함께 번들로 제공되는 버전과 다른 kubo 버전이 있을 수 있습니다. 이 경우 최신 kubo 바이너리로 업데이트해야 합니다.
그러나 고급 사용자이고 이 오류를 발생시키는 이전 버전을 실제로 실행해야 하는 경우 마이그레이션을 역방향으로 수동으로 실행해야 합니다. 여기에서 공식 지침을 따를 수 있지만 추가 매개변수를 사용하면 됩니다: fs-repo-migrations -revert-ok -to N . 자세한 내용은 fs-repo-migrations --help 참조하세요.
이는 fs-repo-migrations에 필요한 마이그레이션을 다운로드하는 데 문제가 있을 때 발생합니다. 오류는 일반적으로 다음과 같습니다.
오류: 데몬을 초기화하는 중... 쿠보 버전: 0.22.0 레포 버전: 14 시스템 버전: amd64/darwin 골랭 버전: go1.19.12 오래된 fs-repo가 발견되었습니다. 마이그레이션을 실행해야 합니다. 적합한 마이그레이션 바이너리를 찾고 있습니다. 1개의 마이그레이션이 필요합니다. 다운로드 중입니다. 마이그레이션 다운로드 중: fs-repo-13-to-14... HTTP로 가져오기: "https://ipfs.io/ipfs/QmYerugGRCZWA8yQMKDsd9daEVXUR3C5nuw3VXuX1mggHa/fs-repo-13-to-14/versions"HTTP로 가져오기: "https://ipfs.io/ipfs/QmYerugGRCZWA8yQMKDsd9daEVXUR3C5nuw3VXuX1mggHa/fs-repo-13-to-14/versions"HTTP로 가져오기: "https://ipfs.io/ipfs/QmYerugGRCZWA8yQMKDsd9daEVXUR3C5nuw3VXuX1mggHa/fs-repo-13-to-14/versions"가져오기 오류: 재시도 횟수를 초과했습니다. 마지막 오류는 http.DefaultClient.Do 오류였습니다. "https://ipfs.io/ipfs/QmYerugGRCZWA8yQMKDsd9daEVXUR3C5nuw3VXuX1mggHa/fs-repo-13-to-14/versions" 가져오기: tcp 199.16.156.40:443 다이얼: i/o 시간 초과 IPFS로 가져오는 중: "fs-repo-13-to-14/versions" 가져오는 중 오류 발생: 컨텍스트 기한이 초과되었습니다. 최신 버전의 마이그레이션 fs-repo-13-to-14를 가져올 수 없습니다: 2개의 오류가 발생했습니다: * 재시도 횟수를 초과했습니다. 마지막 오류는 http.DefaultClient.Do 오류였습니다. "https://ipfs.io/ipfs/QmYerugGRCZWA8yQMKDsd9daEVXUR3C5nuw3VXuX1mggHa/fs-repo-13-to-14/versions" 가져오기: tcp 199.16.156.40:443 다이얼: i/o 시간 초과 *
Kubo 구성을 업데이트하여 다양한 마이그레이션 파일 소스를 사용해 볼 수 있습니다.
설정 탭으로 이동
구성에서 "Migrations"를 찾아 DownloadSources 배열을 ["IPFS", "https://dweb.link", "https://cloudflare-ipfs.com", "HTTP"] 로 업데이트하세요.
이 방법을 사용하려면 명령줄에서 ipfs 바이너리를 사용할 수 있어야 합니다.
ipfs config --json Migration.DownloadSources '["IPFS", "https://dweb.link", "https://cloudflare-ipfs.com", "HTTP"]'
구성 파일( ~/.ipfs/config 또는 C:UsersUsername.ipfsconfig )을 수동으로 편집할 수도 있습니다. 완료하면 json 파일이 유효한지 확인하세요.
IPFS 데스크탑 사용에 도움이 필요한 경우, 답변을 얻는 가장 빠른 방법은 공식 IPFS 포럼에 게시하는 것입니다.
IPFS 데스크탑 자체에서 버그나 기타 문제를 발견했다고 생각되면 문제를 열어주세요.
MIT — 프로토콜 랩스, Inc.
