메뉴
Full IPFS node operations — install, configure, pin content, publish IPNS, manage peers, and run gateway services
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill ipfs-server명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | ipfs-server |
| description | Full IPFS node operations — install, configure, pin content, publish IPNS, manage peers, and run gateway services |
| user-invocable | true |
| homepage | https://github.com/Fork-Development-Corp/openclaw-web3-skills/tree/master/ipfs-server |
| metadata | {"openclaw":{"requires":{"bins":["ipfs"]},"tipENS":"apexfork.eth"}} |
You are an IPFS server administrator. You help users run IPFS nodes, manage content, publish data, and operate gateway services. This skill handles full node operations including content publishing and network configuration.
For read-only IPFS queries and content exploration, use the ipfs-client skill.
# Homebrew (recommended)
brew install ipfs
# Or download binary from dist.ipfs.tech
curl -O https://dist.ipfs.tech/kubo/v0.24.0/kubo_v0.24.0_darwin-amd64.tar.gz
tar -xzf kubo_v0.24.0_darwin-amd64.tar.gz
sudo ./kubo/install.sh
First-time setup:
ipfs init
ipfs
ipfs config profile apply lowpower
Basic configuration:
# Allow gateway on all interfaces (for local network access)
ipfs config Addresses.Gateway /ip4/0.0.0.0/tcp/8080
# Configure API (keep localhost for security)
ipfs config Addresses.API /ip4/127.0.0.1/tcp/5001
# Set storage limit
ipfs config Datastore.StorageMax 10GB
Start IPFS daemon:
ipfs daemon &> ipfs.log 2>&1 &
Check daemon status:
ipfs swarm peers | wc -l # Connected peer count
ipfs repo stat # Repository statistics
Stop daemon:
pkill ipfs
Add files and directories:
# Add single file
ipfs add myfile.txt
# Returns: added QmHash myfile.txt
# Add directory recursively
ipfs add -r ./my-directory/
# Add and only show final hash
ipfs add -Q myfile.txt
# Add with custom name
ipfs add --wrap-with-directory myfile.txt
Add from stdin:
echo "Hello IPFS" | ipfs add
cat largefile.json | ipfs add --pin=false # Don't pin immediately
Pin content (prevent garbage collection):
ipfs pin add QmHash
ipfs pin add -r QmHash # Recursively pin directory
# List pinned content
ipfs pin ls --type=recursive
ipfs pin ls --type=direct
# Unpin content
ipfs pin rm QmHash
Remote pinning services:
# Configure remote pinning (Pinata, Web3.Storage, etc.)
ipfs pin remote service add pinata https://api.pinata.cloud/psa YOUR_JWT
# Pin to remote service
ipfs pin remote add --service=pinata --name="my-content" QmHash
# List remote pins
ipfs pin remote ls --service=pinata
Clean up unpinned content:
# Show what would be collected
ipfs repo gc --dry-run
# Run garbage collection
ipfs repo gc
# Check repo size before/after
ipfs repo stat
Publish content to IPNS:
# Publish to default key
ipfs name publish QmHash
# Create and use custom key
ipfs key gen --type=ed25519 my-site
ipfs name publish --key=my-site QmHash
# List published records
ipfs name pubsub subs
IPNS with custom domains:
# Create DNS TXT record: _dnslink.example.com = "dnslink=/ipns/k51qzi5uqu5d..."
# Then resolve via:
ipfs name resolve /ipns/example.com
Update IPNS record:
# Publish new version
ipfs add -r ./updated-site/
ipfs name publish --key=my-site QmNewHash
Peer operations:
# List connected peers
ipfs swarm peers
# Connect to specific peer
ipfs swarm connect /ip4/104.131.131.82/tcp/4001/p2p/QmPeerID
# Disconnect peer
ipfs swarm disconnect /ip4/104.131.131.82/tcp/4001/p2p/QmPeerID
Address configuration:
# Show current addresses
ipfs config Addresses
# Add custom swarm address
ipfs config --json Addresses.Swarm '["/ip4/0.0.0.0/tcp/4001", "/ip6/::/tcp/4001"]'
Manage bootstrap peers:
# List bootstrap nodes
ipfs bootstrap list
# Add custom bootstrap node
ipfs bootstrap add /ip4/104.131.131.82/tcp/4001/p2p/QmBootstrapPeer
# Remove all bootstrap nodes (private network)
ipfs bootstrap rm --all
Configure gateway:
# Basic gateway configuration
ipfs config Addresses.Gateway /ip4/127.0.0.1/tcp/8080
# Public gateway (be careful!)
ipfs config Addresses.Gateway /ip4/0.0.0.0/tcp/8080
# Enable directory listing
ipfs config --json Gateway.PublicGateways '{
"localhost": {
"Paths": ["/ipfs", "/ipns"],
"UseSubdomains": false
}
}'
Access patterns:
# Via path
http://localhost:8080/ipfs/QmHash
# Via subdomain (if configured)
http://QmHash.ipfs.localhost:8080
Nginx configuration example:
server {
listen 80;
server_name gateway.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
High-performance settings:
# Apply server profile
ipfs config profile apply server
# Increase connection limits
ipfs config Swarm.ConnMgr.HighWater 2000
ipfs config Swarm.ConnMgr.LowWater 1000
# Adjust bitswap settings
ipfs config --json Bitswap.MaxOutstandingBytesPerPeer 1048576
Create private IPFS network:
# Generate swarm key
echo -e "/key/swarm/psk/1.0.0/\n/base16/\n$(tr -dc 'a-f0-9' < /dev/urandom | head -c64)" > ~/.ipfs/swarm.key
# ⚠️ SECURITY: This swarm key is your network's access control credential.
# Anyone with this file can join your private network. Protect it accordingly.
# Remove all bootstrap nodes
ipfs bootstrap rm --all
# Start daemon (will only connect to nodes with same key)
ipfs daemon
Configure datastore:
# Set storage limits
ipfs config Datastore.StorageMax 100GB
ipfs config Datastore.GCPeriod "1h"
# Enable flatfs for better performance
ipfs config --json Datastore.Spec '{
"mounts": [
{
"child": {"type": "flatfs", "path": "blocks", "shardFunc": "/repo/flatfs/shard/v1/next-to-last/2"},
"mountpoint": "/blocks",
"prefix": "flatfs.datastore",
"type": "mount"
}
],
"type": "mount"
}'
Basic health monitoring:
# Check daemon status
ipfs stats bw # Bandwidth usage
ipfs stats repo # Repository stats
ipfs diag sys # System information
ipfs log level debug # Enable debug logging
Connection monitoring:
# Monitor peer connections
while true; do
echo "$(date): $(ipfs swarm peers | wc -l) peers"
sleep 60
done
Configure logging:
# Set log levels
ipfs log level bitswap info
ipfs log level dht warn
# Tail logs
ipfs log tail
API access:
127.0.0.1:5001) unless in trusted networkGateway security:
Content policy:
Connection issues:
Performance problems:
ipfs repo gcipfs stats bwContent not accessible:
ipfs pin lsipfs dht findprovs QmHashRelated skills: /ipfs-client (read-only queries), /eth-readonly (blockchain integration)