ServerHub
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)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues