aaPanel, 宝塔 y otros paneles
Instalación de HWD POS en un servidor administrado con un panel web como aaPanel (宝塔 / BaoTa), cPanel o Plesk.
Instalar en un servidor administrado con un panel es posible, pero no es la forma recomendada. El panel gestiona el servidor web y PHP a su manera, y los dos servicios de fondo hay que instalarlos aparte. Si puede, use la instalación por red en un servidor limpio.
Lo esencial (cualquier panel)
Sea cual sea el panel, estos son los requisitos:
-
Cree el sitio y ponga su document root en la carpeta
public/. -
Use PHP 8.2+ y active las extensiones indicadas en los requisitos.
-
Cree la base de datos y su usuario desde el panel.
-
Dé la carpeta al usuario del servidor web y permita escritura en
storage/ypublic/uploads/. -
Instale los dos servicios de fondo (impresión y complementos):
sudo bash install-workers.sh /ruta/al/sitio usuario-webinstall-workers.shno viene en el paquete.zip; obténgalo de su proveedor o del mismo lugar que los instaladores. -
Abra el asistente en
http://…/install.
aaPanel / 宝塔 (BaoTa)
aaPanel es la versión internacional de 宝塔 (BaoTa). Los dos funcionan igual.
Instalar el panel
En Ubuntu:
wget -O install.sh https://www.aapanel.com/script/install_6.0_en.sh && sudo bash install.shInstalar la pila LNMP
En el panel, instale Nginx, PHP 8.2 y MySQL/MariaDB.
Configurar PHP
En PHP 8.2 → Extensiones, habilite pdo_mysql, mbstring, curl, zip, gd, xml, sodium, fileinfo y opcache.
En la Configuración de ese PHP, desactive open_basedir o agregue la ruta del proyecto (el sistema escribe en storage/).
Agregar el sitio
Agregue un sitio (dominio o IP). Luego, en el sitio → Directorio (运行目录), cambie el directorio de ejecución a /public.
Reescritura de URL
En el sitio → Rewrite (伪静态), pegue:
location / { try_files $uri $uri/ /index.php?$query_string; }También puede usar la configuración de referencia que se muestra en Servidor web.
Crear la base de datos
Cree una base de datos en el panel y anote su usuario y contraseña. Los necesitará en el asistente del navegador.
Permisos
Dé al usuario de PHP (normalmente www) permiso de escritura en storage/ y public/uploads/.
Servicio de impresión
En Supervisor (进程守护) del panel, agregue un proceso que ejecute:
php /www/wwwroot/HWDPOS/scripts/print_worker.php --daemonSi va a imprimir, instale cups y chromium por SSH.
Abrir el sitio
Abra el sitio en el navegador. Aparece el asistente /install.
En un servidor administrado con panel, el comando hwdpanel y las reparaciones de check.sh están pensados para la estructura del instalador estándar (/var/www/HWDPOS, servicios de systemd). Algunas de sus opciones pueden no aplicar.