Varidata 新闻资讯

知识库 | 问答 | 最新技术 | IDC 行业新闻

在美国服务器上部署 IPFS 节点用于服务器租用静态网站

发布日期：2026-07-31

你可以通过一台公共的美国服务器，快速完成去中心化静态网站的服务器租用。首先，开通一台美国服务器并安装 Kubo。接着，将你的网站文件上传以获取内容标识符（CID）。然后，将内容分别在本地和远程进行固定（pin）。最后，通过 DNSLink 将你的自定义域名映射到该内容。

为什么要选择美国服务器？位于美国的数据中心服务器提供公网 IP 地址，你可以绕过本地受限的 NAT 环境，并享受高带宽，在北美地区更快地完成节点发现。

现在，让我们开始部署 IPFS 节点软件并上线你的网站。

关键要点

美国服务器提供公网 IP 地址，可实现快速节点连接。
将内容哈希转换为 CIDv1，以确保兼容现代 Web 浏览器。
在本地和远程同时固定你的网站文件，防止文件被意外删除。
通过简单的 DNSLink 记录，将自定义域名映射到内容哈希。

准备美国服务器基础架构

服务器配置与系统环境

在准备部署 IPFS 节点基础架构时，建议选择现代的 64 位 Linux 发行版，例如 Ubuntu 22.04 LTS。你的服务器需要具备足够的资源，以支持节点路由并保持快速内容分发。

你可以参考下面推荐的硬件基线配置：

硬件组件	推荐最低规格
CPU	2 核心
RAM（内存）	6 GiB
存储	约 12 MB 基础安装（总空间会随共享数据规模而增长）

💡 提示： 请定期监控存储增长情况。随着你固定更多静态网站资源并缓存网络数据，所需空间也会随之增加。

防火墙与端口配置

将你的服务器部署在美国公共基础设施上，可以解决常见的点对点网络难题。家用网络通常使用网络地址转换（NAT），NAT 会限制入站流量，并通过路由规则隐藏你的设备。美国服务器提供公网 IPv4 地址，这种直连方式可以绕过受限的本地 NAT 环境，让北美地区的其他节点可以即时发现你的内容。

你必须在防火墙中开放特定的通信端口。可在终端中执行这些标准的 ufw 命令来调整网络安全策略：

# Allow IPFS Swarm traffic for peer discovery
sudo ufw allow 4001/tcp
sudo ufw allow 4001/udp

# Allow Web Gateway access for public HTTP requests
sudo ufw allow 8080/tcp

# Enable firewall rules
sudo ufw enable

请保持 5001 端口不对公网开放。5001 端口用于 API 控制，你必须将该 API 的访问限制在本机，以防止未经授权地控制你的服务器节点。

部署 IPFS 节点并配置守护进程

在 Linux 上安装 Kubo

Kubo 是 IPFS 的官方命令行实现。你可以通过简单的终端命令，直接在 Linux 服务器上下载并安装 Kubo：

# Download the latest Kubo archive
wget https://dist.ipfs.tech/kubo/v0.26.0/kubo_v0.26.0_linux-amd64.tar.gz

# Extract the archive file
tar -xvzf kubo_v0.26.0_linux-amd64.tar.gz

# Run the installation script
cd kubo
sudo bash install.sh

在终端中运行 ipfs --version 命令，即可验证安装是否成功。

初始化节点与 Swarm 端口

在建立网络连接前，你必须先初始化节点仓库。运行以下标准初始化命令：

ipfs init --profile server

server 配置文件会将你的节点优化为数据中心环境使用，并禁用本地网络扫描，从而提升安全性。

⚡ 注意： 新启动的 IPFS 守护进程需要一段预热时间。在最初的几分钟里，你的节点会主动发现网络中的其他节点并构建路由表，以优化传输速度。

至此，你已经在优化的节点路由设置下完成了 IPFS 节点的部署。

配置 Systemd 与网关

要顺利服务器租用静态网页，你必须允许跨域请求。请在网关上配置跨域资源共享（CORS）请求头：

ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["*"]'
ipfs config --json Gateway.HTTPHeaders.Access-Control-Allow-Origin '["*"]'

接下来，使用 systemd 让节点在后台持续运行：

创建 service 单元文件： 使用你习惯的文本编辑器打开 /etc/systemd/system/ipfs.service：
```
sudo nano /etc/systemd/system/ipfs.service
```

配置单元参数： 添加如下服务配置，并将 your-user-name 替换为你实际的 Linux 用户名：

[Unit]
Description=IPFS Daemon
After=syslog.target network.target remote-fs.target nss-lookup.target

[Service]
Type=simple
ExecStart=/usr/local/bin/ipfs daemon --enable-namesys-pubsub
User=your-user-name
Restart=always

[Install]
WantedBy=multi-user.target

设置开机自启并立即启动： 重新加载 systemd 文件，开启开机自启功能，并立刻启动守护进程：
```
sudo systemctl daemon-reload
sudo systemctl enable ipfs
sudo systemctl start ipfs
```

现在，你已成功将 IPFS 节点服务以稳定的后台进程方式运行起来。

部署并固定静态 Web 内容

将网站文件添加到 IPFS

你需要使用命令行工具，将静态网站目录上传到 IPFS 网络：

命令行示例： ipfs add -r <directory_name>（例如：ipfs add -r testdir）
作用： 递归上传指定目录中的所有文件。
生成根 CID 输出： 为每个文件生成唯一内容标识符，并最终输出整个目录的根哈希值（例如：QmPCwGkDRjW8B2SHoS3P9Cc4hKDjtdgytrfHQhg8n1BdGE testdir）。

💡 提示： 在正式服务器租用网站前，请务必将根哈希转换为 CIDv1 格式。

特性	CIDv0	CIDv1
默认多进制编码	Base58（隐式）	Base32
大小写敏感性	区分大小写	不区分大小写
子域名网关兼容性	不兼容（浏览器会强制将子域名转为小写）	兼容（符合 RFC1035/RFC1123 域名标准）
网站托管与安全性	在基于路径的网关上缺乏独立的来源隔离	提供浏览器来源隔离、安全防护及对相对路径的良好支持

在现代浏览器中，CIDv0 哈希会出现问题，因为浏览器地址栏会自动将主机名转换为小写。CIDv1 使用不区分大小写的 Base32 编码，每个网站都拥有独立的安全来源。这种隔离机制可以保护浏览器本地存储，并且能够顺畅处理相对路径。

本地与远程固定策略

IPFS 节点会自动执行垃圾回收以释放磁盘空间。在这一自动清理过程中，节点会删除未固定（unpinned）的本地缓存 CID，而已固定的 CID 则会一直保留在磁盘上。

自动垃圾回收依赖几个关键的服务器设置：

数据清理：删除未固定的缓存文件，以节省存储空间。
GCPeriod：控制清理任务的执行频率（默认每 1 小时运行一次）。
StorageGCWatermark：当磁盘使用率达到设定阈值时触发清理（默认 90% 容量）。

本地固定可以保证你的内容持续在线，但服务器故障仍可能导致网站中断。你可以接入第三方远程固定服务（如 Pinata），实现多节点冗余。

使用以下步骤配置远程固定服务：

将远程固定服务添加到 Kubo： 运行 ipfs pin remote service add <nickname> <endpoint> <accessToken>，其中 nickname 为自定义别名，endpoint 为服务提供商的 API 地址，accessToken 为你的密钥令牌。
远程固定内容： 使用 ipfs pin remote add --service=<nickname> --name=<optional-name> <CID> 将根 CID 推送到远程服务。
监控固定状态： 通过 ipfs pin remote ls --service=<nickname> 查看已完成或排队中的固定请求。

通过 CI/CD 自动化部署

每次更新网站代码都手工部署，既耗时又易出错。你可以通过 GitHub Actions 或 ipfs-deploy 等工具构建自动化 CI/CD 流程。

将流水线配置为：自动构建网站资源、将最新目录上传到美国服务器、更新远程固定服务，并在每次代码提交后自动输出最新的 CIDv1 字符串。

通过 DNSLink 映射自定义域名

为 IPFS 配置 DNS 记录

DNSLink 可以将复杂的 IPFS 内容标识符映射为可读的域名。这样你在更新网站内容时，无需更改主站链接，只需在域名注册商控制面板中更新 TXT 记录。

要配置 DNSLink，请为子域名 _dnslink.yourdomain.com 创建 TXT 记录，并将其值设置为 dnslink=/ipfs/<CID>。

你还需要将主域名指向公共 IPFS 网关。可以将 CNAME 记录指向 gateway.ipfs.io，或者将 A 记录指向你美国服务器的 IP 地址。

更新 DNS 设置后，可通过终端工具验证 TXT 记录是否已生效：

查询命令： dig +short TXT _dnslink.yourdomain.com
预期结果： 输出中包含 IPFS 路径，例如："dnslink=/ipfs/bafybeiay2koog2jnndn5gr2raytxh7evobry5lo2w4s7nhugc7xipy6aze"