privazio/ipfs-dns-deploy

privazio/ipfs-dns-deploy 镜像说明

镜像概述

本镜像作为CI/CD流程的辅助工具，帮助开发者高效完成内容发布到IPFS网络的操作，并自动更新对应的DNS记录，简化IPFS内容发布与域名解析关联的全流程，提升开发部署效率。

核心功能

1. IPFS内容发布：支持将指定目录或文件上传至IPFS网络，获取内容哈希值；
2. DNS记录更新：集成主流DNS服务商（如Cloudflare、AWS Route53等）的API，自动将IPFS哈希值关联到目标域名；
3. CI/CD适配：可无缝集成到GitHub Actions、GitLab CI等常见CI/CD平台，实现自动化部署流程。

使用场景

1. 静态网站部署：将静态网站资源发布到IPFS，并通过DNS解析让用户通过域名访问IPFS上的网站；
2. 分布式内容分发：将文件、数据等资源发布到IPFS网络，同时更新DNS记录，方便用户快速访问；
3. 自动化CI/CD流程：在持续集成/部署 pipeline 中，自动完成IPFS发布与DNS更新步骤，减少人工操作。

配置说明

需通过环境变量配置以下参数：

• IPFS_NODE_URL：IPFS节点的API地址（如 https://ipfs.infura.io:5001）；
• DNS_PROVIDER：DNS服务商名称（支持 cloudflare、route53 等）；
• DNS_API_KEY：DNS服务商的API密钥；
• DOMAIN_NAME：目标域名（如 example.com）；
• IPFS_HASH：已发布到IPFS的内容哈希值（或由镜像自动生成）。

部署示例

Docker Run 命令

bash
docker run -e IPFS_NODE_URL=https://ipfs.infura.io:5001 \
  -e DNS_PROVIDER=cloudflare \
  -e DNS_API_KEY=your_cloudflare_api_key \
  -e DOMAIN_NAME=your.domain.com \
  -e IPFS_HASH=QmXYZ123... \
  docker.xuanyuan.run/privazio/ipfs-dns-deploy

GitHub Actions 集成示例

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Publish to IPFS and update DNS
        uses: docker://privazio/ipfs-dns-deploy
        env:
          IPFS_NODE_URL: ${{ secrets.IPFS_NODE_URL }}
          DNS_PROVIDER: cloudflare
          DNS_API_KEY: ${{ secrets.CLOUDFLARE_API_KEY }}
          DOMAIN_NAME: ${{ secrets.DOMAIN_NAME }}
          IPFS_HASH: ${{ steps.ipfs-publish.outputs.hash }}