搭建基于Gitee文檔筆記自動發布
由于現在gitee不支持代理靜態頁面，并且github.io需要VPN，實際使用的話gitee更為方便。
一、為服務器和個人PC添加免密push和pull
參考鏈接：https://help.gitee.com/base/account/SSH%E5%85%AC%E9%92%A5%E8%AE%BE%E7%BD%AE
二、創建webhooks
創建webhooks目的是用于監聽gitee倉庫的push事件，自動觸發服務器端pull更新代碼和文檔筆記。
三、創建服務監聽
1、創建監聽腳本文件
vim gitee-hook.sh
#!/bin/bash#Git 倉庫所在目錄，即執行 git pull 的工作目錄
WORK_DIR="/root/helloops/"
#日志文件路徑，記錄腳本執行過程和結果
LOG_FILE="/root/gitee-hooks/hook.log"#將帶時間戳的日志信息追加到 LOG_FILE
#示例輸出：[20250630-143000] Starting git pull...
log() {echo "[$(date '+%Y%m%d-%H:%M:%S')] $1" >> $LOG_FILE
}#切換到工作目錄并執行 git pull，將執行過程逐行記錄到日志
execute_git_pull() {log "start git pull..."cd $WORK_DIR || { log "not cd workdir"; exit 1; }/usr/bin/git pull 2>&1 | while read line; dolog "git pull: $line"donelog "git pull started..."
}#解析 Gitee Webhook 發送的 HTTP 請求，驗證 Token 并執行更新
parse_request(){while read -r line; do#根據自己設置的密碼進行更換if [[ $line == "X-Gitee-Token: 123456" ]]; then VALID_TOKEN=truefiif [ -z "$line" ]; thenbreakfidonebody=$(cat)log "input gitee hook requests,Body size: ${#body}"execute_git_pull
}parse_request
2、創建監聽服務文件
sudo cat > /lib/systemd/system/gitee-hook.service << 'EOF'
[Unit]
Description=Gitee Webhook Listener
After=network.target[Service]
Type=simple
ExecStart=/usr/bin/socat TCP-LISTEN:8080,fork EXEC:"/root/gitee-hook.sh"
WorkingDirectory=/root/gitee-hooks
User=root
Group=root
Restart=on-failure
RestartSec=5s
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=gitee-hook[Install]
WantedBy=multi-user.target
EOF#創建日志存儲目錄并授權腳本
sudo mkdir -p /root/gitee-hooks
sudo chmod +x /root/gitee-hook.sh#檢查 socat 是否安裝
which socat || sudo apt-get install socat -y # Debian/Ubuntu
which socat || sudo yum install socat -y # CentOS/RHEL#重載 systemd 配置并啟動
sudo systemctl daemon-reload
sudo systemctl start gitee-hook#設置開機啟動并查看狀態
sudo systemctl enable gitee-hook
sudo systemctl status gitee-hook四、測試操作
1、安裝pandoc
apt -y install pandoc
2、整個流程操作
pandoc sources/md/KL-Ubuntu/搭建基于Gitee文檔筆記自動發布.md -s -o html/KL-Ubuntu/搭建基于Gitee文檔筆記 自動發布.htmlgit add . git status git commit -m "add **"git push
五、Nginx配置參考以及目錄結構參考
server {charset utf-8;server_name abc.cn www.abc.cn;client_max_body_size 1024m;gzip on;location / {alias /root/helloops/html/; autoindex on;}location /yaml {alias /root/helloops/yaml/;autoindex on;}location /windos {alias /root/helloops/sources/windos/;autoindex on;auth_basic "Restricted Access";auth_basic_user_file /etc/nginx/.htpasswd;add_header Cache-Control "no-cache, no-store, must-revalidate";add_header Pragma "no-cache";add_header Expires 0;}location /sources/images {alias /root/helloops/sources/images/;autoindex on;}listen 443 ssl; # managed by Certbotssl_certificate /etc/letsencrypt/live/helloops.cn/fullchain.pem; # managed by Certbotssl_certificate_key /etc/letsencrypt/live/helloops.cn/privkey.pem; # managed by Certbotinclude /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbotssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}
server {if ($host = www.helloops.cn) {return 301 https://$host$request_uri;} # managed by Certbotif ($host = helloops.cn) {return 301 https://$host$request_uri;} # managed by Certbotlisten 80;server_name abc.cn www.abc.cn;}
目錄結構
root@helloops# tree -d
.
├── html
│ ├── k8s
│ └── KL-Ubuntu
├── sources
│ ├── images
│ ├── md
│ │ ├── k8s
│ │ └── KL-Ubuntu
│ └── windos
└── yaml10 directories
