HANU项目现已全面更名为 N G C C S , 请前往 https://github.com/NGCCS/NGCCS

HANU V10 正式版，一个 PHP + MySQL 的社交系统安装包。

公测反馈：qm66668888@qq.com

项目说明

HANU 是一个可上传到 PHP + MySQL 服务器运行的社交系统。
它不是纯静态网页，因此不能直接用 GitHub Pages 运行 PHP 和 MySQL。GitHub 这里主要用于展示代码、保存版本、下载源码。

功能

• 安装向导
• 自定义站点名称
• 登录 / 注册
• 动态发布
• 图片 / 视频动态
• 好友系统
• 私信
• 群聊
• 板块
• 签到积分
• 等级系统
• 称号系统
• WAF 拦截页
• 外链安全中间页
• 管理后台
• 多语言：简体中文、繁體中文、English

目录结构

index.php          # 安装器入口
source/            # 正式源码，安装时复制到根目录
language/          # 语言包
ICO/               # 默认图标目录，默认文件名 favicon.ico
install.sh         # Linux 一键环境安装脚本
README.md

Linux 一键安装

适合 Ubuntu / Debian / CentOS / RHEL 服务器。

wget https://raw.githubusercontent.com/macbo2013/HANU/main/install.sh
sudo bash install.sh

脚本会安装：

• Nginx
• PHP-FPM
• PHP MySQL / GD / mbstring / curl / zip / xml
• MariaDB / MySQL
• Git / unzip / curl

然后打开服务器 IP 或域名进入安装器。

手动安装

1. 把项目上传到网站根目录。
2. 打开域名或服务器 IP。
3. 按安装器提示填写数据库信息。
4. 创建管理员账号。
5. 安装完成后删除安装文件夹。

数据库要求

• MySQL 5.7+
• MariaDB 也可用
• 字符集建议 utf8mb4

许可

公测阶段，暂未正式发布稳定版协议。

环境检测版 install.sh

install.sh 会先检测服务器环境，不会一上来就乱装。

会检测：

• Nginx
• Apache / httpd
• PHP CLI
• PHP-FPM
• PHP 版本是否 >= 7.4
• PHP 扩展：pdo、pdo_mysql、gd、mbstring、curl、zip、xml
• MySQL / MariaDB
• Git
• Unzip
• Curl
• 是否存在常见服务器面板环境

如果检测不通过，脚本会给出选择：

1) 自动安装推荐环境：Nginx + PHP-FPM + MariaDB
2) 不安装环境，只继续部署 HANU 代码
3) 查看手动安装 / 面板安装建议，然后退出
4) 重新检测

如果你用宝塔面板 / aaPanel，建议先在面板里装好：

• Nginx 或 Apache
• PHP 7.4+
• MySQL 5.7+ 或 MariaDB
• PHP 扩展：pdo_mysql、gd、mbstring、curl、zip、xml

然后再运行脚本部署 HANU。

更新中心

HANU 现在内置更新检测和数据库迁移系统。

后台入口：

/app/update.php

更新中心可以：

• 检测 GitHub 是否有新版本
• 显示当前版本和最新版本
• 保存 GitHub 更新源
• 一键运行数据库兼容升级

保留数据更新

服务器上进入网站根目录运行：

sudo bash update.sh

更新脚本会：

1. 备份当前网站文件
2. 尝试备份数据库
3. 从 GitHub 拉取最新代码
4. 同步代码
5. 保留：
   • config/config.php
   • data/
   • ICO/
6. 运行数据库迁移：
   • 只创建新表
   • 只补充缺失字段
   • 不删除旧表
   • 不清空旧数据

GitHub 版本信息

推荐你每次发布版本时更新：

VERSION
VERSION.json

也可以在 GitHub Releases 里发布新版本，tag 例如：

v1.0.1

V9 更新内容

版本号：1.0.2
显示名：HANU V10 正式版

本次是一个小版本更新，主要用于测试 GitHub 更新中心：

• 新增首页公测公告
• 新增关于页面：/app/about.php
• 后台站点设置支持修改首页公告
• 更新 VERSION 和 VERSION.json
• 数据库迁移系统新增 V9 兼容迁移
• 更新脚本继续保留：
  • config/config.php
  • data/
  • ICO/

推荐 Release Tag：

v1.0.2

V9 管理员更新安全版

版本号：1.0.2
显示名：HANU V10 正式版

本次更新重点

• 更新检测只允许管理员使用。
• /api/update_check.php 已加入管理员权限验证。
• /app/update.php 是管理员专用页面。
• 普通用户不会看到更新提醒。
• 更新提醒不是强制更新。
• 管理员可以关闭当天提醒。
• 新增后台更新弹窗：
  • 仅管理员可见
  • 只提醒，不自动更新
  • 可点击“查看更新”
  • 可点击“今天不再提醒”

更新方式

服务器进入网站目录后执行：

sudo bash update.sh

更新脚本会保留：

config/config.php
data/
ICO/

数据库迁移只会补字段和补表，不会删除旧表，不会清空旧数据。

V9 修复版 beta.3

修复更新中心重复声明、群聊发送、群聊密码保护、板块按钮入口等问题。详见 README_V9_HOTFIX.md。