Skip to main content
Glama
README.md
# ServerHub

渗透测试样本台账 + SEO 友链投放系统。

- **台账**:公司 → 资产(样本)→ 漏洞 / 载荷 / 凭据 / 附件 / 访问记录,结构化归档,支持 Markdown 报告渲染与凭据加密存储。
- **SEO 投放**:投放域名表 + 自管脚本包 + 常驻 worker 异步批次执行,前端实时进度,失败自动登记失效表,域名软删除可恢复。
- **MCP 接入**:JSON-RPC 2.0 over HTTP,把全部业务能力以工具形式暴露给外部 AI 客户端。

## 技术栈

| 层 | 选型 |
| --- | --- |
| 后端 | Django 6 + SQLite(WAL + busy timeout) |
| 前端 | 服务端模板 + daisyUI 5(Tailwind 4 CDN) |
| 异步投放 | 独立 worker 进程(`manage.py seo_worker`)+ 线程池并行 |
| 外部接入 | MCP(JSON-RPC 2.0,Bearer Token 鉴权) |
| 部署 | uwsgi(回环端口 + nginx 反代)+ nohup worker + crontab 开机自启 |

## 快速开始

```bash
python -m venv .venv
.venv\Scripts\activate          # Windows;Linux 用 source .venv/bin/activate
pip install -r requirements.txt

# 配置环境变量(复制 .env.example 为 .env 后填写)
#   SECRET_KEY、DEBUG、MCP_TOKEN、MCP_ENABLED 等

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
```

## 环境变量(.env)

| 变量 | 说明 |
| --- | --- |
| `SECRET_KEY` | Django 密钥(必填) |
| `DEBUG` | 调试开关 |
| `MCP_ENABLED` / `MCP_TOKEN` | MCP 端点开关与 Bearer Token(不配置则禁用) |
| `MCP_ALLOWED_IPS` | MCP 来源 IP 白名单(可选) |
| `MCP_UPLOAD_DIR` | MCP 上传目录(默认 `media/incoming`) |
| `SEO_SCRIPT_ROOT` | 投放脚本包存储根目录(默认 `seo_scripts/`) |
| `SEO_PYTHON_BIN` | 执行投放脚本的 Python(留空自动定位) |
| `SEO_WORKER_CONCURRENCY` | 批次内脚本并发数(默认 3) |

## SEO 投放系统

### 设计

- **投放表 `SeoDeploy`**:要投出去的域名(全域名唯一,a.com 与 a.a.com 各自独立),含链接地址、title、锚文本;`is_deleted` 软删除——移出投放可随时恢复,历史台账保留。
- **投放脚本 `SeoScript`**:zip 包上传(必须含入口 `update_friend_links.py`),解压为独立目录持久保留(session 缓存、依赖、凭据脚本自理);同名覆盖更新。
- **记录表 `SeoDeployRecord`**:域名 × 脚本投放台账(成功/失败),驱动「只补投未成功」。
- **失效表 `SeoScriptIssue`**:脚本失败自动登记,未确认修复前不参与后续批次;管理员修复后点「确认修复」恢复。
- **批次 `SeoBatch` / `SeoBatchScript`**:一次「开始投放」= 全部启用脚本参与,worker 异步执行,状态全在数据库,页面轮询实时进度(刷新/退出登录不丢进度)。

### 脚本契约

```
python update_friend_links.py task.json   # cwd = 脚本目录
```

`task.json` 为动作数组,退出码 0 = 成功,stdout/stderr 捕获为日志:

```json
[{"action": "add", "url": "https://a.com/", "anchor": "示例", "title": "示例 - 描述"}]
```

`action` 支持 `add`(幂等:已存在跳过)与 `del`(按 url 精确匹配删除,不存在跳过)。

### 运行

```bash
# 常驻投放 worker(配合 crontab @reboot 实现开机自启)
nohup <venv>/bin/python manage.py seo_worker >> logs/worker.log 2>&1 &
```

## MCP 接入

端点 `POST /mcp`,`Authorization: Bearer <MCP_TOKEN>`。48 个工具:公司 / 资产 / 漏洞 / 载荷 / 凭据(脱敏 + 明文查看留痕)/ 附件(分片上传)/ 访问记录 / SEO 投放(域名软删恢复、脚本包、失效表、批次进度)。详见 [docs/模块/MCP 接入.md](docs/模块/MCP 接入.md)。

## 目录结构

```text
API/
  models/            业务模型(公司/资产/漏洞/载荷/凭据/附件/访问记录/SEO)
  seo/               投放引擎(脚本包管理、批次执行、域名规范化)
  mcp/               MCP 协议层与工具实现
  apis/              内部接口
  management/commands/seo_worker.py   常驻投放 worker
  migrations/
  tests/             测试(76 用例)
ServerHub/           项目配置(settings/urls/wsgi)
Web/                 前端视图 / 表单 / 模板(daisyUI)
docs/模块/           系统文档(系统总览 / SEO 投放 / MCP 接入)
youqinglianjie-css/  友链模块样式(normalize.css)
```

## 测试

```bash
python manage.py test
```

## 部署(uwsgi + nginx 反代)

1. 按 `uwsgi.ini` 启动:`uwsgi -d --ini uwsgi.ini`(回环端口,nginx 反代对外)
2. 启动投放 worker 并配置开机自启(见上)
3. 迁移:`python manage.py migrate`

## License

[MIT](LICENSE)