IPFS 不是搭建“又一个网盘”。它更像一套给文件发身份证的教程协议——谁存、谁取、搭建怎么验证，教程全写进哈希里。搭建我第一次跑起节点时，教程盯着终端里那串 Qm 开头的搭建地址看了半天，才反应过来：这玩意儿根本不在乎文件存在哪台服务器上，教程它只认内容本身。搭建

先装个能跑的教程节点

去 dist.ipfs.tech 下对应系统的压缩包，解压后把 ipfs 丢进 /usr/local/bin。搭建别急着 ipfs init，教程先看一眼磁盘——默认仓库在 ~/.ipfs，搭建要是教程你跟我一样用着 128G 的旧笔记本，最好先改配置指向大容量分区。搭建

export IPFS_PATH=/mnt/data/ipfs ipfs init 

初始化完会吐出一串 peer identity，里面有个 ID 字段。这串东西就是你在网络里的门牌号，跟哈希无关，但别人要连你得靠它。

改两处配置再启动

默认监听地址是 localhost，局域网里别的机器访问不了。打开 ~/.ipfs/config，把 API 和 Gateway 的 0.0.0.0 改上。顺手把 Swarm 的 DisableRelay 设成 false，不然 NAT 后面的节点很难被外网发现。

ipfs daemon 

看到 Daemon is ready 才算数。这时候另开终端跑 ipfs id，能返回地址列表就说明节点活了。

往里丢文件试试

随便找个 PDF，ipfs add yourfile.pdf。终端会打印两个东西：一个是 added Qm...，另一个是文件大小。那个 Qm 开头的就是 CID，内容变了它一定变。我试过把同一个文件改个文件名再 add，CID 纹丝不动——IPFS 压根不关心你叫它什么。

想从别的机器取，用 ipfs cat Qm... 就行。但前提是对方节点知道这个哈希对应的数据在哪。新节点第一次取冷门文件经常卡住，因为 DHT 里还没人提供这个块。等几分钟，或者手动 ipfs pin add 到自己的仓库里，会快很多。

网关和公共入口

本地网关默认跑在 127.0.0.1:8080。浏览器访问 http://localhost:8080/ipfs/Qm... 就能看到文件。但你要是想分享给没装 IPFS 的人，得用公共网关，比如 ipfs.io 或 cloudflare-ipfs.com。速度看运气，热门内容秒开，冷门内容转圈转到你怀疑人生。

有个坑：公共网关会缓存。你 ipfs add 完立刻用公共网关取，很可能 404，因为网关还没从你的节点拉到数据。等几分钟，或者先 ipfs pin add 确保本地有完整副本。

保持在线才有意义

IPFS 不是“上传完就完事”的服务。你的节点关机，别人就取不到你 add 的文件——除非别人也 pin 了同样的 CID。我自己的做法是找台常开的树莓派跑 daemon，把重要文件 ipfs pin add 进去，再用 ipfs-cluster 同步到另一台 VPS。这样哪怕家里断电，数据还在。

别指望公共网关永久保存你的东西。它们只是缓存，不是存储。真要长期存，要么自己保持节点在线，要么花钱买 pinning 服务，要么加入某个协作集群。IPFS 本身不解决“谁出硬盘”的问题，它只解决“怎么找到并验证”的问题。