🏗️ DIGGERKIT 部署指南

从零开始在自有 VPS 上部署 DIGGERKIT 私有化版本。约需 30 分钟完成。

📌 部署方式说明

本指南覆盖 SUPER / PREMIUM 套餐用户的远程部署协助流程。PREMIUM 含全程部署支持，SUPER 含 1 次远程协助。联系 gdana@agentmail.to 预约。

📋 第一步：准备服务器

▶ 服务器推荐配置

推荐服务商	腾讯云轻量应用服务器 / 阿里云 ECS / Vultr / DigitalOcean
CPU	2 核以上
内存	4 GB 以上
存储	50 GB SSD 以上
系统	Ubuntu 22.04 LTS / Debian 12
域名	已解析好的域名（非必须，纯 IP 也可访问）

⚠️ 防火墙要求

确保以下端口开放：80（HTTP）、443（HTTPS）、22（SSH）。在云服务商控制台的安全组里放通。

▶ 腾讯云轻量应用服务器特别说明

腾讯云轻量应用服务器默认防火墙可能只开放 22/80/443，需要手动在控制台添加规则放通 SSH 端口（如果修改过默认 SSH 端口）。

# 腾讯云控制台 → 防火墙 → 添加规则
# 协议: TCP | 端口: 22,80,443 | 来源: 0.0.0.0/0

腾讯云轻量应用服务器默认开启云防火墙，如遇连接问题检查云防火墙日志。

⚙️ 第二步：安装 DIGGERKIT

▶ 方式A：全自动部署脚本（推荐）

SSH 登录服务器后，运行一键部署脚本：

curl -fsSL https://golddigger.gold/scripts/deploy.sh | bash -s -- --api-key YOUR_API_KEY --domain yourdomain.com

脚本自动完成：安装 Docker → Caddy 反代 → 数据库初始化 → SSL 证书 → 启动服务。

✅ 预计时间

5~15 分钟（取决于服务器配置和网络速度）。

▶ 方式B：手动部署（DOCKER）

# 1. 安装 Docker
curl -fsSL https://get.docker.com | sh

# 2. 创建工作目录
mkdir -p /opt/diggerkit && cd /opt/diggerkit

# 3. 下载 docker-compose.yml
wget https://golddigger.gold/scripts/docker-compose.yml

# 4. 配置环境变量
cat > .env << 'EOF'
DIGGERKIT_API_KEY=gd_live_your_key_here
DIGGERKIT_DOMAIN=yourdomain.com
LOG_LEVEL=info
EOF

# 5. 启动
docker-compose up -d

# 6. 查看状态
docker-compose ps

▶ 方式C：源码部署（无 Docker）

# 系统依赖
apt update && apt install -y python3.11 python3-pip python3-venv nginx certbot

# Python 虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 配置 Caddy（反向代理 + 自动 HTTPS）
# 编辑 /etc/caddy/Caddyfile
# 参考部署指南域名配置章节

# 启动服务
python3 server.py &

# 获取 SSL 证书
certbot --nginx -d yourdomain.com

🔧 第三步：配置

▶ 环境变量配置

核心配置项（/opt/diggerkit/.env）：

DIGGERKIT_API_KEY	你的 API Key（必填）
DIGGERKIT_DOMAIN	访问域名，如 golddigger.gold
LOG_LEVEL	日志级别：debug / info / warning（默认 info）
WHATSAPP_SESSION	WhatsApp 会话文件路径
SUPABASE_URL	Supabase 项目地址（SUPER/PREMIUM 套餐用户）
SUPABASE_KEY	Supabase anon/public key

▶ Caddyfile 配置（反向代理 + HTTPS）

编辑 /etc/caddy/Caddyfile：

yourdomain.com {
    reverse_proxy localhost:8080
    encode gzip

    # 可选：自定义 header
    header -server
    header X-Frame-Options "SAMEORIGIN"
}

# 重载 Caddy
caddy reload --config /etc/caddy/Caddyfile

🌐 第四步：域名解析

将你的域名 A 记录指向服务器 IP：

主机记录	@ 或 golddigger
记录类型	A
记录值	你的服务器 IP（如 82.156.5.235）
TTL	600（自动）

⏱️ DNS 生效时间

新增/修改 A 记录后，一般 5~30 分钟生效。修改现有记录可能需要更长时间（最长 48 小时）。

📱 第五步：WhatsApp Business 集成

▶ WhatsApp Business API 配置

注册 WhatsApp Business 账号
创建 Business Portfolio，获取 WABA ID
申请 WhatsApp Business API 访问权限
配置 Webhook URL 为 https://yourdomain.com/api/v2/webhook/whatsapp
将 Phone Number ID 和 Webhook Verify Token 填入 DIGGERKIT 配置

⚠️ WhatsApp 模板审核

消息模板需要提交 Meta 审核，审核周期 1~48 小时。首次使用建议提前准备，避免影响正常发送。

📊 第六步：飞书 Bitable 集成

▶ 配置飞书多维表格数据同步

DIGGERKIT 支持将买家线索实时同步到飞书多维表格：

# 飞书 Bitable 配置参数（填入 DIGGERKIT 配置）
FEISHU_APP_ID=cli_xxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxx
FEISHU_BITABLE_ID=tbl_xxxxxxxxxx
FEISHU_TABLE_ID=tbl_xxxxxxxxxx

字段映射在使用手册 → 飞书 Bitable 有详细说明。

🔄 更新升级

▶ Docker 部署如何更新

cd /opt/diggerkit
docker-compose pull
docker-compose up -d
docker image prune -f   # 清理旧镜像

🔍 故障排查

▶ 常见问题

❌ 网站无法访问

检查 Caddy 是否运行：systemctl status caddy
检查防火墙：ufw status / 云控制台安全组
检查域名 DNS 是否生效：dig yourdomain.com

❌ API 返回 401

确认 API Key 正确（区分 gd_test_ 和 gd_live_）
检查 Key 是否过期：curl https://golddigger.gold/api/v2/quota

❌ WhatsApp 消息发不出去

检查 WhatsApp Business API 账号状态和余额
确认消息模板已通过 Meta 审核
检查 Webhook 是否正常接收事件

❓ 常见问题

▶ 可以不使用域名直接用 IP 访问吗？

可以。DIGGERKIT 支持纯 IP 访问（如 http://82.156.5.235），但 HTTPS 证书需要域名。建议测试环境使用 IP，生产环境使用域名。

▶ 支持多用户/多团队吗？

SUPER 套餐支持 3 个席位，PREMIUM 支持 10 个席位。每个席位有独立 API Key，数据隔离。

▶ 数据存在哪里？

私有化部署版本数据存在你自己的服务器数据库（SQLite/PostgreSQL）。云端版本数据由 DIGGERKIT 代管，可申请数据导出。

▶ 部署需要多久？

全自动脚本约 5~15 分钟，手动 Docker 约 20~30 分钟，源码部署约 30~60 分钟。PREMIUM 用户含远程协助，由工程师代操作。