fnvtk/karuo-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3ef5ce9578c8b18491716195992276afcd4d45fc
karuo-ai/01_卡资（金）/金仓_存储备份/服务器管理/SKILL.md

16 KiB
Raw Blame History

name, description, triggers, owner, group, version, updated
name description triggers owner group version updated
服务器管理 宝塔服务器统一管理与自动化部署 服务器、宝塔、部署、SSL、HTTPS、Nginx、PM2、内网穿透、域名、kr-ai、ngrok 金仓 金 1.0 2026-02-16

服务器管理

让 AI 写完代码后，无需人工介入，自动把项目「变成一个在线网站」。

快速入口（复制即用）

服务器资产

服务器 IP 配置 用途 宝塔面板
本机 Docker 宝塔 127.0.0.1 Docker 容器 本地建站、与腾讯云一致 http://127.0.0.1:8888/btpanel
存客宝 42.194.245.239 2核16G 50M 私域银行业务 https://42.194.245.239:9988
kr宝塔 43.139.27.93 2核4G 5M Node 项目主力、辅助 https://43.139.27.93:9988

凭证速查

# 本机 Docker 宝塔（本地）
地址: http://127.0.0.1:8888/btpanel
账号: ckb
密码: Zhiqun1984
# 首次部署后默认是 btpanel/btpaneldocker，登录后在面板里改为上述账号密码。
# 启动: bash 01_卡资（金）/金仓_存储备份/服务器管理/scripts/本机Docker宝塔_启动.sh
# 数据目录: ~/baota_docker_data/（website_data、mysql_data、vhost）

# SSH连接（kr宝塔为例，端口 22022）
ssh -p 22022 root@43.139.27.93
密码: Zhiqun1984

# 宝塔面板登录（kr宝塔）
地址: https://43.139.27.93:9988
账号: ckb
密码: zhiqun1984

# 宝塔API密钥
存客宝: TNKjqDv5N1QLOU20gcmGVgr82Z4mXzRi
kr宝塔: qcWubCdlfFjS2b2DMT1lzPFaDfmv1cBT

一键操作

0. 卡若AI 网关 / 内网穿透（固定域名 kr-ai.quwanzhi.com）

  • 标准方案（阿里云 DNS + 宝塔 Nginx + 网关部署）：读 references/内网穿透与域名配置_卡若AI标准方案.md。
  • kr宝塔（网关所在）：一键部署 bash 01_卡资（金）/金仓_存储备份/服务器管理/scripts/部署卡若AI网关到kr宝塔.sh
  • 存客宝（站点用宝塔 API）：部署到存客宝的站点/域名一律用宝塔 API 处理。卡若AI 站点：python3 scripts/存客宝_宝塔API_卡若AI网关站点.py（需将执行机 IP 加入存客宝面板 API 白名单）。
  • 调用命令：curl -s -X POST "https://kr-ai.quwanzhi.com/v1/chat" -H "Content-Type: application/json" -d '{"prompt":"你的问题"}' | jq -r '.reply'
  • 以后需配置内网穿透/新域名时，不询问用户，直接按该方案生成子域名并配置；存客宝上改站点/Nginx 用 API，见 references/宝塔api接口文档.md。

1. 检查服务器状态

# 运行快速检查脚本（需各服务器 API 白名单含本机 IP）
python3 "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/服务器管理/脚本/快速检查服务器.py"

2. 部署 Node 项目（标准流程）

# 1. 压缩项目（排除无用目录）
cd /项目路径
tar --exclude='node_modules' --exclude='.next' --exclude='.git' \
    -czf /tmp/项目名_update.tar.gz .

# 2. 上传到服务器（kr宝塔）
sshpass -p 'Zhiqun1984' scp -P 22022 /tmp/项目名_update.tar.gz root@43.139.27.93:/tmp/

# 3. SSH部署
ssh -p 22022 root@43.139.27.93
cd /www/wwwroot/项目名
rm -rf app components lib public styles *.json *.js *.ts *.mjs *.md .next
tar -xzf /tmp/项目名_update.tar.gz
pnpm install
pnpm run build
rm /tmp/项目名_update.tar.gz

# 4. 宝塔面板重启项目
# 【网站】→【Node项目】→ 找到项目 → 点击【重启】

3. SSL证书检查/修复

# 检查所有服务器SSL证书状态
python3 "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/服务器管理/脚本/ssl证书检查.py"

# 自动修复过期证书
python3 "/Users/karuo/Documents/个人/卡若AI/01_卡资（金）/金仓_存储备份/服务器管理/脚本/ssl证书检查.py" --fix

4. kr宝塔 网络卡/服务器卡 · 检查与处理

  • 文档：references/kr宝塔_网络与服务器卡顿_检查与处理.md
  • 带宽使用情况（近24h）：运行 scripts/kr宝塔_腾讯云带宽与CPU近24h.py（建议用 scripts/.venv_tx/bin/python，依赖 tencentcloud-sdk-python-monitor）。结论：出带宽最大已顶满 5M，属带宽卡主因；处理见文档「六、直接处理」。
  • SSH：ssh -p 22022 -i "服务器管理项目/Steam/id_ed25519" root@43.139.27.93（私钥须 chmod 600）
  • 本机快速检查：ping 43.139.27.93、nc -zv 43.139.27.93 22022
  • 服务器内诊断与限流：在 宝塔面板终端 执行文档「六」中 6.1～6.3 命令（连接数、按 IP 统计、Nginx 限速）。
  • 502 修复（如 soul.quwanzhi.com/admin）：API 方式运行 scripts/kr宝塔_宝塔API_修复502.py（需 API 白名单）；或到 kr宝塔 宝塔面板 → 终端 执行 nginx -t && nginx -s reload 后，在「Node 项目」中重启 soul 相关项目。详见文档 6.6。

5. 常用诊断命令（kr宝塔等）

# 检查端口占用
ssh -p 22022 root@43.139.27.93 "ss -tlnp | grep :3006"

# 检查PM2进程
ssh -p 22022 root@43.139.27.93 "/www/server/nodejs/v22.14.0/bin/pm2 list"

# 测试HTTP响应
ssh -p 22022 root@43.139.27.93 "curl -I http://localhost:3006"

# 检查Nginx配置
ssh -p 22022 root@43.139.27.93 "nginx -t"

# 重载Nginx
ssh -p 22022 root@43.139.27.93 "nginx -s reload"

# DNS解析检查
dig soul.quwanzhi.com +short @8.8.8.8

端口配置表（kr宝塔 43.139.27.93）

端口 项目名 类型 域名 状态
3000 cunkebao Next.js mckb.quwanzhi.com ✅
3001 ai_hair NestJS ai-hair.quwanzhi.com ✅
3002 kr_wb Next.js kr_wb.quwanzhi.com ✅
3003 hx Vue krjzk.quwanzhi.com ⚠️
3004 dlmdashboard Next.js dlm.quwanzhi.com ✅
3005 document Next.js docc.quwanzhi.com ✅
3006 soul Next.js soul.quwanzhi.com ✅
3015 神射手 Next.js kr-users.quwanzhi.com ⚠️
3018 zhaoping Next.js zp.quwanzhi.com ✅
3021 is_phone Next.js is-phone.quwanzhi.com ✅
3031 word Next.js word.quwanzhi.com ✅
3036 ymao Next.js ymao.quwanzhi.com ✅
3043 tongzhi Next.js touzhi.lkdie.com ✅
3045 玩值大屏 Next.js wz-screen.quwanzhi.com ✅
3050 zhiji Next.js zhiji.quwanzhi.com ✅
3051 zhiji1 Next.js zhiji1.quwanzhi.com ✅
3055 wzdj Next.js wzdj.quwanzhi.com ✅
3305 AITOUFA Next.js ai-tf.quwanzhi.com ✅
9528 mbti Vue mbtiadmin.quwanzhi.com ✅

端口分配原则

  • 3000-3099: Next.js / React 项目
  • 3100-3199: Vue 项目
  • 3200-3299: NestJS / Express 后端
  • 3300-3399: AI相关项目
  • 9000-9999: 管理面板 / 特殊用途

核心工作流程

┌─────────────────────────────────────────────────────────────────────────────┐
│                        Node项目一键部署流程                                  │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│   START                                                                     │
│     │                                                                       │
│     ▼                                                                       │
│  ┌──────────────────┐                                                      │
│  │ 1. 压缩本地代码  │  排除 node_modules, .next, .git                      │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 2. 上传到服务器  │  scp 到 /tmp/                                         │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 3. 清理旧文件    │  保留 .env 等配置文件                                 │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 4. 解压新代码    │  tar -xzf                                             │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 5. 安装依赖      │  pnpm install                                         │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 6. 构建项目      │  pnpm run build                                       │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 7. 宝塔面板重启  │  Node项目 → 重启                                       │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│  ┌──────────────────┐                                                      │
│  │ 8. 验证访问      │  curl https://域名                                     │
│  └────────┬─────────┘                                                      │
│           │                                                                 │
│           ▼                                                                 │
│        SUCCESS                                                              │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

操作优先级矩阵

操作类型 优先方式 备选方式 说明
查询信息 ✅ 宝塔API SSH API稳定
文件操作 ✅ 宝塔API SSH API支持
配置Nginx ✅ 宝塔API SSH API可读写
重载服务 ⚠️ SSH - API无接口
上传代码 ⚠️ SSH/scp - 大文件
添加项目 ❌ 宝塔界面 - API不稳定

常见问题速查

Q1: 外网无法访问（ERR_EMPTY_RESPONSE）

原因: 腾讯云安全组只开放443端口

解决:

  1. 必须配置SSL证书
  2. Nginx配置添加443监听

Q2: Node项目启动失败（Could not find production build）

原因: 使用 npm run start 但未执行 npm run build

解决: 先 pnpm run build 再重启

Q3: 端口冲突（EADDRINUSE）

解决:

# 检查端口占用
ss -tlnp | grep :端口号

# 修改package.json中的端口
"start": "next start -p 新端口"

Q4: DNS被代理劫持

现象: 本地DNS解析到198.18.x.x

解决:

  • 关闭代理软件
  • 或用手机4G网络测试

Q5: 宝塔与PM2冲突

原因: 同时使用root用户PM2和宝塔PM2

解决:

  • 停止所有独立PM2: pm2 kill
  • 只使用宝塔界面管理

安全约束

绝对禁止

  • ❌ 输出完整密码/密钥到聊天
  • ❌ 执行危险命令（rm -rf /, reboot等）
  • ❌ 跳过验证步骤
  • ❌ 使用独立PM2（避免与宝塔冲突）

必须遵守

  • ✅ 操作前检查服务器状态
  • ✅ 操作后验证结果
  • ✅ 生成操作报告

相关脚本

脚本 功能 位置
快速检查服务器.py 一键检查所有服务器状态 ./scripts/
一键部署.py 根据配置文件部署项目 ./scripts/
ssl证书检查.py 检查/修复SSL证书 ./scripts/
腾讯云镜像快照备份到CKB_NAS/tencent_image_snapshot_backup_to_nas.py 腾讯云镜像/快照元数据备份到 CKB NAS，1000G 限制与超限邮件告警 ./scripts/腾讯云镜像快照备份到CKB_NAS/

复盘与输出规范

  • 卡若复盘：每次对话结束必须按 运营中枢/参考资料/卡若复盘格式_固定规则.md 输出复盘块；反思 1～3 点，每点一句，简洁可执行，不超过 3 条。

相关文档

文档 内容 位置
卡若复盘格式_固定规则.md 复盘格式（目标·结果·达成率、过程、反思 1～3 点、总结、下一步） 运营中枢/参考资料/
宝塔API接口文档.md 宝塔API完整接口说明 ./references/
端口配置表.md 完整端口分配表 ./references/
常见问题手册.md 问题解决方案大全 ./references/
部署配置模板.md JSON配置文件模板 ./references/
系统架构说明.md 完整架构图和流程图 ./references/

历史对话整理

kr_wb白板项目部署（2026-01-23）

  • 项目类型: Next.js
  • 部署位置: /www/wwwroot/kr_wb
  • 域名: kr_wb.quwanzhi.com
  • 端口: 3002
  • 遇到问题: AI功能401错误（API密钥未配置）
  • 解决方案: 修改 lib/ai-client.ts，改用 SiliconFlow 作为默认服务

soul项目部署（2026-01-23）

  • 项目类型: Next.js
  • 部署位置: /www/wwwroot/soul
  • 域名: soul.quwanzhi.com
  • 端口: 3006
  • 部署流程: 压缩→上传→解压→安装依赖→构建→PM2启动→配置Nginx→配置SSL