[教程]瀏覽器擴展安裝

在您的瀏覽器中利用IPFS的力量!

目錄

關於 IPFS 伴侶

IPFS Companion 直接在您最喜歡的基於 Chromium 的瀏覽器或 Firefox 瀏覽器中利用本地運行的 IPFS 節點的功能(通過IPFS 桌面應用程序或命令行守護程序),支持ipfs:// 地址、將內容尋址的網站和文件路徑重定向到您的本地網關、輕鬆的 IPFS 文件導入和共享等等。

IPFS 是一種點對點超媒體協議,旨在使網絡更快、更安全、更有彈性、更開放。它可以創建和傳播完全分佈式的站點和應用程序,這些站點和應用程序不依賴於集中式託管,並且忠於開放、扁平網絡的原始願景。訪問IPFS 項目網站了解更多信息。

IPFS 伴侶功能

自動檢測並重定向IPFS資源

檢測帶有 IPFS 路徑的 URL

IPFS Companion 檢測並測試任何網站上類似 IPFS 的路徑(例如/ipfs/{cid}/ipns/{peerid_or_host-with-dnslink} )的請求。如果路徑是有效的 IPFS 地址,它將被重定向以從本地網關加載。網關localhost 還將自動切換到子域,為每個網站提供唯一的來源:

https://ipfs.io/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnRhttp://localhost:8080/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnRhttp://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi.ipfs.localhost:8080

檢測啟用 DNSLink 的 URL

IPFS Companion檢測網站 DNS 記錄中的 DNSLink 信息。如果站點使用 DNSLink(例如https://docs.ipfs.iohttps://ipld.iohttp://tr.wikipedia-on-ipfs.org),IPFS Companion 會重定向 HTTP 請求到您的本地網關:

http://docs.ipfs.techhttp://localhost:8080/ipns/docs.ipfs.techhttp://docs.ipfs.tech.ipns.localhost:8080/

檢測帶x-ipfs-path 標題的頁面

如果 IPFS Companionx-ipfs-path 在任何 HTTP 響應標頭中發現,也會將傳輸升級到 IPFS;當 URL 中不存在 IPFS 路徑時,這也可以作為後備方案。了解更多。

切換全局或每個站點重定向

您可以通過多種方式禁用和重新啟用本地網關重定向:

  • 在 IPFS Companion 的首選項中全局 暫停重定向
  • 使用“當前選項卡”下的切換按鈕(如下所示)或 IPFS Companion 的首選項中暫停每個站點的重定向
  • 添加x-ipfs-companion-no-redirect 到 URL 本身作為哈希(示例)或查詢參數(示例

從瀏覽器欄訪問常用的 IPFS 操作

IPFS Companion 使您只需點擊幾下即可快速輕鬆地從瀏覽器欄訪問常見操作:

  • 查看瀏覽器欄中的立方體圖標即可了解您連接了多少個同伴
  • 單擊立方體圖標以顯示主菜單,檢查您的 IPFS API 和網關狀態
  • 右鍵單擊圖像和其他頁面資產即可輕鬆將其添加到 IPFS(包括保留文件名的選項)
  • 選擇主菜單中的*“導入”* 選項,以便從瀏覽器選項卡快速拖放導入
  • 直接從主菜單固定或取消固定 IPFS 資源(通過 API)
  • 直接從主菜單複制可共享的公共網關鏈接、IPFS 內容路徑或 IPFS 資源的 CID
  • 單擊主菜單即可啟動IPFS Web UI 儀表板
  • 從主菜單快速輕鬆地切換網關重定向或打開/關閉所有 IPFS Companion 功能(如下圖所示)

基於每個網站切換網關重定向

您可以在主菜單的“當前選項卡” 部分下切換單個網站的(任何 IPFS 子資源的)重定向。如果該站點使用 DNSLink,則關閉也會恢復該站點的原始 URL。

切換每個站點的選擇退出

打開/關閉所有 IPFS Companion 功能

要暫時暫停所有 IPFS 集成(重定向、API 狀態內容腳本、協議處理程序等),請使用 IPFS Companion 菜單頂部的開/關按鈕。

關閉並重新打開 IPFS Companion

嘗試一下實驗!

IPFS Companion 附帶了各種實驗性功能。有些默認情況下是禁用的,因此請務必檢查 IPFS Companion 的首選項以查看全部內容。

  • 使純文本 IPFS 鏈接可點擊(演示
  • 將通過以下實驗協議發出的請求重新路由到 HTTP 網關(公共或自定義):
    • ipfs://$cid
    • ipns://$cid_or_fqdn
    • dweb:/ipfs/$cid
    • dweb:/ipns/$cid_or_fqdn
  • 在本地 IPFS 節點的外部 HTTP API(默認設置)和瀏覽器中嵌入的 js-ipfs 節點之間切換(請注意,這有一些功能限制節點類型切換截圖

安裝 IPFS 伴侶

最新穩定版本

|16x16 火狐| 安卓版火狐瀏覽器|16x16 | 勇敢| 歌劇| 邊緣16x16 16x16 16x16|
| — | — | — | — | — | — | — | — | — | — |
|從 AMO 安裝
|從 Chrome 應用商店安裝
|

重要的! 確保您的計算機上也安裝了 IPFS 。由於 IPFS Companion(在其標準配置中)與計算機的本地 IPFS 節點通信以發揮其瀏覽器魔力,因此您也需要在計算機上運行 IPFS。

還可以為每個版本獲取特定於供應商的軟件包,但這些版本未簽名,也不會自動更新。.zip 捆綁包只能通過chrome://extensions (Chromium)或about:debugging (Firefox)手動加載以進行冒煙測試。

發展

要使用 IPFS Companion 的代碼,您需要從源代碼安裝它。下面是快速步驟,但請參閱完整的開發人員說明以獲取更詳細的說明和提示。

  1. 克隆GitHub - ipfs/ipfs-companion: Browser extension that simplifies access to IPFS resources on the web
  2. 運行此一體化開發構建來安裝依賴項、構建並在您選擇的瀏覽器中啟動:

$ npm run dev-build chromium

  • 火狐瀏覽器

$ npm run dev-build firefox # firefox:nightly works too!

貢獻

歡迎大家幫助 IPFS Companion 變得更好!

發布流程

發布過程已記錄在此處

幫助和故障排除

問一個問題

詢問 IPFS Companion(或一般的 IPFS!)的最佳地點是官方 IPFS 論壇,您可以在其中搜索過去的討論,尋找可能也有相同問題的其他人。IRC 上還有一個活躍的#ipfs社區。

常見故障排除步驟

這些經常遇到的故障排除情況可能會有所幫助:

  • 通過右鍵單擊導入在 Firefox 中不起作用: 請參閱此解決方法
  • 使用 Ghostery 時,HTTP 到 HTTPS 重定向會失敗:眾所周知, Ghostery會玩弄 HTTP 到 HTTPS 重定向,這在某些設置中會破壞利用公共網關的網站(更多詳細信息)。在上游修復此問題之前,解決方法是將受影響的站點列入白名單
  • NoScript 破壞 IPFS Companion: 默認情況下,NoScript通過阻止從本地主機上運行的 IPFS 網關加載的資產來破壞 IPFS Companion。要解決此問題,請擴展 SYSTEM 規則集並在其前面添加 IPFS 白名單(可以隨意修改此規則,但首先要熟悉ABE 規則語法):
# Enable IPFS redirect to LOCAL
Site ^http://127.0.0.1:8080/(ipfs|ipns)*
Anonymize

# Prevent Internet sites from requesting LAN resources.
Site LOCAL
Accept from LOCAL
Deny
1 Like