kb-web/deploy/README.md

kb-web 自动部署配置

架构

本地 push → Gitea (192.168.1.22) → Webhook → micecola.top
                                              ├── /var/www/kb-web-test (测试 :8080)
                                              └── /var/www/kb-web-prod  (正式域名)

快速配置

第一步：在服务器执行配置脚本

# SSH 登录服务器
ssh root@micecola.top

# 下载并执行配置脚本
curl -fsSL https://raw.githubusercontent.com/你的仓库/deploy/setup-server.sh | bash

# 或者直接复制脚本内容执行

第二步：添加 Gitea 部署密钥

服务器执行后会显示一个公钥，将它添加到 Gitea：

1. 打开 https://192.168.1.22 用户设置 → SSH Keys
2. 或在仓库设置 → Deploy Keys
3. 粘贴公钥内容

第三步：配置 Gitea Webhook

在 Gitea 仓库 kb-web 的设置中：

配置项	值
URL	http://micecola.top:8080/webhook/receiver.php
密钥	kb-web-webhook-secret-2024
触发事件	Push
分支过滤	main

第四步：测试

# 本地修改后推送
git push origin main

# 查看服务器日志
ssh root@micecola.top "tail -f /var/log/webhook.log"

访问地址

环境	地址
测试	http://micecola.top:8080
正式	https://kb.micecola.top (需配置域名)

手动部署

# 测试环境
/var/www/webhook/deploy.sh test main

# 正式环境
/var/www/webhook/deploy.sh prod main

正式环境部署流程

推荐流程：先测试环境验证 → 再手动部署正式环境

# 1. push 自动部署到测试环境
git push origin main

# 2. 验证测试环境 OK
# 访问 http://micecola.top:8080

# 3. 手动部署到正式环境
ssh root@micecola.top "/var/www/webhook/deploy.sh prod main"

文件说明

deploy/
├── setup-server.sh      # 服务器一键配置脚本
├── deploy.sh            # 部署脚本 (部署到服务器 /var/www/webhook/)
├── webhook-receiver.php # Webhook 接收器 (部署到服务器)
└── README.md            # 本文档

回滚

# 查看备份
ls /var/www/kb-web-test-backups/

# 恢复备份
tar -xzf /var/www/kb-web-test-backups/backup_xxx.tar.gz -C /var/www/kb-web-test