clickclack 是做什么的?
用于 ClickClack 产品/运行时运维、部署、托管应用检查以及域名相关问题。
概述
- 仓库:
~/Projects/clickclack/https://github.com/openclaw/clickclack - 产品:针对 OpenClaw/社区/代理工作流的自托管类 Slack 聊天应用。
- 表面:
https://clickclack.chat产品站点https://app.clickclack.chat托管应用https://docs.clickclack.chatGitHub 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
部署
黄金路径:
- 本地刷新:
cd ~/Projects/clickclackgit status --short --branchgit fetch origin- 如果在
main分支且无上游:git merge --ff-only origin/main
- 确定已部署的差异:
- 上次已知部署可能是拉取前的旧本地
HEAD;若存在请验证/opt/clickclack-src/.deploy-commit。 git log --oneline <old>..HEADgit diff --stat <old>..HEAD
- 上次已知部署可能是拉取前的旧本地
- 仅存档干净的 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"
- 不打印机密信息的情况下保留环境变量:
docker inspect clickclack --format '{{range .Config.Env}}{{println .}}{{end}}' > /root/clickclack.env.current
- 迁移前备份:
mkdir -p /var/lib/clickclack/backupschown 1000:1000 /var/lib/clickclack/backupsdocker exec clickclack clickclack backup --data /app/data --out /app/data/backups/clickclack-before-$(date -u +%Y%m%dT%H%M%SZ).db
- 构建:
docker build --label org.opencontainers.image.revision="$short" -t clickclack:"$short" -t clickclack:latest /opt/clickclack-src.next
- 替换容器:
docker stop clickclack && docker rm clickclackdocker 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
- 轮换源码目录:
- 将旧的
/opt/clickclack-src.prev移动到带时间戳的备份。 - 将
/opt/clickclack-src移动到/opt/clickclack-src.prev。 - 将
/opt/clickclack-src.next移动到/opt/clickclack-src。
- 将旧的
验证
- 主机:
docker ps --filter name=clickclackdocker inspect clickclack --format '{{index .Config.Labels "org.opencontainers.image.revision"}}'cat /opt/clickclack-src/.deploy-commitcurl -fsS http://127.0.0.1:8080/ >/tmp/clickclack-root.htmlcurl -fsS http://127.0.0.1:8080/app >/tmp/clickclack-app.html
- 公网:
curl -I https://clickclack.chatcurl -I https://app.clickclack.chatcurl -I https://docs.clickclack.chat
安全护栏
- 不要打印 OAuth 机密或魔法令牌。
- 如果本地 SSH 主机密钥状态过期,请使用一次性
UserKnownHostsFile;先用hcloud server describe clickclack-prod-01确认服务器身份。 clickclack serve在启动时运行迁移;替换容器前始终备份 SQLite。- 坚持从干净的 git 存档部署,不要使用脏的工作树。