Docs
指南安装

aaPanel、宝塔及其他面板

在由 aaPanel(宝塔 / BaoTa)、cPanel 或 Plesk 等 Web 控制面板管理的服务器上安装 HWD POS。

可以在由控制面板管理的服务器上安装,但这不是推荐方式。面板会按自己的方式管理 Web 服务器和 PHP,而且两个后台服务需要单独安装。条件允许的话,请在全新服务器上使用网络安装。

基本要求(适用于任何面板)

无论使用哪种面板,都需要满足以下要求:

  1. 创建站点,并将其文档根目录设为 public/ 文件夹。

  2. 使用 PHP 8.2+,并启用系统要求中列出的扩展。

  3. 在面板中创建数据库及其用户。

  4. 将文件夹交给 Web 服务器用户,并允许写入 storage/ 和 public/uploads/。

  5. 安装两个后台服务(打印和插件):

    sudo bash install-workers.sh /path/to/site web-user

    install-workers.sh 不包含在 .zip 软件包中;请向供应商获取,或从获取安装程序的同一位置下载。

  6. 打开 http://…/install 处的安装向导。

aaPanel / 宝塔(BaoTa)

aaPanel 是宝塔(BaoTa)的国际版。两者的操作方式相同。

安装面板

在 Ubuntu 上:

wget -O install.sh https://www.aapanel.com/script/install_6.0_en.sh && sudo bash install.sh

安装 LNMP 环境

在面板中安装 Nginx、PHP 8.2 和 MySQL/MariaDB。

配置 PHP

在 PHP 8.2 → Extensions(扩展)中,启用 pdo_mysql、mbstring、curl、zip、gd、xml、sodium、fileinfo 和 opcache。

在该 PHP 的 Configuration(配置)中,禁用 open_basedir,或者将项目路径加入其中(系统需要写入 storage/)。

添加站点

添加一个站点(域名或 IP)。然后在站点设置 → Site directory(运行目录)中,将运行目录改为 /public。

URL 重写

在站点 → URL rewrite(伪静态)中粘贴:

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

也可以使用 Web 服务器中给出的参考配置。

创建数据库

在面板中创建数据库,并记下其用户名和密码。安装向导中会用到。

权限

为 PHP 用户(通常是 www)授予 storage/ 和 public/uploads/ 的写入权限。

在面板的 Supervisor(进程守护)中,添加一个运行以下命令的进程:

php /www/wwwroot/HWDPOS/scripts/print_worker.php --daemon

如果需要打印,请通过 SSH 安装 cups 和 chromium。

打开站点

在浏览器中打开站点,会出现 /install 安装向导。

在由面板管理的服务器上,hwdpanel 命令和 check.sh 的修复功能是针对标准安装程序的布局(/var/www/HWDPOS、systemd 服务)设计的,其中部分选项可能不适用。

本页目录