● 社群
glitternetwork
⚡ 即開即用
pinme
作者 glitternetwork · glitternetwork/pinme
零設定前端部署至 IPFS,只需一個 CLI 指令 — Claude 執行 pinme upload dist 並回傳預覽網址。
PinMe 是一個 CLI + Claude Skill,可透過單一指令將靜態網站(dist/build/out/public)部署至 IPFS,無需帳號或伺服器。此 Skill 內含 AI Execution Protocol,讓 Claude 確切知道如何驗證 Node、安裝 CLI、偵測正確的建置資料夾,並將預覽網址回傳給使用者。
為什麼要用
核心特性
- 單一指令部署至 IPFS — 無需帳號,無需設定伺服器
- 自動偵測建置輸出資料夾(dist/、build/、out/、public/)
- Skill 內含 AI Execution Protocol:驗證 Node → 安裝 → 偵測資料夾 → 部署 → 回傳網址
- 回傳可立即分享的預覽網址
- 相容任何靜態網站產生器(Vite、Next export、Astro、SvelteKit static 等)
使用場景
實戰用法: pinme
何時使用: 你想分享預覽連結,但不想設定 Vercel/Netlify,只需要一個原始連結。
前置條件
- 已安裝 Node.js — node >= 18 — Skill 會自動驗證
- 已建置好的靜態網站 — 執行你所用框架的建置指令(例如 npm run build)
步驟
-
請 Claude 進行部署
Build this Astro site and deploy it with pinme.✓ 已複製
→ Claude 執行建置、偵測 dist/、若缺少 pinme 則安裝,並執行上傳
-
取得網址
(no prompt — just wait)✓ 已複製
→ 預覽網址顯示於對話中
結果: 一個可分享的 IPFS 託管預覽連結。
注意事項
- 偵測到錯誤的資料夾(例如同時存在 dist/ 和 build/) — 明確告知 Claude:'upload from build/'
- IPFS 閘道首次載入較慢 — 此為預期行為 — 後續載入會從快取讀取
何時使用: 你正在迭代開發原型,並希望每個版本都有可分享的連結。
步驟
-
每次變更後建置並部署
Every time I say 'ship', rebuild and upload via pinme, then post the URL.✓ 已複製
→ Claude 建立固定節奏:建置 → 部署 → 回傳網址
結果: 每次迭代版本皆有對應的預覽連結紀錄。
注意事項
- 每次部署的 IPFS CID 都會變更(此為預期行為) — 若需穩定網址,請使用 ENS 或 DNSLink
組合
與其他 MCP 搭配,撬動十倍槓桿
Claude 撰寫或編輯網站內容後,直接在同一個工作階段中透過 pinme 完成部署
Edit the hero copy, rebuild, then pinme upload dist — give me the new URL.✓ 已複製
在同一輪對話中提交變更並產生預覽網址
Commit the change on a branch, deploy via pinme, and put the preview URL in the PR description.✓ 已複製
成本與限制
運行它的成本
- API 配額
- PinMe 免費方案有用量上限;請至 pinme.eth 查看目前限制
- 每次呼叫 Token 數
- 極少 — 此 Skill 體積很小
- 費用
- 提供免費方案;需要更大容量或更持久釘選的需求可升級付費方案
- 提示
- 讓測試用預覽連結自然過期;只將正式環境的網址進行長期釘選。
安全
權限、密鑰、影響範圍
憑證儲存: 匿名上傳無需任何憑證。可選擇性提供帳號金鑰以維持釘選持久性。
資料出站: 上傳的封包會進入 IPFS — 設計上即為公開存取。切勿上傳機密資訊、.env 檔案或非公開資產。
- IPFS 內容為完全公開 — 上傳資料夾中的任何內容均可被全球任何人讀取。
故障排查
常見錯誤與修復
pinme: command not found
Skill 應會自動安裝;若受阻可手動執行 npm i -g pinme。
驗證: pinme --version
Upload hangs
請檢查網路連線;部分企業防火牆會封鎖 IPFS 啟動節點。
Wrong folder uploaded
請明確指定路徑:使用 pinme upload ./dist,而非依賴自動偵測。
替代方案
pinme 對比其他方案
| 替代方案 | 何時用它替代 | 權衡 |
| Vercel / Netlify | 你需要自訂網域、Serverless 函式或 CI 整合 | 功能更豐富,但需要帳號與額外設定 |
| GitHub Pages | 你的程式碼在 GitHub 上,且希望擁有穩定的 github.io 網址 | 與特定儲存庫綁定;部署循環較慢 |