传统内容平台的核心矛盾在于：创作者生产内容，但内容的控制权却掌握在平台手中。平台可以限流、删文、修改分成规则，创作者几乎没有议价能力。去中心化出版（DePub，Decentralized Publishing）的思路是把这两件事拆开：内容存储交给IPFS这类分布式文件系统，发布记录和权属信息交给区块链，谁也无法单方面篡改。本文将以Node.js作为主要开发语言，完整实现一个简化版的DePub平台，涵盖架构设计、IPFS存储、哈希上链和读取验证四个环节。
一、DePub整体架构设计
在动手写代码之前，先明确系统的边界。DePub不需要把整篇文章直接写进区块链，链上存储的成本极高，每写一个字节都要付出真金白银的Gas费。合理的做法是采用链下存储加链上登记的混合架构：文章正文、标题、封面图等大体积数据存入IPFS，IPFS会返回一个内容寻址的CID（Content Identifier，本质是文件内容的哈希值），然后我们只把这个CID、作者地址、时间戳等元数据写入智能合约。
这样做有三个好处。第一，成本可控，链上每条记录只需要存储几十字节的字符串。第二，内容不可篡改，CID由文件内容哈希得出，哪怕改动一个标点，CID都会完全变化，任何人都无法偷梁换柱。第三，天然的可用性保障，只要网络中还有一个节点pin了这份内容，文章就不会消失，不存在中心化服务器关停导致全部内容丢失的风险。
整个系统的模块划分如下：内容编辑与发布模块（Node.js后端服务）、IPFS存储模块（通过ipfs-http-client连接IPFS节点）、区块链交互模块（通过ethers.js连接以太坊或测试网）、内容检索与验证模块（根据链上CID拉取IPFS内容并校验哈希）。下面我们逐个实现。
二、接入IPFS实现内容分布式存储
IPFS的接入方式有多种选择，可以自建节点，也可以使用Infura、Pinata等托管网关。开发阶段建议直接用本地节点配合ipfs-http-client，调试方便且免费。先安装依赖：
npm install ipfs-http-client ethers express multer
接下来实现内容上传的核心逻辑。用户提交的Markdown文章先序列化为Buffer，再调用IPFS的add接口上传，拿到CID后返回给调用方。这里要注意一个细节：CID默认是二进制格式，需要转换成字符串才能方便地存到链上。
const { create } = require('ipfs-http-client');
// 连接本地IPFS节点，默认端口5001
const ipfs = create({ host: '127.0.0.1', port: '5001', protocol: 'http' });
async function uploadContent(content) {
// 将文章内容转为Buffer后上传到IPFS
const { cid } = await ipfs.add(Buffer.from(content, 'utf-8'));
// 返回CID字符串，例如 bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi
return cid.toString();
}
module.exports = { ipfs, uploadContent };拿到CID还不够，还需要考虑内容持久化的问题。IPFS节点的垃圾回收机制会定期清理没有被引用的内容，如果只是add一次就不管了，内容过段时间可能就被回收了。生产环境通常要做pin操作，或者交给Pinata这类pinning服务托管。调用Pinata的API也很简单，把CID提交过去即可：
const axios = require('axios');
async function pinToPinata(cid) {
const res = await axios.post('https://api.pinata.dev/pin/pinByHash', {
hashToPin: cid
}, {
headers: {
Authorization: 'Bearer ' + process.env.PINATA_JWT
}
});
return res.data;
}这里有一个工程上容易踩的坑：CID分为v0和v1两个版本，v0以Qm开头且不区分大小写，v1以baf开头且包含大小写敏感的base32编码。上链时一定要统一版本，否则前端按CID拉取内容时会因为版本不匹配而404。建议在上传时就显式指定CID版本为v1，兼容性更好。
三、内容哈希上链与智能合约设计
链上部分用一个简单的智能合约来管理发布记录。合约不需要复杂，核心就是一张映射表，把作者地址与他的发布列表关联起来，每条记录包含CID、标题哈希、时间戳。用Solidity写一个最小可用版本：
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;
contract DePub {
struct Article {
string cid; // IPFS内容标识符
uint256 timestamp; // 发布时间戳
}
mapping(address => Article[]) private articles;
event Published(address indexed author, string cid, uint256 timestamp);
function publish(string memory _cid) public {
articles[msg.sender].push(Article(_cid, block.timestamp));
emit Published(msg.sender, _cid, block.timestamp);
}
function getArticleCount(address author) public view returns (uint256) {
return articles[author].length;
}
function getArticle(address author, uint256 index)
public view returns (string memory cid, uint256 timestamp)
{
Article storage a = articles[author][index];
return (a.cid, a.timestamp);
}
}合约 deliberately 不存储文章标题和正文，只存CID，这是刻意的成本控制。注意publish函数没有任何鉴权逻辑，因为区块链本身就是透明的，任何人都可以验证某条记录是否真实存在，伪造别人的发布记录没有意义——除非能拿到对方的私钥。当然，如果需要更强的作者身份绑定，可以在发布时附加一个用作者私钥对CID的签名，验证合约里做ecrecover校验。
Node.js侧通过ethers.js与合约交互。部署合约后拿到地址和ABI，后端服务在用户发布文章时依次执行上传IPFS和调用合约两个步骤：
const { ethers } = require('ethers');
const provider = new ethers.JsonRpcProvider('https://sepolia.infura.io/v3/' + process.env.INFURA_KEY);
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
const contract = new ethers.Contract(CONTRACT_ADDRESS, CONTRACT_ABI, wallet);
async function publishArticle(markdown) {
// 第一步：内容上传IPFS
const cid = await uploadContent(markdown);
// 第二步：CID写入区块链
const tx = await contract.publish(cid);
const receipt = await tx.wait();
console.log('发布成功，交易哈希:', receipt.hash);
return { cid, txHash: receipt.hash };
}有一个设计决策值得讨论：私钥应该放在后端服务还是用户浏览器钱包里？放在后端意味着平台代用户签名，体验流畅但重新引入了中心化信任，用户必须相信你不会伪造他的发布。更符合去中心化精神的做法是后端只负责上传IPFS拿到CID，签名和发送交易交给前端的MetaMask完成。两种方案可以并存，轻量用户走代发通道，注重主权的用户走钱包直签。
四、内容读取与完整性验证
读取流程是写入的逆过程：先从合约查出某作者的所有CID，再通过IPFS网关拉取内容。拉取时要做一个关键动作——校验。既然CID本身就是内容哈希，客户端拿到内容后重新计算哈希并与CID比对，就能确认内容在传输和存储过程中没有被篡改，这是去中心化系统里建立信任的基石。
async function readArticle(author, index) {
// 从链上取CID
const { cid, timestamp } = await contract.getArticle(author, index);
// 通过公共网关拉取内容
const res = await axios.get('https://ipfs.io/ipfs/' + cid);
const content = res.data;
// 本地重新计算哈希并校验
const { CID } = require('multiformats/cid');
const { sha256 } = require('multiformats/hashes/sha256');
const bytes = new TextEncoder().encode(content);
const hash = await sha256.digest(bytes);
const newCid = CID.create(1, 0x55, hash);
if (newCid.toString() !== cid) {
throw new Error('内容校验失败，数据可能被篡改');
}
return { content, timestamp };
}最后补一个完整的Express路由，把上传和发布串成一个HTTP接口：
const express = require('express');
const multer = require('multer');
const upload = multer();
const app = express();
app.use(express.json());
app.post('/api/publish', upload.none(), async (req, res) => {
try {
const { markdown } = req.body;
const result = await publishArticle(markdown);
res.json({ ok: true, cid: result.cid });
} catch (err) {
res.status(500).json({ ok: false, error: err.message });
}
});
app.listen(3000, () => console.log('DePub服务已启动'));五、遗留问题与优化方向
这个最小实现还有几处明显短板。其一是检索能力弱，区块链上的映射只能按作者地址查询，无法做全文搜索，实际产品需要引入The Graph做索引，或者链下维护一个搜索引擎，定期从链上同步事件日志来构建可搜索的数据库。其二是内容审核问题，去中心化让下架变得困难，社区通常通过前端层的黑名单机制来过滤违规内容，而不是从存储层删除。
其三是激励机制，一个完整的DePub生态通常会引入代币，读者打赏、作者质押、节点存储奖励都可以围绕代币设计经济模型，这部分可以通过ERC-20合约扩展实现。这些方向不属于本文的核心范围，但理解了本文的存储加登记这条主干之后，往上叠加任何业务逻辑都不会有架构层面的障碍。去中心化出版的技术门槛其实并不高，Node.js加IPFS加智能合约这三件套，一个后端开发者花一个周末就能跑通原型，剩下的主要是产品层面的打磨。