青码悬赏任务平台 V8.7.3 小白搭建教程

一、准备服务器

1. 准备一台 Linux 服务器并安装宝塔面板。
2. 在宝塔“软件商店”安装 Nginx、PHP 8.2、MySQL 5.7、Redis。
3. PHP 8.2 至少确认 pdo_mysql、curl、openssl、mbstring、fileinfo、json 可用。
4. 把准备使用的后端域名解析到服务器，并在宝塔给网站申请 SSL，开启 HTTPS。

二、在宝塔新建后端网站

1. 宝塔左侧点击“网站” → “添加站点”。
2. 填写你的后端域名，例如 api.example.com。
3. PHP 版本选择 PHP-82。
4. 同时创建 MySQL 数据库，记下“数据库名、数据库账号、数据库密码”。这三个后面安装页面要填写。
5. 网站创建完成后进入网站根目录，删除宝塔自动生成的默认首页文件。

三、上传后端完整包

1. 把“悬赏平台后端+运营后台完整包 ZIP”上传到网站根目录。
2. 直接在当前根目录解压，不要再套一层文件夹。
3. 解压后根目录应能直接看到 app、admin、database、install.php、index.php 等文件/目录。
4. 不要随意把整个目录权限改成 777。

四、打开安装页面

浏览器访问：

https://你的后端域名/install.php

按页面从上到下填写：

1. 数据库地址：本机数据库通常填 127.0.0.1。
2. 数据库端口：默认 3306。
3. 数据库名、数据库账号、数据库密码：填写宝塔刚才创建的那一组。
4. Redis 地址：本机通常 127.0.0.1，端口通常 6379。
5. 管理员手机号、管理员名称、管理员密码：这是你以后进入运营后台使用的账号。
6. 授权码：填写软件提供方给你的正版授权码。授权部分只需要这一项。
7. 后端 HTTPS 地址：填写当前后端完整地址，例如 https://api.example.com。

确认无误后点击“开始安装”。

五、安装完成以后

1. 先进入 /admin/，用刚才创建的管理员账号登录。
2. 进入“系统治理 → 授权状态”，确认显示授权有效。
3. 再进入“系统健康”确认 PHP、MySQL、Redis 没有异常。
4. 立刻删除根目录的 install.php 和 upgrade.php。
5. 宝塔定时任务按照后台/安装完成页面给出的维护地址添加。
6. 需要队列常驻时使用 Supervisor 运行 php worker.php default。

六、部署前端

1. 把“悬赏平台前端完整包”解压到电脑一个全新空目录。
2. 使用 HBuilderX 打开这个目录，根目录应直接看到 pages.json、manifest.json、App.vue、index.html。
3. 打开 common/config.js，把 API 地址改成刚才部署的后端 HTTPS 地址。
4. 如果目录里曾经编译过，先删除 unpackage 再重新运行/发行。
5. H5：HBuilderX → 发行 → 网站-H5手机版；把生成文件上传到 H5 网站。
6. App：在 manifest.json 配置 AppID、包名、图标、权限，再进行 Android/iOS 云打包。

七、最常见的错误

• 数据库连接失败：重新核对宝塔数据库名、账号、密码，不要把网站 FTP 密码当数据库密码。
• 打开页面 404：确认 ZIP 是解压在网站根目录，没有多套一层目录。
• H5 请求接口失败：检查 common/config.js API 地址、HTTPS、跨域配置。
• 授权码无效：核对授权码是否输入完整、域名是否已经解析到当前正式站；不要自行修改授权核心文件。
• HBuilderX 编译报错：先确认使用的是完整前端包，删除旧 unpackage 后再编译，并保留完整错误日志。