IPFS 全球級分佈式文件系統

IPFS ＝ InterPlanetary File System

IPFS 簡介

IPFS 是分佈式文件系統，尋求鏈接全部計算機設備的相同文件系統。IPFS 結合了 Git， BitTorrent， Kademlia， SFS 和 Web 的優點，提供跟 HTTP web 同樣簡單的接口。IPFS 雲成爲一個新的，重要的網絡子系統，若是構建得當，那麼能夠完善或者替換 HTTP，或者說能夠完善或者替代更多。在某些方面，這很相似於原始的 Web 目標，可是 IPFS 最終會更像單個比特流羣交換的 git 對象。

IPFS 資源

IPFS 分爲 3 個代碼庫：

• IPFS 規範：https://github.com/ipfs/ipfs
• Go 實現：https://github.com/ipfs/go-ipfs
• Web 工做臺：https://github.com/protocol/ipfs-webui

IPFS 使用

USAGE:

    ipfs - global p2p merkle-dag filesystem

    ipfs [<flags>] <command> [<arg>] ...

    BASIC COMMANDS

        init          Initialize ipfs local configuration
        add <path>    Add an object to ipfs
        cat <ref>     Show ipfs object data
        get <ref>     Download ipfs objects
        ls <ref>      List links from an object
        refs <ref>    List hashes of links from an object

    DATA STRUCTURE COMMANDS

        block         Interact with raw blocks in the datastore
        object        Interact with raw dag nodes
        file          Interact with Unix filesystem objects

    ADVANCED COMMANDS

        daemon        Start a long-running daemon process
        mount         Mount an ipfs read-only mountpoint
        resolve       Resolve any type of name
        name          Publish or resolve IPNS names
        dns           Resolve DNS links
        pin           Pin objects to local storage
        repo gc       Garbage collect unpinned objects

    NETWORK COMMANDS

        id            Show info about ipfs peers
        bootstrap     Add or remove bootstrap peers
        swarm         Manage connections to the p2p network
        dht           Query the dht for values or peers
        ping          Measure the latency of a connection
        diag          Print diagnostics

    TOOL COMMANDS

        config        Manage configuration
        version       Show ipfs version information
        update        Download and apply go-ipfs updates
        commands      List all available commands

    Use 'ipfs <command> --help' to learn more about each command.

IPFS 項目和社區

The IPFS Project is now very large, with hundreds of contributors in our community. You are invited to join it! Here are some links to our communication channels:

• FAQs: Frequently Asked Questions
• Support and Getting Help!
• Sprints and Project Management
• Contributing Guidelines

You can also find our community on:

• IRC: #ipfs on chat.freenode.net for live help and some dev discussions (Logs)
• Google Group: ipfs-users@groups.google.com (low traffic)
• Twitter: @IPFSbot for some news.

IPFS 項目連接

The IPFS Project is big -- there are many subprojects and related efforts. We will document the core ones here, though you should look around. The space is exploding and lots of new projects are springing up all the time.

For a community-curated lists of awesome projects using IPFS, check out awesome-ipfs!

IPFS 協議實現

Language	Project	Completeness
Go	https://github.com/ipfs/go-ipfs	reference
Javascript	https://github.com/ipfs/js-ipfs	incomplete
Python	https://github.com/ipfs/py-ipfs	starting

If you would you like to start your own language implementation of IPFS, check out the IPFS Implementation Guide, and the Specifications. The specs are still evolving, but the core formats are stable and can be built on. Make sure to post an issue if you would like to start an effort, as many people have expressed interest in contributing to new implementations.

IPFS 客戶端SDK

Language	Client Library	Completeness
Go	https://github.com/ipfs/go-ipfs-api
Java	https://github.com/ipfs/java-ipfs-api
Javascript	https://github.com/ipfs/js-ipfs-api
Python	https://github.com/ipfs/py-ipfs-api
Scala	https://github.com/ipfs/scala-ipfs-api
Haskell	https://github.com/davidar/hs-ipfs-api
Swift	https://github.com/ipfs/swift-ipfs-api
CommonLisp	https://github.com/WeMeetAgain/cl-ipfs-api
Rust	https://github.com/rschulman/rust-ipfs-api
Ruby	https://github.com/Fryie/ipfs-ruby
Swift	https://github.com/NeoTeo/ipfs-osx-service
PHP	https://github.com/cloutier/php-ipfs-api
C#	https://github.com/TrekDev/net-ipfs-api
	https://github.com/richardschneider/net-ipfs-api
C/C++	contact: @PayasR	0%
Julia	contact: @rened	0%
Lua	contact: @seclorum	0%
Erlang	!	0%
Objective C	!	0%

Please help by contributing to one of the above client libraries. If you would like to create another, please see the IPFS API Client Implementation Guide, and tell us so we can help!

IPFS 項目列表

This aims to be a directory of all the various repos in the IPFS Github Organization, and other closely related things.

We have a status board that checks all IPFS repositories for CI, Readmes, test coverage, and so on, here: http://project-repos.ipfs.io/

項目組織

• ipfs - Master repo, intro, and news.
• community - Community Discussions and documentation on community practices.
• pm - Community Sprints and Project Management.

獲得幫助

• FAQ - Frequently Asked Questions, and answers. All questions are posed as GitHub issues.
• support - Support and Help with running IPFS. Post an Issue and we will help there or route you.

文檔

• papers - Academic papers on IPFS.
• specs - Specifications on the IPFS protocol.
• notes - Various relevant notes and discussions (that do not fit elsewhere).
• reading-list - Papers to read to understand IPFS.

研究討論

• apps - Coordinating writing apps on top of ipfs.
• archives - Coordinating archival efforts with IPFS.

規格討論

• archive-format - A DAG Archive format.
• bitswap-ml - Bitswap and Machine Learning.
• blockchain-data - Using IPFS for storing data for Blockchain apps.
• POST - A datastructure for human communication.

協議實現

• go-ipfs - Implementation in Go.
• js-ipfs - Implementation in Javascript.
• py-ipfs - Implementation in Python.

API 客戶端實現

• http-api-spec - Apiary IPFS HTTP API description http://docs.ipfs.apiary.io
• java-ipfs-api - Implementation in Java.
• js-ipfs-api - Implementation in Javascript.
• go-ipfs-api - Implementation in Go.
• python-ipfs-api - Implementation in Python.
• py-ipfs-api - A python client library for the IPFS API
• scala-ipfs-api - Implementation in Scala.
• swift-ipfs-api - Implementation in Swift.
• net-ipfs-api - Implementation in C#.

IPFS 節點應用

• station - An IPFS Desktop app.
• webui - The IPFS WebUI app.

基於IPFS發佈Apps

• astralboot - Low level boot server that deploys directly out of IPFS (TFTP, PXE Boot).
• ipfs-web-app - IPFS web app interfaces.
• ipget - wget for IPFS: retrieve files over IPFS and save them locally.
• starlog - Blog posts in IPFS.
• container-demos - Demos on how to boot docker images and VMs from IPFS.
• ipfs-geoip - Geoip over ipfs.
• ipfs-npm - npm on IPFS.

社區架構

• blog - The IPFS Blog
• community - Community Discussions and documentation on community practices.
• distributions - Scripts to build the /install html page.
• infrastructure - Tools and systems for the community.
• newsletter - Prepare and store IPFS Newsletter roundups
• ops-requests - Requests about infrastructure operations
• project-repos CI status and other health metrics
• website - The source to the IPFS community website at http://ipfs.io.

引用列表

• refs - Tools for publishing lists of IPFS ref heads.
• refs-denylists-dmca - DMCA takedown notices for the IPFS Public Gateway.
• refs-solarnet-storage - Inventory of content archived on Solarnet storage hosts.

其它社區資源

• examples - Examples on how to use go-ipfs.
• awesome-ipfs - Useful resources for using IPFS and building things on top of it.
• ipfs-readme-standard - Standardize all IPFS Readme.md's and other markdown files.
• ipld-examples - Datastructure examples to use with IPLD, the new data format for IPFS.
• logo - The logo for IPFS.
• translation project - Crowdsourced translation of IPFS WebUI and the ipfs.io website.

IPFS 會議

• ipfs/lisbon - The IPFS meetup in Lisbon.
• ipfs/london - The IPFS meetup in London.
• More repos coming here. Check the community discussions for other meetups. (There's many now!)

We encourage and support IPFS Meetups, please let us know if you would like to start one. Feel free to organize yourself through the Community discussions and to advertise events in the main repository.

工具

安裝

• install-go-ipfs - Install go-ipfs shell script.
• ipfs-update - An updater tool for IPFS.
• fs-repo-migrations - These are migrations for IPFS fs-repo versions.
• npm-go-ipfs - Install go-ipfs from npm.

其它

• connections-globe - An interactive globe to view all your IPFS peers.
• dataviz - IPFS data visualizations.
• dir-index-html - Directory listing html.
• dnslink-deploy - Automatically set DNS records on Digital Ocean.
• file-browser - Generic IPFS file browser UI
• fs-stress-test - Stress testing IPFS filesystem capabilities.
• ipfs-js-defaults - Sane defaults for IPFS node configurations.
• js-ipfsd-ctl - Control IPFS daemons from JavaScript.
• ipfs-hubot - Hubot for IPFS uses.

複製庫

• go-datastore (fork) - key-value datastore interfaces
• golang-build (fork) - Continuous build and release infrastructure
• pinbot-irc (fork) - a bot for the ipfs irc channel that pins things (among other menial tasks)

實現子模塊

Many more exist, but we will endeavor to find them and add them here.

• go-blocks - Deprecated, continued within go-ipfs
• go-commands - Deprecated, continued within go-ipfs
• go-ipfs-util - Common utilities used by go-ipfs and other related go packages.
• go-ipld - Implementation of the IPLD spec in Go.
• go-iprs - Go-ipfs records.
• go-libp2p - libp2p is a networking stack and library modularized out of The IPFS Project, and bundled separately for other tools to use.
• go-log - A logging library used by go-ipfs.
• ipfs-blob-store - A place to buy blobs.
• ipfs.js - IPFS on the Browser.
• js-ipfs-bitswap - JavaScript implementation of the Bitswap 'data exchange' protocol used by IPFS
• js-ipfs-blocks - JavaScript Implementation of Block and BlockService
• js-ipfs-data-importing - JavaScript implementation of the layout and chunking mechanisms used by IPFS
• js-ipfs-path - Javascript helper functions for IPFS path handling.
• js-ipfs-repo - Implementation of the IPFS repo spec in Javascript.
• js-ipfs-unixfs - JavaScript implementation of IPFS' unixfs (a Unix FileSystem representation on top of a MerkleDAG)
• js-libp2p-ipfs-browser - libp2p build (module) used in js-ipfs when running it on the browser
• js-libp2p-ipfs - libp2p build (module) used in js-ipfs