hwdpanel 服务器面板
通过文本菜单运维 HWD POS 服务器，无需使用 Web 界面。
安装程序会在服务器上创建 hwdpanel 命令（/usr/local/bin/hwdpanel）。它是一个本地文本菜单，用于服务器的日常运维：重启服务、重置密码、查看凭据、诊断等，全部无需打开 Web 界面。
打开面板
sudo hwdpanel屏幕顶部显示项目目录、PHP 版本和各服务的状态。输入选项编号并按回车即可。
如果 hwdpanel 不存在（例如部分安装之后），可以通过 check.sh 的 «Panel de administración»（管理面板）选项重新安装。
菜单选项
| 分组 | 选项 | 作用 |
|---|---|---|
| «Sitio web»（网站） | 1 / 2 / 3 | 重启、启动或停止 Web 服务器和 PHP-FPM。 |
| «Impresión»（打印） | 4 / 5 / 6 | 重启、启动或停止打印 worker（hwpos-print）。 |
| «Administración»（管理） | 7 | 重置任意用户或管理员的密码（列出用户及其角色）。 |
| 8 | 显示数据库凭据（从应用的实际配置中读取）。 | |
| 9 | 显示运行环境。 | |
| 10 | 运行 check.sh 诊断。 | |
| 11 | 显示服务器 IP 和访问 URL。 | |
| 12 | 从网络更新面板本身。 | |
| «Inteligencia»（AI） | 13 | 安装或更新 AI 环境（可选，见下文）。 |
| «Búsqueda»（搜索） | 14 | 安装或更新搜索服务（Typesense，开机自启）。 |
| 15 | 管理搜索 API key（列出、创建、删除）。 | |
| «Servicios»（服务） | 16 | 安装或重新安装后台服务（打印 + 插件）。 |
| 17 | 全部重启（网站 + PHP + worker）。 | |
| 18 | 查看后台服务日志。 | |
| «Capacidad»（容量） | 19 | 数据库连接数和 PHP 请求容量。 |
| «Reparar»（修复） | 20 | Apache：修复配送应用所用的请求头（当其提示 «Sin conexión»（无连接）时）。 |
| 0 | 退出。 |
连接容量（选项 19）
安装程序根据服务器内存确定 PHP 进程数（每个进程约 60 MB，介于 10 到 80 之间），并始终使其低于数据库的连接数上限。选项 19 显示当前值，可以应用推荐值、手动输入，或将峰值计数器清零以便从今天开始重新统计。在 HWD POS 内部的 «Sistema → Capacidad de conexiones»（系统 → 连接容量）中也可以查看相同信息。
更新之后
如果某次更新改动了后台服务，请用选项 17 重启一次。
AI 环境（选项 13）
创建一个包含 CatBoost 的 Python 虚拟环境，在应用中登记该解释器，并安装和启动重新训练服务（hwpos-ai.service，重启后自动启动）。之后在 HWD POS 的 /admin/ai 中启用它。该功能是可选的，由于 AI 软件包体积较大，默认不安装。
搜索服务（选项 14 和 15）
参见 Typesense 搜索。
重置密码
在面板中选择选项 7，选择用户并输入新密码。
也可以直接使用管理工具：
php /var/www/HWDPOS/scripts/hwd-admin.php list-users
php /var/www/HWDPOS/scripts/hwd-admin.php reset-password admin
php /var/www/HWDPOS/scripts/hwd-admin.php reset-password admin YOUR_NEW_PASSWORD第二条命令以交互方式询问新密码。第三条命令直接设置所给的密码。
在命令行中传递密码会使其留在 shell 历史记录中。请优先使用交互方式。
其他管理命令
scripts/hwd-admin.php 会启动应用并使用其自身的数据库连接，因此始终读取当前配置：
php /var/www/HWDPOS/scripts/hwd-admin.php db-info # database connection details
php /var/www/HWDPOS/scripts/hwd-admin.php env # environment
php /var/www/HWDPOS/scripts/hwd-admin.php list-users # users and roles更新面板
面板可以下载其最新版本并替换本地副本。替换之前，它会：
- 创建一个扩展名为
.bak的备份副本； - 检查新文件的语法；
- 仅在检查通过时才替换本地版本。
要更新，请在面板中选择选项 12，或运行：
sudo bash /var/www/HWDPOS/deploy/check.sh --update-panel在 check.sh 菜单中也可以使用选项 U。