Community研究与数据分析github.com

steipete/clickclack

ClickClack 运维:聊天应用、Hetzner 部署、DNS/文档/应用、Docker 滚动更新。

clickclack 是什么?

ClickClack 技能用于管理自托管的类 Slack 聊天应用,涵盖产品运维、部署、应用健康检查和域名管理。它定义了一条黄金部署路径,涉及从本地 Git 仓库归档、通过 SSH 传输到 Hetzner 云服务器、构建 Docker 镜像、替换运行中的容器,并包含备份与回滚机制。该技能支持 Hetzner、Docker 和 GitHub Pages 等平台,并提供了详细的验证步骤来确认主机与公共端点的可用性。其核心价值在于为 AI 代理提供了一套可重复、可审计的操作流程,同时内置了防止机密泄露和确保数据安全的多重防护措施。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/clickclack

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

clickclack 是做什么的?

用于 ClickClack 产品/运行时运维、部署、托管应用检查以及域名相关问题。

概述

  • 仓库:~/Projects/clickclack / https://github.com/openclaw/clickclack
  • 产品:针对 OpenClaw/社区/代理工作流的自托管类 Slack 聊天应用。
  • 表面:
    • https://clickclack.chat 产品站点
    • https://app.clickclack.chat 托管应用
    • https://docs.clickclack.chat GitHub Pages 文档(来自 docs/)

生产环境

  • Hetzner:clickclack-prod-01
  • IPv4:157.90.237.80
  • IPv6:2a01:4f8:1c1c:fb96::/64
  • SSH:[email protected]
  • 标签:app=clickclack,env=prod
  • 操作系统:Ubuntu 24.04,Caddy + Docker
  • 主机上源码位置:/opt/clickclack-src(干净的导出,非 git 检出)
  • 之前的源码:/opt/clickclack-src.prev 以及带时间戳的更旧目录
  • 数据:/var/lib/clickclack 绑定挂载到 /app/data
  • 容器:clickclack,端口 127.0.0.1:8080->8080
  • Caddy:/etc/caddy/Caddyfile 代理 clickclack.chat, app.clickclack.chat 到 127.0.0.1:8080;www 重定向到主域名。
  • DNS 真相:~/Projects/manager/DOMAINS.md 和 ~/Projects/manager/DNS.md

部署

黄金路径:

  1. 本地刷新:
    • cd ~/Projects/clickclack
    • git status --short --branch
    • git fetch origin
    • 如果在 main 分支且无上游:git merge --ff-only origin/main
  2. 确定已部署的差异:
    • 上次已知部署可能是拉取前的旧本地 HEAD;若存在请验证 /opt/clickclack-src/.deploy-commit。
    • git log --oneline <old>..HEAD
    • git diff --stat <old>..HEAD
  3. 仅存档干净的 HEAD:
    • 不要 rsync 未跟踪的本地文件。
    • short=$(git rev-parse --short=12 HEAD)
    • git archive --format=tar HEAD | ssh [email protected] "rm -rf /opt/clickclack-src.next && mkdir -p /opt/clickclack-src.next && tar -C /opt/clickclack-src.next -xf - && printf '%s\n' '$short' > /opt/clickclack-src.next/.deploy-commit"
  4. 不打印机密信息的情况下保留环境变量:
    • docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
  5. 迁移前备份:
    • mkdir -p /var/lib/clickclack/backups
    • chown 1000:1000 /var/lib/clickclack/backups
    • docker exec clickclack clickclack backup --data /app/data --out /app/data/backups/clickclack-before-$(date -u +%Y%m%dT%H%M%SZ).db
  6. 构建:
    • docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
  7. 替换容器:
    • docker stop clickclack && docker rm clickclack
    • docker run -d --name clickclack --restart unless-stopped --env-file /root/clickclack.env.current -p 127.0.0.1:8080:8080 -v /var/lib/clickclack:/app/data clickclack:latest serve --addr :8080 --data /app/data
  8. 轮换源码目录:
    • 将旧的 /opt/clickclack-src.prev 移动到带时间戳的备份。
    • 将 /opt/clickclack-src 移动到 /opt/clickclack-src.prev。
    • 将 /opt/clickclack-src.next 移动到 /opt/clickclack-src。

验证

  • 主机:
    • docker ps --filter name=clickclack
    • docker inspect clickclack --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'
    • cat /opt/clickclack-src/.deploy-commit
    • curl -fsS http://127.0.0.1:8080/ >/tmp/clickclack-root.html
    • curl -fsS http://127.0.0.1:8080/app >/tmp/clickclack-app.html
  • 公网:
    • curl -I https://clickclack.chat
    • curl -I https://app.clickclack.chat
    • curl -I https://docs.clickclack.chat

安全护栏

  • 不要打印 OAuth 机密或魔法令牌。
  • 如果本地 SSH 主机密钥状态过期,请使用一次性 UserKnownHostsFile;先用 hcloud server describe clickclack-prod-01 确认服务器身份。
  • clickclack serve 在启动时运行迁移;替换容器前始终备份 SQLite。
  • 坚持从干净的 git 存档部署,不要使用脏的工作树。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相关技能