th3cyb3rhub/TheCyberHub
GitHub: th3cyb3rhub/TheCyberHub
开源网络安全学习与社区平台,整合 CTF 挑战、安全工具、学习路径和社区功能,支持私有化部署。
Stars: 178 | Forks: 170
TheCyberHub
开源网络安全学习平台
学习。实践。精通安全。
网站 •
开发站点 •
Discord
## 什么是 TheCyberHub?
TheCyberHub 是一个集网络安全教育与社区于一体的综合性平台,提供:
- **100+ CTF 挑战** — Web、Crypto、Forensics、Reverse Engineering、OSINT
- **22+ 安全工具** — JWT 分析器、Hash 破解器、端口扫描器、DNS 查询等
- **8 大速查表类别** — Linux、网络、XSS、SQL 注入、权限提升
- **社区论坛** — 提问、分享知识、为答案投票
- **社交动态** — 帖子、点赞、评论、转发、话题标签
- **招聘看板** — 网络安全职位、实习、雇主管理后台
- **导师计划** — 与资深专业人士建立联系
- **活动与 CTF 竞赛** — 研讨会、网络研讨会、聚会及报名
- **学习路径** — 从入门到专家的指导性课程
- **排行榜** — 全球排名、连续打卡追踪、成就
- **博客平台** — 撰写教程、分享题解
- **管理后台** — 全面审核、分析、用户管理
## 技术栈
| 层级 | 技术 |
|-------|------|
| **Framework** | Next.js 15 (App Router), React 19, TypeScript 5.8 |
| **Styling** | Tailwind CSS, CSS Custom Properties (深色/浅色主题) |
| **UI** | Radix UI + shadcn/ui, Lucide icons |
| **State** | React Context + TanStack React Query |
| **Auth** | JWT tokens, Google/GitHub OAuth, 2FA (TOTP) |
| **Real-time** | Socket.IO (用于通知) |
| **Testing** | Vitest (单元测试), Playwright (E2E) |
| **Infra** | GitHub Actions CI/CD, Sentry 错误追踪 |
## 快速开始
### 前置条件
- [Node.js](https://nodejs.org/) v20+
- [Git](https://git-scm.com/)
- [MongoDB](https://www.mongodb.com/) (本地或 Atlas)
- [Redis](https://redis.io/) (可选,用于缓存)
### 前端设置
```
git clone https://github.com/th3cyb3rhub/TheCyberHub.git
cd TheCyberHub
npm install
cp .env.example .env.local
# 编辑 .env.local 填入你的 API URL
npm run dev
```
打开 [http://localhost:3000](http://localhost:3000)
前端连接到 TheCyberHub API。在你的 `.env.local` 中设置 `NEXT_PUBLIC_API_URL` 以指向 API 服务器。
## 项目结构
```
TheCyberHub/
src/
app/ # 105+ page routes (App Router)
components/ # 88+ reusable components
hooks/ # Custom React hooks + React Query
lib/ # API client, constants, validations
context/ # Auth, Theme, Toast, Notifications
e2e/ # Playwright E2E tests
```
## 环境变量
复制示例文件即可开始使用——默认指向开发 API:
```
cp .env.example .env.local
```
```
# Dev API (默认 — 无需本地 backend)
NEXT_PUBLIC_API_URL=https://dev-api.thecyberhub.org
# Production API
# NEXT_PUBLIC_API_URL=https://api.thecyberhub.org
# 本地 backend (仅在本地运行 thecyberhub-core 时)
# NEXT_PUBLIC_API_URL=http://localhost:5001
```
## 重要提示:现有 Fork 拥有者
仓库已完成重构。**`dev` 现在是默认且唯一活跃的分支。** 如果你之前 fork 过此仓库,需要重新同步你的 fork:
```
# Option 1: 重新同步 (推荐 — 保留你的 fork)
cd TheCyberHub
git remote add upstream https://github.com/th3cyb3rhub/TheCyberHub.git
git fetch upstream
git checkout dev
git reset --hard upstream/dev
git push origin dev --force
```
```
# Option 2: 全新 fork (如果你没有本地更改,这是最简单的)
# 在 GitHub 上删除你的旧 fork,然后重新 fork 自
# https://github.com/th3cyb3rhub/TheCyberHub
```
同步后,所有后续的 `git pull` 都将正常工作。
## 许可证
[TheCyberHub](https://www.thecyberhub.org) 采用 MIT 许可证授权 - 详见 [LICENSE](LICENSE) 文件。
## 支持
如果你觉得这个项目有用,请给它一个 Star!这有助于我们扩大社区规模。
## 联系我们
标签:CDN识别, CISA项目, CTF挑战, DNS查询, DNS解析, ESC4, JWT分析器, OSINT, React, Syscalls, Tailwind CSS, TypeScript, Web安全, Web报告查看器, XSS, 云资产清单, 协议分析, 博客平台, 学习平台, 学习路径, 安全插件, 安全教育, 密码学, 密码管理, 导师指导, 开源项目, 手动系统调用, 排行榜, 插件系统, 搜索引擎查询, 数字取证, 数据统计, 权限提升, 求职看板, 漏洞情报, 特征检测, 社区论坛, 端口扫描, 管理仪表盘, 网络安全, 自动化攻击, 自动化脚本, 蓝队分析, 逆向工程, 速查表, 隐私保护, 黑客社区