撰寫 tools/what-is-ipfs.md（IPFS 入門與如何用 IPFS 瀏覽 anoni.net）

## 脈絡

2026-05-27 完成 DNSLink 部署：`_dnslink.anoni.net TXT "dnslink=/ipns/k51qzi5uqu5dlfm2jj0f70ex3r3babmwy8qh071inwknttr7wqa3uhdwvlmrmw"`，讓 IPFS 鏡像有人類可記憶的 URL（`https://ipfs.io/ipns/anoni.net/`、`https://anoni-net.ipns.dweb.link/`、`ipns://anoni.net/`）。但 docs 站目前沒有教讀者「怎麼用 IPFS 訪問 anoni.net」的入口文章。

既有 `docs/zh-TW/advanced/dweb-ipfs-onion.md` 偏「設計分析 + 部署案例」（CID/DHT/IPNS 原理、IPFS vs Onion 對照），定位在 advanced/，不適合當新手「我要用 IPFS 訪問 anoni.net」的入口。需要在 tools/ 補一篇 what-is-ipfs.md，跟既有 what-is-tor / what-is-tails / what-is-cryptpad / what-is-ooni 系列並列。

同期關鍵變動讀者會踩雷：Brave 1.69.153（2024-08-22）已移除原生 IPFS 支援，`ipns://anoni.net/` 在 Brave 會落到搜尋引擎。文章必須點明這個限制與替代方案，避免讀者以為部署壞了。

## 預期內容

`docs/zh-TW/tools/what-is-ipfs.md`，建議 sections：

1. **開場**：靜態網站常見的下架風險、IPFS 解決的是什麼問題（一段，引導讀者進入主題）
2. **IPFS 是什麼**（簡介 + 概念）
- 內容定址（CID）、IPNS、DNSLink 三個關鍵詞，每個一兩段
- 強調「IPFS = 內容存活靠多節點 pin」、「無單一可下架點」
- 不深入 DHT / Kademlia 細節（那是 advanced/dweb-ipfs-onion.md 的事）
3. **為什麼 anoni.net 有 IPFS 鏡像**
- 主站（HTTPS）+ IPFS 鏡像 + .onion 鏡像三軌部署的脈絡
- 連 `advanced/dweb-ipfs-onion.md` 給想深入的讀者
4. **如何用 IPFS 訪問 anoni.net**（核心使用教學）
- **入口列表**（表格呈現）：
- 主推：`https://anoni-net.ipns.dweb.link/`（subdomain-style，origin 隔離較安全）
- 備援：`https://dweb.link/ipns/anoni.net/`、`https://ipfs.io/ipns/anoni.net/`、`https://w3s.link/ipns/anoni.net/`、`https://4everland.io/ipns/anoni.net/`
- 原生：`ipns://anoni.net/`
- **不同瀏覽器的支援狀況**
- Chrome / Edge / Brave / Opera / Firefox：原生**不**支援 `ipns://`，要用 https URL（強調 Brave 1.69.153 已移除原生 IPFS）
- 進階：裝 [IPFS Companion 擴充套件](https://docs.ipfs.tech/install/ipfs-companion/)（恢復 `ipns://` 解析）或 [IPFS Desktop](https://docs.ipfs.tech/install/ipfs-desktop/)（本機 Kubo node）
5. **常見問題 / FAQ**
- 「為什麼有時候 gateway 很慢或 504？」→ IPNS DHT 解析延遲、換 gateway 重試
- 「我可以幫忙 pin 嗎？」→ 指向 community/ 對應流程（如果有；沒有就寫「歡迎到 Matrix 詢問」）
- 「IPFS 版內容會跟主站同步嗎？」→ 每次 docs deploy 後 `upload_to_ipfs.sh` 會更新 IPNS，DNSLink 指 IPNS 所以自動跟新
6. **延伸閱讀 / 相關**（依 docs 慣例 `## :material-chat-question: 一同瞭解` 段）
- 連到 `advanced/dweb-ipfs-onion.md`（深度設計）
- 連到 `tools/what-is-tor.md`、`basics/threat-model.md`(同類概念)

## 寫作風格

- 依 `.claude/rules/anoni-docs-style.md`（標點集合、禁用句型、避免 AI 慣用開頭、技術術語保留英文）
- 依 `.claude/rules/seo-checklist.md`（frontmatter 必填 title / description / icon、首段含台灣脈絡線索、相對路徑內部連結、外部連結 `{target="_blank"}`、相關閱讀區）
- frontmatter 範例：

```yaml
---
title: 什麼是 IPFS
description: IPFS 是用內容定址的去中心化檔案系統，讓網站內容能在多個節點存活、無單一可下架點。本文介紹 IPFS 的基本概念，以及如何用多種方式訪問 anoni.net 的 IPFS 鏡像（含 Brave 1.69+ 已移除原生支援的因應）。
icon: material/file-tree-outline
---
```

- H1：`# :material-file-tree-outline: 什麼是 IPFS？`（icon 候選：`material/file-tree-outline`、`material/folder-network-outline`、`simple/ipfs`，認領者擇一）
- 對應 what-is-cryptpad.md 的「概念 + 自架版本」雙線敘事節奏，不要寫成純百科

## 完成後

- [ ] `docs/zh-TW/tools/what-is-ipfs.md` 完成、PR merge
- [ ] `mkdocs.yml` nav 在 tools/ 群組加入 `what-is-ipfs.md`（依 sitemap.md 順序）
- [ ] `tools/index.md` 若有 what-is-* 列表，補上連結
- [ ] `advanced/dweb-ipfs-onion.md` 文末「一同瞭解」/「下一步」加回連到 `tools/what-is-ipfs.md`
- [ ] `community/tools.md`（社群自架服務介紹）如有提到 IPFS 鏡像，連結到 what-is-ipfs.md
- [ ] zh-CN / en 待同步（PR 描述標註）

## 相關

- DNSLink 已部署：`_dnslink.anoni.net TXT "dnslink=/ipns/k51qzi5uqu5dlfm2jj0f70ex3r3babmwy8qh071inwknttr7wqa3uhdwvlmrmw"`
- IPNS key：`anoni-net`（key 對應 IPNS hash 同上）
- IPFS build pipeline：`docs/build_docs_anoni_ipfs.sh` → `replace_sitename_anoni_ipfs.sh` → `upload_to_ipfs.sh`（自架 IPFS node 走 SSH tunnel 到 `ipfs-node:5001`）
- 既有設計分析文：`docs/zh-TW/advanced/dweb-ipfs-onion.md`（保留，不取代）
- 既有圖：`docs/zh-TW/assets/images/ipfs-vs-onion.drawio.svg`、`docs/zh-TW/assets/images/anoni-deployment.drawio.svg`（已被 dweb-ipfs-onion.md 引用，可斟酌在 what-is-ipfs.md 加入或新繪一張「DNSLink → IPNS → CID」解析鏈圖）
- 寫作風格：`.claude/rules/anoni-docs-style.md`
- SEO checklist：`.claude/rules/seo-checklist.md`
- 目錄歸屬：`.claude/rules/sitemap.md`
- 認領流程：`docs/zh-TW/community/contributor-handbook.md`
- 對照範例（what-is-* 系列）：`docs/zh-TW/tools/what-is-tor.md`、`docs/zh-TW/tools/what-is-cryptpad.md`