HackerEasyWeb 是一个 面向初学者的简易 Web 系统，由开发者 HackerJohnSmith 专为 Web 入门学习者设计开发，聚焦基础 Web 开发知识实践与快速上手需求，提供低门槛、高可读性的 Web 系统实现方案。
通过简化的技术栈与清晰的代码结构，该项目在保证核心功能完整的前提下，降低了 Web 开发的入门难度，避免复杂配置与冗余代码，同时保留真实项目的基础架构，帮助初学者直观理解 Web 服务器、路由、表单处理、数据存储等核心概念。
- 入门友好设计：针对 Web 初学者优化，代码注释清晰，逻辑简单易懂，避免抽象概念与复杂依赖。
- 零门槛部署：提供服务端管理面板 (Windows 平台) ,无需手动配置环境，双击即可完成安装与启动服务端。
- Excel 轻量数据库：使用 Excel 文件作为数据存储介质，无需学习 MySQL 等专业数据库，降低数据操作门槛，实现用Excel就能直接修改数据库数据。
- 完整基础功能：包含用户注册、登录、会话管理等核心 Web 功能，可直接作为学习案例或二次开发基础。
- 开源可扩展：全部代码开源，结构模块化，可直接替换模块内容，便于初学者在此基础上添加新功能，实践开发技能。
- 核心框架：基于 Express 4.18.2 开发，采用 Node.js 作为运行环境，简化 Web 服务器搭建流程。
- 数据处理：使用 xlsx 0.18.5 库实现 Excel 文件的读写操作，替代传统数据库作为数据存储方案。
- 部署工具：通过 管理面板 自动化环境配置与服务管理，降低操作复杂度。
为保证服务端正常运行，建议满足以下环境配置：
- 操作系统：Windows 10 及以上版本（64 位系统）
- Node.js：至少 v22.19.0 及以上（管理面板会自动下载并安装适配版本）
- 内存（RAM）：至少 1GB 可用内存（物理内存至少2GB内存以上）
- 硬盘（ROM）：至少 120MB 可用空间（含 Node.js 环境和数据库文件）
- 点击链接 下载最新版本软件
- 解压Zip压缩文件，并将压缩文件下所有内容放在一个单独的空白文件夹下
- 双击运行
HackerEasyWeb.exe控制面板软件 - 在弹出的菜单中选择：
2) 安装服务器：自动下载 Node.js 环境并完成依赖安装1) 启动服务器：安装完成后启动 Web 服务- 服务启动后，访问
http://localhost即可访问Web服务
- *注意:您应该选择下载Github Releases下的完整文件而非代码文件或者克隆仓库
# 克隆项目仓库
git clone https://github.com/HackerJohnSmith/HackerEasyWeb.git
# 进入项目目录
cd HackerEasyWeb
# 安装依赖包
npm install
# 启动服务器
npm start*注意:您在手动部署前需要手动安装最新版本的node.js且您将无法正常使用HackerEasyWeb控制面板
| 参数类型 | 参数名 | 配置位置 | 作用说明 |
|---|---|---|---|
| 服务器端口 | port |
main.js 第6行 | 默认为 80 端口，可修改为其他端口（如 8080） |
| 静态文件目录 | express.static |
main.js 第10行 | 默认为当前目录，用于存放 HTML 等静态文件 |
| 数据库文件名 | dbFile |
main.js 第16行 | 默认为 database.xlsx，存储用户数据 |
| 默认用户名密码 | Hacker |
main.js 第27行 | 默认为Hacker/Hacker |
-
基础功能使用：
- 访问首页
http://localhost可导航至登录/注册页面 - 注册新用户后，使用账号密码登录系统
- 登录成功后进入欢迎页面，可返回首页继续操作
- 访问首页
-
数据管理：
- 用户数据明文存储在项目根目录的
database.xlsx文件中 - 您可以尝试使用Excel直接更改用户名密码
- 可通过管理面板菜单的
4) 备份数据库选项将数据备份到 C 盘根目录 - 管理面板菜单备份会强制覆盖之前的同名称文件,如您有另外需求，请注意另寻备份
- 用户数据明文存储在项目根目录的
-
服务管理：
- 停止服务：在启动窗口按
Ctrl+C组合键 - 卸载服务：通过批处理菜单的
3) 卸载服务器选项（暂未实现，敬请期待）
- 停止服务：在启动窗口按
-
服务端开发：
- 您可以寻找好看的模板替换主页的index.html文件,并在模板中引入超链接到登录注册的html文件中
- 您可以查看项目源代码文件已修改项目文件,您可以轻易看懂绝大多数代码，看不懂的我也写了注释
本项目采用 GNU Affero General Public License v3.0 (AGPL v3) 协议授权，使用前请遵守以下核心条款：
- 允许自由复制、分发和修改本项目代码
- 若修改本项目代码并通过网络提供服务，必须在服务页面显著位置提供修改后的完整源码
- 分发项目时，需保留原作者版权声明及本协议文本
- 衍生作品必须采用相同协议授权
AGPL v3 协议官方文本：https://www.gnu.org/licenses/agpl-3.0.html
- 大版本更新：首次创建HackerEasyWeb项目，完成基础框架搭建（含管理面板和基础功能配置）
未来将围绕「提升初学者学习体验」持续迭代，重点方向包括：
- 修改细微问题和BUG，提升用户体验
- 完善控制面板功能(包括但不限于卸载功能,手动部署项目支持管理面板)
- IPV6技术,HTTPS技术引入和优化
- 优化代码可读性和易于维护性
- 提供更多安全类保障
本项目仅作为 Web 开发学习工具使用，其设计目的是帮助初学者快速完成动态网站开服，且项目不适合用于企业级生产环境。项目中的数据存储方案（Excel）存在性能与安全性限制，使用者需注意数据安全。您可以尝试将项目用于小心局域网或者小心个人网站，但开发者（HackerJohnSmith）不对因使用本项目导致的任何直接或间接损失承担责任，相关使用风险由使用者自行承担。