Chris Impey is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/chris-impey).

Chris Impey

Emma Hazel is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/emma-hazel).

Emma Hazel

Frank, 居住在香港, 從事 IT 行業，並為這個行業投身了大半生的精力。 沒事喜歡寫寫程式，看看書，玩 Instagram，玩貓。可他並不是一個『宅男』，他很喜歡旅行，遠的去過約旦，近的去過深水埗，每到一個地方，都讓他對這個世界有不同的認識。他也很喜歡寫網誌，認為寫作不僅能夠加深對知識的積累和認知，亦能夠讓人靜下心，坦誠面對自己。

Frank

Thomas Macaulay is a writer based in New York City. He's interested in all things tech, science, and photography related, and likes to yo-yo in his free time.


Follow him [on Twitter](https://twitter.com/thomas-macaulay).

Thomas Macaulay




IPFS 是一個非常科幻的檔案存儲系統。 如果想了解什麼是 IPFS，可參考這篇文章：<Link href="/blog/ipfs-q-and-a">IPFS 問與答</Link>

如果你有一台裝有 Docker 的伺服器，可以很方便的安裝 IPFS ，使你的伺服器變為 IPFS 中的一個節點。

IPFS 官方有提供 Docker 的[安裝指引](https://hub.docker.com/r/ipfs/go-ipfs/)， 我這裡將它變為 docker-compose 更容易操作一些。
### 步驟一
建立一個 docker-compose.yml 檔案，內容如下：
```bash
version: '3'
services:
  ipfs:
    image: ipfs/go-ipfs:latest
    container_name: ipfs_host
    volumes:
      - ./export:/export
      - ./ipfs_data:/data/ipfs
    ports:
      - '4001:4001'
      - '4001:4001/udp'
      - '127.0.0.1:8080:8080'
      - '127.0.0.1:5001:5001'
```
其中 5001 port 為 API 以及 WEB UI，8080 為 Proxy Gateway。 具體內容可以參閱官方網站詳細了解。
### 步驟二
確認伺服器已經安裝 docker， docker-compose ，在相同路徑下執行：
```bash
docker-compose up
```
即可。
### 步驟三
當 docker-compose up 成功啟動後，訪問瀏覽器 `localhost:5001/webui` 
即可開啟 WEB 界面：
![IFPS Web 管理界面](/image/blog/qsy1f.png)
在 WebUI 界面中可以看到你當前的節點的狀態，連接到了多少 peers，你也可以方便的在 WebUI 中添加檔案到 IPFS 中。

![](/image/blog/s09nn.png) 

### 可能遇到的問題 1
我第一次安裝時遇到了 WebUI 無響應的情況，即 127.0.0.1:5001/webui 無法開啟，半天沒有反應。查看 log 後發現因為我們使用 Docker 的形式安裝，而我的Docker Network 設定使得位於 Docker Container 內的 IPFS Deamon 無法連接 peers 導致。 解決這個問題，需要查看 Docker Container 的網絡設定：

```bash
docker inspect < your docker container id or name>
```

你會看到 Container 位於  172.19.0.0 subnet：

```bash
"IPAM": {
            "Driver": "default",
            "Options": null,
            "Config": [
                {
                    "Subnet": "172.19.0.0/16",
                    "Gateway": "172.19.0.1"
                }
            ]
        },
```

因此需要添加 firewall rules 允許網絡連接：

```bash
firewall-cmd --permanent --zone=public --add-rich-rule='rule family=ipv4 source address=172.19.0.0/16 accept'

firewall-cmd --zone=public --add-masquerade --permanent

firewall-cmd --reload
```

### 可能遇到的問題 2

打開 WebUI 界面後，可能出現無法連接 API 的情況：
![](/image/blog/l8f0t.png)

這個是因為 API 跨域訪問限制導致，按照界面提示添加對應的 rules 即可：

```bash
docker exec ipfs_host ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["http://www.yourdomain.com:5001","https://www.yourdomain.com","https://www.yourdomain.com","http://localhost:3000", "http://127.0.0.1:5001", "https://webui.ipfs.io"]'
[root@LS-820311-4279 ipfs]# docker exec ipfs_host ipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '["PUT", "POST"]'
```



IPFS 一個嶄新，自由，分佈式的檔案系統，安裝一個 IPFS 節點其實非常簡單，本文介紹用 Docker 的方式安裝 IPFS 節點，在 15 分鐘內即可完成。

用 Docker 安裝 IPFS

免費訂閱網誌文章