安装指南

晴玖极简发卡系统搭建教程

本教程为完全零基础的小白用户提供详细的晴玖极简发卡系统搭建指南，从域名注册到程序安装，每一步都有详细说明。

一、初始准备

在开始搭建发卡系统前，您需要准备以下三样东西：

1. 域名

域名是您网站的网址，例如 www.example.com。您需要购买并注册一个域名，建议选择容易记忆的域名。

2. 服务器或虚拟主机

您需要一个能运行PHP和MySQL的服务器或虚拟主机，有两种选择：

• 虚拟主机：更适合新手，配置简单，价格便宜

• 云服务器：更灵活，可以完全控制，但需要一定的技术知识

3. 程序安装包

晴玖极简发卡系统的安装包，您可以从以下地址获取：

• 官方地址：https://gitee.com/QtCodeCreators/faka/releases

二、虚拟主机搭建教程

如果您是新手，推荐选择虚拟主机方式，操作简单快捷。

1. 推荐官方虚拟主机

我们强烈推荐使用官方商城的虚拟主机，专为发卡系统优化，一键部署，无需复杂配置：

1. 访问官方商城：https://cdn.79tian.com/api/wxapi/view/index.php

2. 选择并购买适合的虚拟主机套餐

3. 付款后进入用户中心

4. 找到您购买的主机产品，点击【管理】

5. 点击【激活主机】按钮

6. 进入主机控制面板

7. 在控制面板中，找到【文件管理】选项

8. 点击【免费发卡部署】按钮，系统会自动为您部署最新版本的晴玖极简发卡系统

2. 解析域名到虚拟主机

1. 在虚拟主机控制面板中找到【域名管理】或【绑定域名】选项

2. 添加您购买的域名

3. 获取主机提供的DNS服务器地址或IP地址

4. 登录您的域名注册商网站（如阿里云、腾讯云等）

5. 进入域名管理页面，找到DNS设置或域名解析

6. 添加A记录，将您的域名指向主机的IP地址

• 记录类型：选择 "A" 或者 "CNAME"

• 主机记录：@ 或 www（@ 表示直接访问域名，www 表示www开头的域名）

• 记录值：填写虚拟主机的IP地址 或 域名

• TTL：默认值即可（通常是600秒）

7. 保存设置，等待解析生效（通常需要几分钟到几小时不等）

三、云服务器搭建教程

如果您选择使用云服务器，搭建过程会稍微复杂一些，但可以获得更多的控制权和灵活性。

1. 选择云服务器

重要提示：

• 如果您的域名已备案，可以选择国内的服务器（阿里云、腾讯云等）

• 如果没有备案，请选择香港、新加坡或其他海外服务器，否则网站将无法访问

推荐服务器配置：

• 操作系统：CentOS 7/8 或 Ubuntu 18.04/20.04

• 配置：2核4G内存或以上

• 带宽：5Mbps以上

• 硬盘：40GB以上（SSD硬盘更佳）

购买步骤：

1. 阿里云：https://www.aliyun.com/product/ecs

• 注册阿里云账号

• 选择【云服务器ECS】

• 选择配置（注意选择正确的地区）

• 完成支付

2. 腾讯云：https://cloud.tencent.com/product/cvm

• 注册腾讯云账号

• 选择【云服务器CVM】

• 选择配置（注意选择正确的地区）

• 完成支付

2. 安装宝塔面板（推荐）

宝塔面板是一个可视化的服务器管理面板，非常适合新手使用。

安装步骤：

1. 连接到您的服务器

• Windows用户可以使用 宝塔Win版 (https://www.bt.cn/new/product_windows.html)

• Mac/Linux用户可以使用终端，通过SSH命令连接

2. 使用root用户登录服务器，执行以下命令安装宝塔面板：

   if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

3. 安装完成后，会显示宝塔面板的登录信息，包括:

• 宝塔面板网址（通常是 http://服务器IP:8888）

• 用户名和密码

4. 使用浏览器访问宝塔面板，输入用户名和密码登录

3. 安装LNMP环境

LNMP是Linux + Nginx + MySQL + PHP的缩写，这是运行晴玖极简发卡系统所需的环境。

1. 登录宝塔面板

2. 点击左侧【软件商店】

3. 找到【一键部署】选项，选择LNMP

4. 在弹出的窗口中选择如下配置：

• Nginx：最新稳定版

• MySQL：5.7或8.0（推荐5.7）

• PHP：7.4版本（推荐）

• 其他选项保持默认

5. 点击【一键安装】按钮

6. 等待安装完成（这可能需要5-20分钟，取决于服务器性能和网络状况）

4. 安装必要的PHP扩展

1. 在宝塔面板中，点击左侧【软件商店】

2. 找到并点击已安装的PHP版本（如PHP7.4）

3. 在【安装扩展】选项卡中，确保以下扩展已安装：

• fileinfo

• curl

• gd

• openssl

• mysqli

• pdo_mysql

• zip

• json

• mbstring

• xml

4. 如有未安装的扩展，点击右侧的【安装】按钮

5. 解析域名到服务器

1. 登录您的域名注册商网站（如阿里云、腾讯云等）

2. 进入域名管理页面，找到DNS设置或域名解析

3. 添加A记录，将您的域名指向服务器的IP地址

• 记录类型：选择 "A"

• 主机记录：@ 或 www（@ 表示直接访问域名，www 表示www开头的域名）

• 记录值：填写您的服务器IP地址

• TTL：默认值即可（通常是600秒）

4. 保存设置，等待解析生效（通常需要几分钟到几小时不等）

6. 在宝塔面板中创建网站

1. 在宝塔面板中，点击左侧【网站】

2. 点击【添加站点】按钮

3. 填写以下信息：

• 域名：输入您的域名，如 example.com（可以多个域名，用空格分隔）

• 备注：可选，如"发卡网站"

• 根目录：默认即可

• FTP：通常不需要，可以不创建

• 数据库：选择MySQL，设置数据库名和密码（记住这些信息，安装时需要）

• PHP版本：选择7.4

4. 点击【提交】按钮，完成网站创建

四、域名注册教程

如果您还没有域名，可以按以下步骤注册一个：

1. 阿里云域名注册

1. 访问阿里云官网：https://www.aliyun.com/minisite/goods?userCode=4qdccno8

2. 注册并登录阿里云账号

3. 在搜索框中输入您想要的域名，例如 "myshop.com"

4. 系统会显示该域名是否可注册，以及各种后缀的价格

5. 选择您希望注册的域名后缀（如.com, .cn, .net等）

6. 点击【加入清单】，然后【立即结算】

7. 填写域名注册信息（个人或企业信息）

8. 选择域名注册年限（建议至少2年）

9. 完成支付流程

10. 按照要求完成实名认证（中国大陆法规要求）

2. 腾讯云域名注册

1. 访问腾讯云官网：https://curl.qcloud.com/1GohSFyw

2. 注册并登录腾讯云账号

3. 在域名注册页面的搜索框中输入您想要的域名

4. 系统会显示各种后缀的可用性和价格

5. 选择您希望注册的域名后缀

6. 点击【立即购买】，进入购买页面

7. 选择购买年限（建议至少2年）

8. 填写域名所有者信息

9. 完成支付

10. 按要求完成实名认证

3. 域名备案说明（仅限中国大陆服务器）

重要提示： 如果您使用中国大陆的服务器，必须为您的域名完成ICP备案，否则网站将无法访问。

1. 备案流程基本步骤：

• 准备材料：个人身份证或企业营业执照、域名证书等

• 通过服务器提供商（如阿里云、腾讯云）提交备案申请

• 按照流程填写材料并提交

• 等待管局审核（通常需要1-20个工作日）

• 审核通过后获得备案号

2. 如果您不想备案，可以选择：

• 使用香港、新加坡或其他海外服务器

• 使用已备案的域名

• 使用官方虚拟主机（已包含备案域名）

五、安装晴玖极简发卡系统

当您准备好域名和服务器/虚拟主机后，就可以开始安装发卡系统了。

1. 上传程序文件

虚拟主机用户：

如果您使用的是官方商城的虚拟主机，并点击了【免费发卡部署】按钮，程序已自动部署，可以跳过此步骤。

云服务器用户：

1. 下载晴玖极简发卡系统安装包：https://gitee.com/QtCodeCreators/faka/releases

2. 解压下载的zip文件到本地文件夹

3. 使用宝塔面板上传文件：

• 在宝塔面板中，点击左侧【文件】

• 导航到您网站的根目录（通常是/www/wwwroot/您的域名）

• 点击【上传】按钮

• 选择解压后的所有文件和文件夹，上传到服务器

• 或者直接将解压后的文件压缩为zip格式，上传后在宝塔面板中解压

2. 设置文件权限

在宝塔面板的文件管理器中：

1. 找到您上传的发卡系统文件夹

2. 全选所有文件和文件夹

3. 右键点击，选择【权限】

4. 设置权限为：755

5. 选择【递归应用到子目录】

6. 点击【确定】

3. 安装程序

1. 通过您的域名访问网站（确保域名已经解析成功）

2. 系统会自动跳转到安装向导

3. 按照安装向导的提示，完成以下步骤：

   步骤1：环境检测

   步骤2：维信验证（可选）

   步骤3：数据库配置

   步骤4：网站配置

   步骤5：安装完成

• 显示安装成功页面

• 提供访问前台和后台的链接

• 重要： 安装完成后请删除install目录，以防止重新安装

• 如果您有邀请码，可以在此输入

• 使用邀请码可以解锁更多功能（如易支付V1/V2接口等）

• 管理员用户名：设置后台登录用户名

• 管理员密码：设置安全的密码（至少6位）

• 确认密码：再次输入密码

• 网站名称：您的网站名称

• 网站描述：简短的网站描述

• 网站关键词：用逗号分隔的关键词

• 管理员邮箱：用于接收系统通知的邮箱

• 填写网站基本信息：

• 设置管理员账号：

• 邀请码（选填）：

• 点击【下一步】完成安装

• 数据库主机：通常是localhost

• 数据库端口：通常是3306

• 数据库用户名：之前创建的数据库用户名

• 数据库密码：之前设置的数据库密码

• 数据库名：之前创建的数据库名称

• 填写数据库信息：

• 点击【测试连接】确保数据库连接正常

• 点击【下一步】继续

• 您可以选择是否加入维信聊天室

• 加入聊天室可以获得实时技术支持

• 按照页面指引完成验证

• 系统会自动检测服务器环境是否满足要求

• 如果出现红色错误提示，请按照提示修复环境后再继续

4. 登录管理后台

1. 访问 http://您的域名/admin/ 进入管理后台

2. 使用安装时设置的管理员用户名和密码登录

3. 首次登录后，建议立即完善以下设置：

• 系统设置：配置网站基本信息

• 支付设置：配置支付接口参数

• 邮件设置：配置邮件发送服务

• 安全设置：修改默认密码，设置登录IP限制等

六、系统使用建议

1. 安全建议

1. 使用强密码保护管理员账号

2. 定期备份数据库（可在宝塔面板中设置自动备份）

3. 启用HTTPS保护用户数据（可在宝塔面板中一键申请SSL证书）

4. 定期更新系统到最新版本

5. 设置合理的目录权限，防止未授权访问

2. 运营建议

1. 添加商品前请做好市场调研

2. 设置合理的商品价格和库存管理

3. 定期检查卡密库存，避免缺货

4. 配置邮件通知，确保用户能收到卡密

5. 利用系统的访问统计功能分析用户行为

3. 功能开通建议

1. 通过邀请系统解锁更多功能

2. 尝试使用AI宣传文案功能

3. 配置微信推送，及时获取订单通知

4. 开启多语言支持，拓展用户群体

七、常见问题解答

1. 安装过程中的问题

Q: 环境检测不通过怎么办？
A: 检查PHP版本和扩展安装情况，确保满足系统要求。如使用宝塔面板，可以在软件商店中安装缺少的扩展。

Q: 数据库连接失败怎么办？
A: 检查数据库用户名、密码是否正确，确保数据库已创建并授予了正确的权限。

Q: 安装过程中出现500错误怎么办？
A: 查看服务器错误日志，通常是PHP配置或权限问题导致，可以检查文件权限和PHP错误日志。

2. 使用过程中的问题

Q: 支付成功但未发货？
A: 检查支付通道配置是否正确，确认通知URL设置正确，查看系统日志排查问题。

Q: 邮件发送失败怎么办？
A: 检查SMTP设置是否正确，可能的问题包括邮箱密码错误、端口被封、服务器禁止外发邮件等。

Q: 如何添加更多商品分类和商品？
A: 默认情况下有商品数量限制，通过邀请系统可以解锁无限商品和分类功能。

八、获取帮助与支持