仰望星辰工作室

better-staridc-MNBT

better-staridc-MNBT/ docs/guide/install.md 2.9 KB · 106 行 原始文件
Z zfhsh first commit 1 天前
1---
2title: 安装部署
3description: 环境要求、安装部署步骤与快速开始
4---
5
6# 安装部署
7
8## 环境要求
9
10| 依赖 | 版本要求 |
11|------|---------|
12| PHP | **7.4 ~ 8.4**(已全面兼容 PHP 8.x) |
13| MySQL | 5.6+ |
14| Web 服务器 | Nginx / Apache |
15| 宝塔面板 | Linux 版 / Windows 版 |
16| PHP 扩展 | curl、mysqli、json、mbstring |
17| Composer | 可选(仅用于 PHPMailer 安装) |
18
19> 已修复 `each()`、`count($string)`、`get_magic_quotes_gpc()` 等 PHP 8 废弃语法;所有 SQL 已迁移至参数化查询。
20
21## 安装部署
22
23### 1. 准备环境
24
25确保服务器已安装 PHP 7.4+ + MySQL,并已安装宝塔面板。
26
27### 2. 部署代码
28
29```bash
30# 将安装包上传至网站目录并解压
31# 设置网站运行目录为 /
32# 配置伪静态规则(如使用 ThinkPHP 风格 URL)
33```
34
35### 3. 运行安装向导
36
37访问 `http://你的域名/install`,按向导提示完成:
38
391. 欢迎 / 许可协议
402. 环境检测(PHP 版本 >= 7.4.0、curl 等)
413. 数据库配置(填写 MySQL 连接信息)
424. **站点与管理员**(控制面板名称、站长 QQ、公告、管理员账号密码)
435. 初始化数据库(自动导入表结构,或重装模式)
446. 完成安装(完成页会显示你设置的管理员账号)
45
46### 4. 登录管理
47
48- 管理后台:`http://你的域名/admin`
49- 账号/密码:安装向导中设置的管理员信息(不再固定 `admin/123456`)
50- ⚠️ **请妥善保存密码;安装后建议删除 `install` 目录**
51
52### 5. 对接宝塔面板
53
541. 登录管理后台 → 宝塔管理 → 添加宝塔
552. 填写宝塔面板地址、端口、API 密钥
563. 宝塔面板中需开启 API 接口:面板设置 → API 接口 → 开启
574. 设置默认建站目录(Linux:`/www/wwwroot`,Windows:`D:/wwwroot`)
58
59### 6. 配置计划任务(监控系统)
60
61在宝塔面板 → 计划任务中添加:
62
63| 任务类型 | 执行周期 | 执行命令 |
64|---------|---------|---------|
65| 访问 URL | 每分钟 | `http://你的域名/jk_monitor.php?my=API密钥` |
66
67API 密钥可在管理后台 → 系统设置 → API 接口中查看。
68
69### 7. 安装节点插件(可选)
70
71如需使用分布式节点管理 + 违禁词扫描功能:
72
73```bash
74# 1. 在管理后台 → 节点管理 → 添加节点
75# 2. 将 plugins/mnbt_connector/ 部署到宝塔服务器
76# 3. 复制生成的 config.json 配置
77# 4. 重启插件服务
78systemctl restart mnbt-connector.service
79```
80
81## 快速开始
82
83最简部署流程:
84
85```bash
86# 1. 上传代码
87cd /www/wwwroot/your-domain
88# 解压安装包
89
90# 2. 设置权限
91chmod -R 755 .
92chown -R www:www .
93
94# 3. 访问安装向导
95# 浏览器打开 http://your-domain/install
96
97# 4. 登录后台,修改默认密码
98# 浏览器打开 http://your-domain/admin
99
100# 5. 添加第一台宝塔服务器
101# 后台 → 宝塔管理 → 添加宝塔
102
103# 6. 配置默认建站目录和监控任务
104# 后台 → 系统设置 → 基础设置
105# 宝塔面板 → 计划任务 → 添加监控任务
106```