程序安装
2025年3月31日大约 5 分钟
程序安装
文档说明
本文档详细指导您完成油站管理系统的安装部署过程。正确的安装配置是系统正常运行的基础，请按照步骤仔细操作。
1. 安装准备
在开始安装之前，请确保您已完成以下准备工作：
| 准备项 | 说明 | 检查方法 |
|---|---|---|
| 域名 | 已购买并完成DNS解析 | 使用ping命令验证解析是否生效 |
| 宝塔面板 | 已安装并能正常登录 | 访问面板地址确认可以登录 |
| 安装包 | 已获取最新程序安装包 | 验证安装包完整性和版本号 |
| 环境要求 | 已满足运行环境要求 | 参照文档检查环境配置 |
重要提示
安装前请务必完成环境配置文档中的所有步骤，确保系统环境满足要求。
2. 添加站点
2.1 创建站点
在宝塔面板中创建新站点并配置基本信息。
操作步骤：
- 登录宝塔面板
- 点击左侧导航栏中的"网站"
- 点击"添加站点"按钮
- 填写以下必要信息：
- 域名：输入已完成解析的域名（必填）
- 数据库：选择MySQL（必选）
- PHP版本：选择8.1（必选）
- 点击"添加"按钮完成站点创建
2.2 数据库配置
系统会自动创建数据库并生成配置信息。
安全警告
- 请务必记录创建完成后生成的数据库信息（数据库名、用户名和密码）
- 这些信息将在后续配置
.env文件时使用 - 建议将这些信息临时保存在安全的地方
- 安装完成后请妥善保管并删除临时记录
3. 上传程序
3.1 上传安装包
将程序文件上传到服务器并进行必要的文件处理。
操作步骤：
在站点列表中点击"根目录"进入项目目录
进入项目目录 上传程序压缩包：
- 点击页面上方的"上传"按钮
- 在弹出窗口中选择程序安装包
- 等待上传完成（大小约为20-50MB，视网络情况可能需要几分钟）
上传程序文件 注意事项
- 上传过程中请勿刷新页面或关闭窗口
- 如遇上传失败，请尝试将文件分割为小文件后上传
- 确保服务器剩余空间足够（至少需要100MB）
3.2 解压处理文件
解压程序文件：
- 上传完成后，双击压缩包在线解压
- 如压缩包较大，解压过程可能需要几分钟
解压程序文件 整理文件结构：
- 进入解压后的文件夹，全选所有文件并点击"剪切"
- 返回上级目录（站点根目录），点击"粘贴"粘贴所有文件
- 确认文件已正确粘贴到根目录
清理临时文件：
- 删除无用的压缩包和空文件夹，保持目录整洁
- 确保根目录下可以看到
public、app等核心目录
清理文件
3.3 设置文件权限
正确的文件权限是系统安全运行的关键：
- 在根目录中选择所有文件和文件夹
- 右键点击并选择"权限"选项
- 将权限修改为755（目录）和644（文件）
- 为特定目录设置写入权限：
/runtime目录：设为777权限/public/uploads目录：设为777权限
权限说明
- 755权限：目录可执行，文件所有者可读写，其他用户可读
- 777权限：所有用户可读写执行，仅用于必须写入的目录
- 权限过大会带来安全隐患，请勿为所有文件设置777权限
4. 配置站点参数
4.1 配置运行目录
正确配置运行目录是系统能够正常访问的关键：
站点配置：
- 点击宝塔左侧"网站"返回站点列表
- 找到并点击刚才创建的站点的"设置"按钮
- 在"网站目录"选项下，将"运行目录"设置为
/public - 点击"保存"按钮应用更改
配置运行目录 重要警告
必须将运行目录设置为
/public，否则将导致系统无法访问或出现安全隐患！
4.2 配置伪静态规则
伪静态配置用于优化URL结构和路由解析：
- 在站点设置中点击"伪静态"选项
- 从下拉列表中选择"ThinkPHP"配置
- 确认规则无误后点击"保存"按钮
说明
伪静态配置的主要作用：
- 优化URL结构，提高用户体验
- 改善搜索引擎索引效果
- 支持系统路由功能正常工作
5. 配置SSL证书
5.1 申请证书
启用HTTPS协议为站点提供加密安全访问：
申请SSL证书：
- 在站点设置中找到"SSL"选项卡
- 选择"申请Let's Encrypt免费证书"
- 选择验证方式（推荐DNS验证）
- 按照提示完成域名验证步骤
申请SSL证书 证书配置：
- 证书申请成功后，系统会自动配置证书
- 勾选"强制HTTPS"选项
- 点击"保存"按钮应用设置
启用HTTPS
证书注意事项
- 免费证书有效期为3个月，到期前需要手动续期
- 证书续期可在宝塔面板SSL管理中一键完成
- 建议设置证书到期提醒，避免证书过期导致访问问题
贡献者
Trenton