常见问答

在服务器上打开面板，选择选项 7（Restablecer contraseña，重置密码），然后选择用户并输入新密码：

sudo hwdpanel

也可以直接使用管理工具：

php /var/www/HWDPOS/scripts/hwd-admin.php list-users
php /var/www/HWDPOS/scripts/hwd-admin.php reset-password <user>

第二条命令会以交互方式要求输入新密码。参见 hwdpanel。

安装程序会生成该密码，并保存在一个只有 root 可读的文件中：

sudo cat /var/www/HWDPOS/deploy/DB-CREDENTIALS.txt

在仅数据库服务器上没有应用程序文件夹，因此它位于 /root/HWDPOS-DB-CREDENTIALS.txt。也可以通过 sudo hwdpanel → 选项 8（Credenciales BD，数据库凭据） 查看。

如果还可以选择，请使用 Ubuntu Server 24.04 LTS：这是 HWD POS 主要配置和测试所用的系统。Ubuntu 22.04、Debian 12、AlmaLinux 9/8、Rocky Linux、RHEL 和 CentOS Stream 也受支持，最终功能完全相同。参见系统要求。

不可以。不支持 Windows Server：系统依赖 systemd 服务、Linux 打印路径和 pcntl。PHP 版本低于 8.1 的任何 Linux 也不受支持。

安全。它不会删除数据，而是把权限、Web 服务器配置、服务和防火墙恢复到正确状态。它还会保留已经可用的数据库密码并将其应用到数据库用户上，因此凭据文件与数据库始终保持一致。这是修复被人改动过的服务器最快的方法。

最简单的方法是带上 WEB_PORT 重新运行安装程序：

curl -fsSL https://3r.com.pa/hwdpos_inst/bootstrap.sh | sudo WEB_PORT=8080 bash

它会同时更新虚拟主机、Web 服务器的 Listen、防火墙以及摘要中的地址。22、3306 和 8108 端口会被拒绝，因为系统已经在使用它们。之后，终端和平板必须使用带端口的地址，例如 http://192.168.1.50:8080/。参见 Web 服务器配置。

需要出站访问：用于激活许可证、检查更新和发送邮件。它不需要能从互联网访问到；所有功能都可以在局域网内运行。

不会。只有当您想在店外使用服务器时，才需要将其发布到互联网上；这种情况下，请自行添加 HTTPS（例如使用 Let's Encrypt）。安装程序不会配置它。

在系统内部操作：Sistema → Actualizaciones（系统 → 更新）。它会检查是否有新版本、下载新版本、备份数据库和文件，然后应用更新。更新只涉及系统代码，不会改动插件、配置或上传的文件。

请先在 Sistema → Respaldos de base de datos（系统 → 数据库备份）中备份数据库。如果更新改动了后台服务，请用 sudo hwdpanel → 选项 17 重启一次。参见升级与重新安装。

sudo rm -f /var/www/HWDPOS/storage/installed.lock
sudo mysql -e "DROP DATABASE hwd_pos;"

然后再次打开 http://SERVER-IP/install，运行设置向导。

不需要。Typesense 是一个可选的、支持容错拼写的搜索引擎。没有它（或它停止运行）时，所有搜索都会使用常规的 SQL 搜索，因此搜索功能永远不会丢失。参见 Typesense 搜索。

只有在打印 A4 文档以及通过 IPP/AirPrint 使用网络打印机时才需要。热敏打印机（ESC/POS，80 mm 和 58 mm）无需它们即可工作。在不打印的服务器上使用 WITH_PRINTING=no。参见打印。