目录

deWeb 站点

deWeb 是什么

deWeb 让你把站点发布到 P2P 网络上,而不是某台服务器上。站点内容按内容寻址存起来,再由你自己签名的指针指向它。

站点是不是一直在线,取决于有没有节点持有它的内容。你自己的桌面端开着,别人就能访问;想让它更稳,见本章最后一节。

用内容块搭建 deWeb 站点
用内容块搭建 deWeb 站点

创建站点

  1. 在 DeWeb 里点 新建站点,弹出"选择站点类型"。
  2. 按分组挑一个模板:空白、博客、文档、小说、作品集、落地页、导航、技术、资源、漫画、影视、音乐。
  3. 填站点标题(会按模板预填),点 创建。

模板只是起点,建完之后页面和内容都可以随便改。「空白」也是一个普通模板,不是另一种模式。

编辑内容

站点由页面和内容块组成。编辑器中间是块画布,左边是页面列表,右边是实时预览。

在空行行首输入 `/` 会弹出块类型菜单。可选类型包括标题 1 / 2、正文、图片、列表、代码块、分隔线、画廊、嵌入网页、按钮链接、P2P 资源、漫画阅读器。

  • ⌘Enter 在当前块下方新增一块。
  • 块左侧的手柄可以拖动排序、转换成 其他类型、复制或删除。
  • 选中文字后会出现格式条:粗体、斜体、行内代码、链接。
  • ⌘Z 撤销,⌘⇧Z 重做。

左栏可以新增、重命名、上下移动和删除页面(删除页面会确认一次),也能填站点描述和 SEO 信息。编辑内容会自动保存。

发布

点 发布到 P2P 打开发布对话框。如果登录了账号,可以顺手勾选 加入全局发现,让站点进社区目录;没登录时这一项是禁用的。

确认后 Poter 会把全部页面渲染成一个自包含的 HTML 文件,上传到分布式存储,再写一个 Ed25519 签名的指针,最后写进本地 P2P 索引。

完成后会显示两个可复制的字段:

  • Hash —— 内容地址,每次发布新版本都会变。
  • Address —— p2p/<你的 Peer ID>/<slug> 形式的稳定标识,首次发布后固定不变,订阅者靠它跟踪你的站点。

发布需要 P2P 在线。看到「P2P 节点似乎离线——发布需要桌面端」就是侧边栏那个连接掉了,先恢复再发。

分享给别人

在 Poter 里:点 分享到聊天,选一个会话,对方会收到一张站点卡片,点开就在应用内看到你的站点,也可以直接订阅。

在普通浏览器里:当前版本没有现成的"复制公网链接"按钮,需要你自己拼——把网关地址和刚拿到的 Hash 接起来:

在任意浏览器里打开已发布的站点
https://node.faircup.site/d/<你的 Hash>

网关只能服务它自己持有的内容。你自己的桌面端关掉、又没有别的节点持有这份内容时,这个链接就打不开了。

订阅与更新

在站点卡片上点星标即订阅,再点一次取消。订阅时 Poter 会做三件事:在本地记下这条订阅(以 Address 为键)、把订阅公布到发现网络(发布方的订阅计数会增加)、并跟进发布方的发布记录,好让以后的更新落进你的本地索引。

订阅的站点出现在 发现 页的 我的订阅 标签下。发布方更新后那里会出现 有更新 角标,点 检查更新 或直接打开站点就会拉到新版本并清掉角标。

取消订阅只删掉你本地的订阅记录,不会通知发布方,对方的订阅数不会因此减少。

让站点更稳地在线上

Poter 站点靠持有内容的节点可达。没有节点持有,链接就打不开——即使发布方还在,对方离线时也一样。

最直接的办法是让发布站点的桌面端保持运行,它本身就是一份持有者。

想要更稳,可以自己跑一个 Poter Node。从公开仓库 poter-io/poter-node-releases 拉预编译二进制即可,不用克隆源码:

在 Linux 服务器上安装并运行 Poter Node(x86_64;ARM64 把文件名改成 poter-node_linux-aarch64)
curl -fsSL -o poter-node https://github.com/poter-io/poter-node-releases/releases/latest/download/poter-node_linux-x86_64
chmod +x poter-node && sudo install -m 755 poter-node /usr/local/bin/poter-node
sudo poter-node --data-dir /var/lib/poter --mode full

要说清楚:装上二进制并不会自动固定(pin)某个具体站点。节点只持有它从网络上取到的内容,没有"一键 pin 这个站点"的入口。当前版本应用内的节点管理页在 beta 阶段也是隐藏的。