# Fuxsto-V4

为Fuxsto-v4虚拟主机系统版本归档，发布时间：2025-3-7

# Fuxsto Host V4 详细使用文档

## 📋 目录
- [项目简介](#项目简介)
- [系统要求](#系统要求)
- [安装部署](#安装部署)
- [数据库配置](#数据库配置)
- [功能模块详解](#功能模块详解)
- [API接口文档](#api接口文档)
- [管理后台使用](#管理后台使用)
- [产品模块开发](#产品模块开发)
- [系统维护](#系统维护)
- [常见问题](#常见问题)
- [更新日志](#更新日志)

## 🚀 项目简介

Fuxsto Host V4 是一个基于 PHP + MySQL 的虚拟主机管理系统，提供用户注册、产品购买、业务管理等功能。系统采用前后端分离架构，前端使用 Vue.js，后端使用 PHP。

### 主要特性
- 🔐 用户认证系统（集成第三方登录）
- 💰 积分和余额双货币系统
- 📦 产品管理和购买系统
- ⏰ 自动到期提醒和清理
- 📊 用户仪表板
- 🔧 模块化产品架构
- 📧 邮件通知系统

## 💻 系统要求

### 服务器环境
- **Web服务器**: Apache 2.4+ 或 Nginx 1.18+
- **PHP版本**: PHP 7.4+ (推荐 PHP 8.0+)
- **数据库**: MySQL 5.7+ 或 MariaDB 10.3+
- **内存**: 最小 512MB，推荐 1GB+
- **存储**: 最小 1GB 可用空间

### PHP扩展要求
```bash
# 必需扩展
php-mysqli
php-json
php-session
php-curl
php-mbstring

# 可选扩展（推荐）
php-gd
php-zip
php-xml
```

## 🛠️ 安装部署

### 1. 下载项目
```bash
# 方式一：Git克隆
git clone https://git.hztecha.com/admin/Fuxsto-V4.git
cd Fuxsto-V4

# 方式二：直接下载解压
# 下载后解压到网站根目录
```

### 2. 文件权限设置
```bash
# Linux/Unix 系统
chmod -R 755 /path/to/fuxsto-v4/
chmod -R 777 /path/to/fuxsto-v4/Log/

# Windows 系统
# 确保 IIS_IUSRS 或 IUSR 用户有读写权限
```

### 3. Web服务器配置

#### Apache 配置
```apache
# .htaccess 文件（项目根目录）
RewriteEngine On

# 处理前端路由
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} ^/Dashboard
RewriteRule ^Dashboard/(.*)$ /Dashboard/index.html [L]

# API路由重写
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^Main/(.+)$ /Main/$1/index.php [L]

# 静态文件缓存
<FilesMatch "\.(css|js|png|jpg|jpeg|gif|ico|svg)$">
    ExpiresActive On
    ExpiresDefault "access plus 1 month"
</FilesMatch>
```

#### Nginx 配置
```nginx
server {
    listen 80;
    server_name your-domain.com;
    root /path/to/fuxsto-v4;
    index index.html index.php;

    # 前端路由处理
    location /Dashboard {
        try_files $uri $uri/ /Dashboard/index.html;
    }

    # API路由处理
    location ~ ^/Main/(.+)$ {
        try_files $uri /Main/$1/index.php;
    }

    # PHP处理
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 静态文件缓存
    location ~* \.(css|js|png|jpg|jpeg|gif|ico|svg)$ {
        expires 1M;
        add_header Cache-Control "public, immutable";
    }
}
```

## 🗄️ 数据库配置

### 1. 创建数据库
```sql
CREATE DATABASE fuxstohostv4 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 创建数据表

#### 用户表 (users)
```sql
CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL UNIQUE,
  `password` varchar(255) NOT NULL,
  `qq` varchar(20) DEFAULT NULL,
  `score` int(11) DEFAULT 100,
  `balance` decimal(10,2) DEFAULT 0.00,
  `status` enum('active','inactive','banned') DEFAULT 'active',
  `last_sign_in_date` date DEFAULT NULL,
  `register_time` timestamp DEFAULT CURRENT_TIMESTAMP,
  `register_ip` varchar(45) DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_username` (`username`),
  KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

#### 产品表 (products)
```sql
CREATE TABLE `products` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `product_id` varchar(50) NOT NULL UNIQUE,
  `name` varchar(100) NOT NULL,
  `description` text,
  `price` decimal(10,2) NOT NULL,
  `currency_type` enum('score','balance') DEFAULT 'score',
  `stock` int(11) DEFAULT 0,
  `limit_per_user` int(11) DEFAULT 1,
  `subscription_period` int(11) DEFAULT 30,
  `module` varchar(50) NOT NULL,
  `category_1` varchar(50) DEFAULT NULL,
  `category_2` varchar(50) DEFAULT NULL,
  `sort_order` int(11) DEFAULT 0,
  `status` enum('visible','hidden') DEFAULT 'visible',
  `created_at` timestamp DEFAULT CURRENT_TIMESTAMP,
  `updated_at` timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_product_id` (`product_id`),
  KEY `idx_status` (`status`),
  KEY `idx_category` (`category_1`, `category_2`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

#### 购买记录表 (purchases)
```sql
CREATE TABLE `purchases` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_id` int(11) NOT NULL,
  `product_id` varchar(50) NOT NULL,
  `purchase_id` varchar(50) NOT NULL UNIQUE,
  `name` varchar(100) NOT NULL,
  `purchase_time` timestamp DEFAULT CURRENT_TIMESTAMP,
  `expiry_time` datetime NOT NULL,
  `status` enum('pending_activation','activated','expiring','expired') DEFAULT 'pending_activation',
  `subscription_period` int(11) NOT NULL,
  `extra_data` text,
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_purchase_id` (`purchase_id`),
  KEY `idx_status` (`status`),
  KEY `idx_expiry` (`expiry_time`),
  FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

### 3. 修改数据库连接配置

编辑 <mcfile name="Hv4.Function.php" path="Main/Hv4.Function.php"></mcfile> 文件：

```php
function 数据库运行($sql) {
    // 数据库连接参数 - 请修改为您的数据库信息
    $servername = "localhost";        // 数据库服务器地址
    $username = "your_db_username";   // 数据库用户名
    $password = "your_db_password";   // 数据库密码
    $dbname = "fuxstohostv4";        // 数据库名称

    // 其余代码保持不变...
}
```

## 🔧 功能模块详解

### 1. 用户认证系统

#### 登录流程
1. 用户访问首页，点击登录按钮
2. 系统重定向到第三方认证服务 (auth.fuxsto.cn)
3. 用户完成认证后回调到 <mcfile name="CallBack.php" path="Main/Login/CallBack.php"></mcfile>
4. 系统自动注册新用户或登录现有用户
5. 设置 Session 并跳转到 Dashboard

#### 认证配置
在 <mcfile name="index.php" path="Main/Login/index.php"></mcfile> 中配置：
```php
$AppName = "Fuxsto Host V5";                    // 应用名称
$AppLogo = "https://hv4.fuxsto.cn/favicon.ico"; // 应用图标
$AppInfo = "未注册的账号会自动注册!";              // 应用说明
$AppUrl = "https://hv4.fuxsto.cn";              // 应用地址
$AppCallBackUrl = "https://hv4.fuxsto.cn/Main/Login/CallBack.php"; // 回调地址
$AppField = array("qq","id","username","password","register_time","register_ip"); // 需要的字段
```

### 2. 积分和余额系统

#### 货币类型
- **积分 (score)**: 通过签到获得，用于购买免费产品
- **余额 (balance)**: 充值获得，用于购买付费产品

#### 签到系统
- 每日签到获得 80-200 随机积分
- 防止重复签到机制
- 签到状态检查：<mcfile name="CheckIn/index.php" path="Main/CheckIn/index.php"></mcfile>

### 3. 产品管理系统

#### 产品结构
```php
// 产品基本信息
$产品元数据 = [
    'product_id' => 'unique_product_id',
    'name' => '产品名称',
    'price' => 100,
    'currency_type' => 'score', // 或 'balance'
    'stock' => 10,
    'limit_per_user' => 1,
    'subscription_period' => 30, // 天数
    'module' => 'HK-FREE-EP',    // 产品模块
    'category_1' => '虚拟主机',
    'category_2' => '免费版'
];
```

#### 购买流程
1. 用户选择产品
2. 系统检查库存和限购
3. 验证用户余额/积分
4. 扣除费用
5. 调用产品模块开通服务
6. 记录购买信息
7. 更新库存

### 4. 产品模块系统

#### 模块结构
```
ProductsModule/
└── HK-FREE-EP/           # 产品模块目录
    ├── Main.php          # 主要功能文件
    └── s.html           # 产品展示页面
```

#### 模块必需函数
```php
// Main.php 中必须实现的函数

// 开通产品
function 开通产品($产品元数据, $产品唯一标识符) {
    // 实现产品开通逻辑
    return [
        'code' => 200,
        'msg' => '开通成功',
        'data' => [] // 额外数据
    ];
}

// 展示产品
function 展示产品($业务元数据, $产品元数据) {
    // 返回产品展示页面HTML
    return file_get_contents('s.html');
}

// 删除业务
function 删除业务($业务元数据, $产品元数据) {
    // 实现业务删除逻辑
    return ['code' => 200, 'msg' => '删除成功'];
}

// 生成唯一字符串
function 唯一字符串() {
    return 唯一随机字符串(10);
}
```

## 📡 API接口文档

### 基础响应格式
```json
{
    "code": 200,
    "msg": "操作成功或数据内容"
}
```

### 用户相关接口

#### 1. 用户信息获取
- **接口**: `GET /Main/GetInfo/`
- **说明**: 获取当前登录用户信息
- **响应**:
```json
{
    "code": 200,
    "msg": {
        "id": 1,
        "username": "testuser",
        "qq": "123456789",
        "score": 150,
        "balance": "10.50",
        "can_check": true
    }
}
```

#### 2. 每日签到
- **接口**: `POST /Main/CheckIn/`
- **说明**: 用户每日签到获取积分
- **响应**:
```json
{
    "code": 200,
    "msg": "获得积分 120"
}
```

### 产品相关接口

#### 1. 获取商品列表
- **接口**: `GET /Main/GetGoods/`
- **说明**: 获取所有可见商品，按分类组织
- **响应**:
```json
{
    "虚拟主机": {
        "免费版": [
            {
                "product_id": "hk-free-001",
                "name": "香港免费主机",
                "price": "100",
                "currency_type": "积分",
                "stock": 10,
                "description": "免费虚拟主机"
            }
        ]
    }
}
```

#### 2. 购买商品
- **接口**: `POST /Main/BuyGoods/`
- **参数**: 
  - `product_id`: 产品ID
- **响应**:
```json
{
    "code": 200,
    "msg": "开通成功"
}
```

#### 3. 获取用户产品
- **接口**: `GET /Main/GetProducts/`
- **说明**: 获取用户已购买的产品列表
- **响应**:
```json
{
    "code": 200,
    "msg": [
        {
            "purchase_id": "abc123",
            "name": "香港免费主机",
            "purchase_time": "2025-01-01 10:00:00",
            "expiry_time": "2025-01-31 10:00:00",
            "status": "activated"
        }
    ]
}
```

#### 4. 查看产品详情
- **接口**: `GET /Main/ViewProduct/?id=purchase_id`
- **说明**: 查看具体产品的详细信息和管理界面
- **响应**: 返回产品模块的HTML页面

## 🎛️ 管理后台使用

### 访问地址
- 前台首页: `http://your-domain.com/`
- 用户仪表板: `http://your-domain.com/Dashboard/`

### Dashboard 功能

#### 1. 用户中心
- 显示用户基本信息
- 积分和余额显示
- 每日签到功能

#### 2. 产品管理
- 查看已购买产品
- 产品状态监控
- 到期时间提醒

#### 3. 商品购买
- 浏览可用商品
- 按分类筛选
- 一键购买功能

### 前端技术栈
- **Vue.js 3**: 主框架
- **Element Plus**: UI组件库
- **Axios**: HTTP请求库
- **Varlet UI**: 移动端组件库

## 🔨 产品模块开发

### 创建新产品模块

#### 1. 创建模块目录
```bash
mkdir ProductsModule/YOUR-MODULE-NAME
cd ProductsModule/YOUR-MODULE-NAME
```

#### 2. 创建 Main.php
```php
<?php
// 开通产品函数
function 开通产品($产品元数据, $产品唯一标识符) {
    // 在这里实现您的产品开通逻辑
    // 例如：调用第三方API、创建账户等
    
    try {
        // 示例：创建虚拟主机账户
        $result = createHostingAccount([
            'username' => $产品唯一标识符,
            'domain' => $产品元数据['name'],
            'plan' => 'free'
        ]);
        
        if ($result['success']) {
            return [
                'code' => 200,
                'msg' => '开通成功',
                'data' => [
                    'username' => $result['username'],
                    'password' => $result['password'],
                    'control_panel' => $result['cpanel_url']
                ]
            ];
        } else {
            return [
                'code' => 500,
                'msg' => '开通失败：' . $result['error']
            ];
        }
    } catch (Exception $e) {
        return [
            'code' => 500,
            'msg' => '系统错误：' . $e->getMessage()
        ];
    }
}

// 展示产品函数
function 展示产品($业务元数据, $产品元数据) {
    // 读取展示页面模板
    $html = file_get_contents(__DIR__ . '/s.html');
    
    // 替换模板变量
    $html = str_replace('<业务元数据>', json_encode($业务元数据), $html);
    $html = str_replace('<产品元数据>', json_encode($产品元数据), $html);
    
    return $html;
}

// 删除业务函数
function 删除业务($业务元数据, $产品元数据) {
    try {
        // 实现删除逻辑
        $extra_data = json_decode($业务元数据['extra_data'], true);
        
        // 示例：删除虚拟主机账户
        $result = deleteHostingAccount($extra_data['username']);
        
        return [
            'code' => 200,
            'msg' => '删除成功'
        ];
    } catch (Exception $e) {
        return [
            'code' => 500,
            'msg' => '删除失败：' . $e->getMessage()
        ];
    }
}

// 生成唯一字符串
function 唯一字符串() {
    return 唯一随机字符串(10);
}
?>
```

#### 3. 创建展示页面 s.html
```html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>产品管理</title>
    <script src="https://cdn.fss.fuxsto.cn/d/vue@3/dist/vue.global.js"></script>
</head>
<body>
    <div id="app">
        <div class="product-info">
            <h2>{{ productName }}</h2>
            <p>购买时间: {{ purchaseTime }}</p>
            <p>到期时间: {{ expiryTime }}</p>
            <p>状态: {{ status }}</p>
            
            <div v-if="productData.username">
                <h3>账户信息</h3>
                <p>用户名: {{ productData.username }}</p>
                <p>密码: {{ productData.password }}</p>
                <a :href="productData.control_panel" target="_blank">控制面板</a>
            </div>
        </div>
    </div>

    <script>
    const { createApp } = Vue;
    
    createApp({
        data() {
            return {
                businessData: <业务元数据>,
                productMeta: <产品元数据>,
                productData: {}
            };
        },
        computed: {
            productName() {
                return this.businessData.name;
            },
            purchaseTime() {
                return this.businessData.purchase_time;
            },
            expiryTime() {
                return this.businessData.expiry_time;
            },
            status() {
                return this.businessData.status;
            }
        },
        mounted() {
            // 解析额外数据
            if (this.businessData.extra_data) {
                this.productData = JSON.parse(this.businessData.extra_data);
            }
        }
    }).mount('#app');
    </script>
</body>
</html>
```

### 添加产品到数据库
```sql
INSERT INTO `products` (
    `product_id`, `name`, `description`, `price`, `currency_type`, 
    `stock`, `limit_per_user`, `subscription_period`, `module`, 
    `category_1`, `category_2`, `sort_order`, `status`
) VALUES (
    'your-product-001',
    '您的产品名称',
    '产品描述',
    100,
    'score',
    50,
    1,
    30,
    'YOUR-MODULE-NAME',
    '主分类',
    '子分类',
    100,
    'visible'
);
```

## 🔧 系统维护

### 1. 自动化任务

#### 到期提醒任务
- **文件**: <mcfile name="ExpiryReminder.php" path="Main/System/ExpiryReminder.php"></mcfile>
- **功能**: 检查即将到期的产品，发送邮件提醒
- **运行**: 建议每天运行一次

```bash
# 添加到 crontab
0 9 * * * /usr/bin/php /path/to/fuxsto-v4/Main/System/ExpiryReminder.php
```

#### 过期产品清理
- **文件**: <mcfile name="ExpiredProductsCleaner.php" path="Main/System/ExpiredProductsCleaner.php"></mcfile>
- **功能**: 清理已过期的产品，释放资源
- **运行**: 建议每天运行一次

```bash
# 添加到 crontab
0 2 * * * /usr/bin/php /path/to/fuxsto-v4/Main/System/ExpiredProductsCleaner.php
```

### 2. 日志管理

#### 日志位置
- 到期提醒日志: `Log/ExpiryReminder/ExpiryReminder_YYYY-MM-DD.log`
- 系统日志: `Main/System/Log/`

#### 日志清理
```bash
# 清理30天前的日志
find /path/to/fuxsto-v4/Log -name "*.log" -mtime +30 -delete
```

### 3. 数据库维护

#### 定期优化
```sql
-- 优化表
OPTIMIZE TABLE users, products, purchases;

-- 清理过期数据
DELETE FROM purchases WHERE status = 'expired' AND expiry_time < NOW() - INTERVAL 30 DAY;
```

#### 备份脚本
```bash
#!/bin/bash
# 数据库备份脚本
DATE=$(date +%Y%m%d_%H%M%S)
mysqldump -u username -p password fuxstohostv4 > backup_$DATE.sql
```

### 4. 性能监控

#### 关键指标
- 数据库连接数
- 响应时间
- 错误率
- 磁盘使用率

#### 监控脚本示例
```php
<?php
// 简单的健康检查脚本
include_once "Main/Hv4.Function.php";

$health = [
    'database' => false,
    'disk_space' => false,
    'response_time' => 0
];

// 检查数据库连接
$start_time = microtime(true);
$result = 数据库运行("SELECT 1");
$health['response_time'] = microtime(true) - $start_time;
$health['database'] = ($result !== false);

// 检查磁盘空间
$free_space = disk_free_space('.');
$total_space = disk_total_space('.');
$usage_percent = (1 - $free_space / $total_space) * 100;
$health['disk_space'] = ($usage_percent < 90);

header('Content-Type: application/json');
echo json_encode($health);
?>
```

## ❓ 常见问题

### 1. 安装问题

**Q: 数据库连接失败**
A: 检查以下几点：
- 数据库服务是否启动
- 连接参数是否正确
- 用户权限是否足够
- 防火墙是否阻止连接

**Q: 伪静态不生效**
A: 
- Apache: 确保 mod_rewrite 模块已启用
- Nginx: 检查配置文件中的 rewrite 规则
- 确保 .htaccess 文件存在且可读

### 2. 功能问题

**Q: 登录后跳转到空白页**
A: 检查以下几点：
- Session 是否正常启动
- Dashboard 目录权限
- JavaScript 控制台是否有错误

**Q: 产品购买失败**
A: 
- 检查库存是否充足
- 验证用户余额/积分
- 查看产品模块是否正确加载
- 检查数据库表结构

**Q: 邮件发送失败**
A: 
- 检查邮件服务器配置
- 验证 SMTP 设置
- 查看邮件发送日志

### 3. 性能问题

**Q: 页面加载缓慢**
A: 
- 启用 PHP OPcache
- 配置静态文件缓存
- 优化数据库查询
- 使用 CDN 加速

**Q: 数据库查询慢**
A: 
- 添加适当的索引
- 优化 SQL 查询
- 定期清理过期数据
- 考虑读写分离

### 4. 安全问题

**Q: 如何防止 SQL 注入**
A: 
- 使用参数化查询
- 验证和过滤用户输入
- 定期更新 PHP 版本
- 启用错误日志监控

**Q: 如何保护敏感信息**
A: 
- 数据库密码使用环境变量
- 启用 HTTPS
- 定期更换密钥
- 限制文件访问权限

## 📝 更新日志

### V4.0.0 (2025-03-07)
- 🎉 初始版本发布
- ✨ 用户认证系统
- ✨ 产品管理系统
- ✨ 积分余额系统
- ✨ 自动化任务系统
- ✨ 模块化架构

### 计划功能
- 📊 管理员后台
- 💳 在线支付集成
- 📱 移动端优化
- 🔔 实时通知系统
- 📈 数据统计分析

## 🤝 技术支持

### 联系方式
- 项目地址: https://git.hztecha.com/admin/Fuxsto-V4.git
- 问题反馈: 请在项目仓库提交 Issue
- 技术交流: 加入官方QQ群

### 贡献指南
1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

### 开源协议
本项目采用 MIT 协议，详见 LICENSE 文件。

---

**注意**: 本文档会持续更新，请关注最新版本。如有疑问或建议，欢迎提交 Issue 或 Pull Request。