clickclack 是做什麼的?
用於 ClickClack 產品/運行操作、部署、託管應用檢查以及網域相關問題。
概述
- 儲存庫:
~/Projects/clickclack/https://github.com/openclaw/clickclack - 產品: 適用於 OpenClaw/社群/AI 代理工作流程的自託管 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 歸檔進行部署,不要使用髒的工作目錄。