kargfel/spond-bot
GitHub: kargfel/spond-bot
一个基于 FastAPI 与 Docker 的自动化 RSVP 机器人,提供多用户仪表板与本地化安全托管,解决活动报名秒没问题。
Stars: 3 | Forks: 0
# ⚡ SpondBot — 自动接受 RSVP 与多用户仪表板
[](LICENSE)
[](https://github.com/kargfel/spond-bot/stargazers)
[](https://github.com/kargfel/spond-bot/network/members)
[](https://github.com/kargfel/spond-bot/issues)
[](#)
[](#)
[](#)
*一个用于 Spond 应用的自动化、自托管机器人与仪表板。*
## 🌟 概述
厌倦了因为活动在几秒内报满而错过高需求的活动吗?**SpondBot** 会连接到你的 Spond 账户,并在活动创建的那一刻自动将 RSVP 设置为“是”。
最初只是一个简单的定时脚本,SpondBot 现在已发展成为一个功能齐全的平台,具备以下特性:
- **👮 多用户支持**:托管你自己的实例,允许多个用户配置各自的 RSVP 设置。
- **🎨 现代网页仪表板**:采用深色“午夜紫”UI 主题,优雅美观,用于管理 RSVP、监控状态和关联你的 Spond 账户。
- **⚡ 后台自动化**:完全容器化的定时调度工作器,严格遵循你配置的限额。
- **🔒 安全与隐私**:完全在本地硬件上托管。你的 Spond 凭据经过系统化加密。
## ✨ 核心特性
- **手机与邮箱认证**:自动检测账户使用的是邮箱还是手机号。
- **零信任加固**:所有存储的凭据均使用 Fernet 对称密钥加密。
- **内置管理员门户**:内置的管理员仪表板,用于管理用户、重置密码和监控系统健康。
- **自动化部署**:通过 Docker 与 `docker-compose` 快速启动配置。
## 🚀 快速部署
SpondBot 借助 Docker 部署极为简单。你可以将其部署在本地电脑、Raspberry Pi 或 VPS 服务器上。
### 1. 前置条件
- **[Docker & Docker Compose](https://docs.docker.com/get-docker/)** 已安装在你的机器上。
- Git(可选,但推荐)。
### 2. 下载并配置
克隆本仓库(或下载 ZIP 包):
```
git clone https://github.com/kargfel/spond-bot.git
cd spond-bot
```
创建你的环境配置文件:
```
cp .env.example .env
```
用你喜欢的文本编辑器打开 `.env` 并配置密钥:
- **`DB_PASSWORD`**:设置一个强大的数据库密码。
- **`FERNET_KEY`**:安全生成(运行 `python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"`)。
- **`API_KEY`**:设置一个强随机令牌。
- **`ADMIN_PASSWORD`**:设置初始管理员密码以访问 Web 界面。
### 3. 启动 SpondBot!
```
docker compose up -d --build
```
*就这样!* SpondBot 现在已在后台运行。
### 4. 访问仪表板
打开浏览器并导航至:
👉 **`http://localhost:8080`** *(或你的服务器 IP 地址)*
使用以下凭据登录:
- **用户名**:`admin`
- **密码**:*(你设置的 `ADMIN_PASSWORD`)*
从此你可以关联你的 Spond 账户并开始自动化你的 RSVP!
## 📖 高级用法与多节点部署
如果你希望将 SpondBot 暴露到公网(例如在独立跳板机上使用 Traefik 反代),请阅读我们的完整 **[高级部署指南](DEPLOY.md)**。
## 📝 许可证
本项目根据 [MIT 开源许可证](LICENSE) 慷慨提供。标签:API集成, AV绕过, Docker, FastAPI, Midnight Violet, NIDS, PostgreSQL, Python, RSVP, SEO, Spond, UI, Web仪表盘, 事件管理, 代码分析, 关系型数据库, 凭证管理, 加密存储, 可观测性, 后台任务, 多用户, 安全防御评估, 定时任务, 容器化, 开源, 无后门, 日程安排, 暗黑模式, 机器人, 测试用例, 版权保护, 状态监控, 第三方集成, 网络调试, 自动化, 自我托管, 自托管, 请求拦截, 逆向工具, 通知, 隐私安全