点可云进销存 1Panel 面板安装教程（V8.4.0+）

版本说明：V8.3.3 之后即 V8.4.0。V8.4.0 为底层框架升级版本，PHP 版本要求相应提高，安装时 PHP 版本需为 8.3 及以上。本教程适用于 V8.4.0 及以上版本。

ERP 进销存 V8 安装注意事项：

数据库版本推荐 8 以上，最低支持 5.7 版本，PHP 版本最低选择 8.3 版本，或者选择 8.3 版本以上。

部署前请先确认：服务器已安装 1Panel，OpenResty / Nginx 已启动，80 / 443 端口已在云厂商安全组和 1Panel 防火墙中同时放行（两处缺一不可，这是新手最常踩的坑）。

一、创建 PHP 运行环境

打开左侧 运行环境 → PHP → 创建，按以下内容填写：

• 名称：php
• 应用：PHP
• 大版本：8
• PHP 版本：8.3.36及以上
• 容器名称：php
• 扩展模版选择：Default

点击 确认，等待状态变为 已启动。

二、创建数据库

数据库创建需要先创建用户，打开左侧 数据库 点击顶部 用户 创建用户：

用户名、密码按需填写；（用于后续程序安装中）

回到左侧 数据库 → 创建，按以下内容填写：

• 数据库名称：erp
• 用户名：选择刚创建的用户

三、创建网站

打开左侧 网站 → 创建，按以下内容填写：

• 主域名：服务器公网 IP；如有域名建议填写域名
• 代号：与域名或 IP 保持一致
• 运行环境：选择第一步创建的 php

点击 确认，网站状态显示 已启动 后继续。

四、上传并解压程序

打开网站，点击网站目录，进入网站根目录，例如：

/opt/1panel/www/sites/域名/index

上传 点可云进销存.zip 并解压。

五、运行目录修改选择 /src/public

安装文件解压在 1Panel 中后，需要将运行目录修改选择 /src/public。

打开左侧 网站，选择安装的站点，在右侧点击 设置，在弹框中选择 网站目录，将 运行目录 选择为 src/public，保存并刷新。

这一步很关键，不改到 src/public 会出现 404。

六、伪静态配置（选择 Laravel 方案）

进入 网站 → 配置 → 伪静态。如果系统提供  laravel5 方案，直接选择并保存。如果没有对应方案，可手动填写：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

保存后重载 Nginx。

不配置伪静态，Laravel 路由访问会 404。

七、目录权限设置

如果安装向导检测目录权限不通过，可按下面方式处理。

1、打开网站文件目录，顶部文件地址回到域名文件下，例：/opt/1panel/www/sites/域名
2、找到index的文件，在右侧操作中点击更多，点击编辑权限；
3、将权限全部勾选，读取、写入、可执行，都勾选后，最下面的“同时修改子文件属性”同样勾选；
4、用户、用户组需要设置为：lighthouse  ；

八、运行安装向导

浏览器访问网站域名，进入 软件安装向导。

环境检测页确认：Nginx 正常、PHP 8.3.36 正常、./、storage、install、.config 等目录权限正常。如有红色项，回到 运行环境 → PHP → 扩展 安装对应扩展，然后重新检测。

数据库配置页填写：

• 数据库写入：快捷模式
• 数据库地址：1Panel 数据库容器连接地址
• 数据库端口：1Panel 数据库容器连接端口
• 数据库名称：1Panel 数据库名称
• 数据库账号：授权用户名（用户名是@%前面，不包含@%）
• 数据库密码：设置的数据库密码

等待数据写入完成，期间不要关闭页面。安装完成后会显示默认账号密码：

默认账号：admin
默认密码：admin888

九、进入系统并授权

使用默认账号登录系统。弹出 产品授权 窗口后，输入授权码并确认，部署完成。

授权码在官网登录账号，账户中心，订单列表中。

关于函数库 / 扩展出错的问题

环境检测页常见的报错有 symlink、exec、fileinfo 等（如有其他错误提示同样参照以下处理）：

• symlink、exec 属于被禁用的函数，需在 PHP 运行环境的禁用函数中删除对应项；
• fileinfo 属于未安装的扩展，需在 运行环境 → PHP → 扩展 中安装；

常见问题排查

• 打开网站 404：运行目录未指向 src/public，修改网站目录为 src/public。
• 子页面 404：伪静态未配置，选择 Laravel5 方案。
• 安装向导报权限错误：storage、bootstrap/cache 不可写，按第七步修正权限。
• PHP 扩展缺失：未安装对应扩展，在 PHP 运行环境中补装。
• 网站无法访问：端口未放行，检查云安全组和 1Panel 防火墙。