珑大 服务中心
登录 客户控制台
返回官方动态
文档

DBErp V3.0 安装教程

DBErp

DBErp V3.0 是一套面向中小企业的进销存 ERP 系统，支持商品资料、客户供应商、仓库库存、采购、销售、往来结算、报表查询等基础业务场景。 本文主要介绍如何通过 下载安装包 的方式手动安装 DBErp V3.0

DBErp V3.0 是一套面向中小企业的进销存 ERP 系统，支持商品资料、客户供应商、仓库库存、采购、销售、往来结算、报表查询等基础业务场景。

本文主要介绍如何通过 下载安装包 的方式手动安装 DBErp V3.0，重点说明：

  • DBPanel 手动安装 DBErp；

  • 宝塔面板手动安装 DBErp。

官方推荐使用 DBPanel 极速安装方式，也可以参考：

https://support.loongdom.cn/updates/dbpanel-dberp

一、下载安装包

请先进入珑大支撑中心下载页面，下载 DBErp V3.0 安装包：

https://support.loongdom.cn/downloads

在下载页面中找到 DBErp V3.0 对应的 Web 安装包并下载。

说明：

  • Web 安装包适合全新安装；

  • 不需要手动执行 composer install；

  • 不需要自行拉取源码；

  • 上传解压后，通过浏览器访问安装向导即可完成初始化安装。

二、安装环境要求

安装 DBErp V3.0 前，请确认服务器环境满足以下要求。

1. 基础环境

推荐环境：

  • PHP 8.3 或更高版本；

  • MySQL 8.0+ / MariaDB 10.5+；

  • Nginx 或 Apache；

  • 支持 PHP 网站部署。

2. PHP 扩展要求

请确认 PHP 已安装并启用以下扩展：

bcmath
ctype
curl
dom
fileinfo
filter
hash
intl
json
libxml
mbstring
openssl
pcre
pdo
pdo_mysql
session
simplexml
tokenizer
xml
xmlreader
xmlwriter
zip

如果使用服务器面板安装 PHP，请在 PHP 扩展管理中检查并启用这些扩展。

三、DBPanel 手动安装 DBErp

适用于通过 DBPanel 手动部署 DBErp V3.0 的用户。

DBPanel 对珑大产品做了适配，手动安装 DBErp 时，创建网站时选择网站类型 「珑大产品-laravel」 即可。

选择该类型后，无需手动设置运行目录，也无需手动配置伪静态。上传安装包并解压后，直接通过 Web 访问安装向导即可完成部署。

1. 创建网站

在 DBPanel 中创建新网站。

创建网站时请注意：

  • 网站类型选择：珑大产品-laravel；

  • PHP 版本选择：PHP 8.3 或更高版本；

  • 绑定你的域名或服务器 IP；

  • 网站目录选择准备安装 DBErp 的目录。

选择 珑大产品-laravel 后，DBPanel 会自动处理 Laravel 项目所需的网站入口和访问规则。

2. 创建数据库

在 DBPanel 中创建一个新的数据库。

请记录以下信息，安装向导中会用到：

数据库地址
数据库端口
数据库名称
数据库用户名
数据库密码

常见示例：

数据库地址：127.0.0.1
数据库端口：3306
数据库名称：dberp
数据库用户名：dberp
数据库密码：你的数据库密码

注意：

  • 建议使用空数据库安装；

  • 数据库编码建议使用 utf8mb4；

  • 数据库账号需要具备建表、写入和修改表结构权限。

3. 上传并解压安装包

进入 DBPanel 网站文件管理，将下载好的 DBErp V3.0 Web 安装包上传到网站目录。

解压后，请确认网站目录中可以看到类似以下文件和目录：

app
bootstrap
config
database
public
resources
routes
storage
vendor
artisan
.env.example

注意：

  • 不要把安装包外层临时目录作为网站根目录；

  • DBErp 程序根目录下应能看到 artisan 文件；

  • vendor 目录应随安装包一同存在；

  • 不需要手动执行 composer install。

4. 无需手动设置运行目录和伪静态

使用 DBPanel 安装 DBErp 时，只要网站类型选择了 「珑大产品-laravel」，不需要再手动设置：

  • 网站运行目录；

  • Nginx 伪静态；

  • Laravel 入口规则。

DBPanel 会根据网站类型自动处理相关配置。

5. 访问安装向导

完成安装包上传和解压后，在浏览器中访问你的域名或服务器 IP。

例如：

https://你的域名

或：

http://服务器IP

首次访问时，系统会进入 DBErp 安装向导。

安装向导会引导你完成：

  1. 环境检测；

  2. 数据库配置；

  3. 系统基础信息填写；

  4. 管理员账号创建；

  5. 初始化数据表；

  6. 完成安装。

6. 完成安装后检查

安装完成后，使用创建的管理员账号登录 DBErp。

建议检查：

  • 登录页面是否正常；

  • 系统是否能正常进入；

  • 左侧菜单是否正常显示；

  • 工作台是否正常打开；

  • 商品、客户、供应商、仓库等基础资料页面是否正常；

  • 采购、销售、库存、结算等业务页面是否正常。

四、宝塔面板手动安装 DBErp

适用于通过宝塔面板手动部署 DBErp V3.0 的用户。

1. 创建网站

进入宝塔面板，打开「网站」管理，创建新站点。

建议：

  • 绑定你的域名或服务器 IP；

  • PHP 版本选择 PHP 8.3 或更高版本；

  • 创建站点时可同时创建数据库，也可以后续单独创建数据库。

示例网站目录：

/www/wwwroot/dberp

具体路径以宝塔面板实际显示为准。

2. 创建数据库

如果创建网站时没有同时创建数据库，请在宝塔面板「数据库」中创建一个新的 MySQL 数据库。

请记录：

数据库地址
数据库端口
数据库名称
数据库用户名
数据库密码

常见示例：

数据库地址：127.0.0.1
数据库端口：3306
数据库名称：dberp
数据库用户名：dberp
数据库密码：你的数据库密码

注意：

  • 建议使用空数据库安装；

  • 数据库编码建议使用 utf8mb4；

  • 数据库账号需要具备建表、写入和修改表结构权限。

3. 上传并解压安装包

进入宝塔面板「文件」管理，打开 DBErp 网站目录，将下载好的 DBErp V3.0 Web 安装包上传到网站目录。

解压后，请确认网站目录中可以看到类似以下文件和目录：

app
bootstrap
config
database
public
resources
routes
storage
vendor
artisan
.env.example

注意：

  • 不要把安装包外层临时目录作为网站根目录；

  • DBErp 程序根目录下应能看到 artisan 文件；

  • vendor 目录应随安装包一同存在；

  • 不需要手动执行 composer install。

4. 设置网站运行目录

DBErp 基于 Laravel 构建，宝塔面板中需要将网站运行目录设置为：

/public

如果 DBErp 程序目录为：

/www/wwwroot/dberp

那么实际访问入口应为：

/www/wwwroot/dberp/public

在宝塔面板中，可进入对应网站设置，将运行目录修改为 /public。

不要直接把网站运行目录指向 DBErp 程序根目录，否则可能出现无法访问、静态资源异常或安全风险。

5. 配置伪静态

如果宝塔网站环境使用的是 Nginx，请进入网站设置中的「伪静态」，添加以下规则：

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

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

location ^~ /private-storage/ {
    try_files $uri /index.php?$query_string;
}

如果网站环境使用的是 Apache，一般无需手动配置伪静态，系统会自动识别 public/.htaccess。

6. 设置目录权限

请确保 PHP 运行用户对以下目录有写入权限：

storage
bootstrap/cache

如果安装过程中提示目录不可写，可以在宝塔文件管理中检查目录权限和所属用户。

7. 访问安装向导

完成上传、解压、运行目录、伪静态和权限配置后，在浏览器中访问你的域名或服务器 IP。

例如：

https://你的域名

或：

http://服务器IP

首次访问时，系统会进入 DBErp 安装向导。

安装向导会引导你完成：

  1. 环境检测；

  2. 数据库配置；

  3. 系统基础信息填写；

  4. 管理员账号创建；

  5. 初始化数据表；

  6. 完成安装。

8. 完成安装后检查

安装完成后，使用创建的管理员账号登录 DBErp。

建议检查：

  • 登录页面是否正常；

  • 系统是否能正常进入；

  • 左侧菜单是否正常显示；

  • 工作台是否正常打开；

  • 商品、客户、供应商、仓库等基础资料页面是否正常；

  • 采购、销售、库存、结算等业务页面是否正常。

五、安装向导填写说明

1. 数据库信息

安装过程中，需要填写数据库连接信息。

常见填写方式：

数据库地址：127.0.0.1
数据库端口：3306
数据库名称：dberp
数据库用户名：dberp
数据库密码：你的数据库密码

如果数据库与网站不在同一台服务器，请填写实际数据库服务器地址。

2. 系统基础信息

根据安装向导提示填写系统名称、企业名称等基础信息。

这些信息会用于系统展示和基础档案初始化，安装后也可以在系统设置中继续维护。

3. 管理员账号

请设置管理员登录账号和登录密码。

建议：

  • 使用便于记忆但不简单的账号；

  • 使用安全性较高的密码；

  • 不要使用 123456、admin123 等弱密码。

安装完成后，你将使用该账号登录 DBErp。

六、常见问题

1. DBPanel 安装时还需要设置运行目录吗？

不需要。

DBPanel 创建网站时，只要网站类型选择 「珑大产品-laravel」，面板会自动处理 Laravel 项目入口，无需手动设置运行目录。

2. DBPanel 安装时还需要配置伪静态吗？

不需要。

DBPanel 选择 「珑大产品-laravel」 后，会自动处理访问规则，无需再手动配置 Nginx 或 Apache 伪静态。

3. 宝塔访问后显示 404 或无法进入安装向导

请检查：

  • 网站运行目录是否设置为 /public；

  • Nginx 伪静态是否正确；

  • 安装包是否解压到了正确目录；

  • public/index.php 是否存在。

如果使用 Apache，一般无需手动配置伪静态，请确认 public/.htaccess 文件存在。

4. 安装时提示数据库连接失败

请检查：

  • 数据库地址是否正确；

  • 数据库端口是否正确；

  • 数据库用户名和密码是否正确；

  • 数据库是否已经创建；

  • 数据库账号是否有足够权限。

5. 页面样式异常或静态资源加载失败

请检查：

  • 网站访问入口是否正确；

  • 宝塔运行目录是否设置为 /public；

  • 浏览器缓存是否需要清理；

  • Nginx 伪静态是否包含 /livewire 规则。

DBPanel 用户请确认网站类型是否选择了 「珑大产品-laravel」。

6. 安装时提示目录不可写

请检查以下目录权限：

storage
bootstrap/cache

确保 PHP 运行用户对这些目录有写入权限。

7. 安装完成后无法登录

请确认：

  • 管理员账号是否输入正确；

  • 密码是否输入正确；

  • 数据库是否正常连接；

  • .env 配置是否正确；

  • 服务器时间是否正常。

七、下载与反馈

DBErp V3.0 安装包下载地址：

https://support.loongdom.cn/downloads

DBPanel 极速安装教程：

https://support.loongdom.cn/updates/dbpanel-dberp

如果你在安装或使用 DBErp V3.0 过程中遇到问题，或者有功能建议、体验反馈、插件需求，可以通过珑大支撑中心提交：

https://support.loongdom.cn/feedback

我们会根据用户反馈，持续优化 DBErp 的安装体验、业务功能、插件扩展能力和系统稳定性。