Skip to content

配置与排障 ​

更新时间:2026/10/16 09:52:54

本页集中说明不会每天修改、但会直接影响部署安全性和运行稳定性的配置。配置变更后要区分“重启服务”“重新部署容器”和“应用网关配置”三种生效方式。网关的域名绑定、CDN 外层接入与对外接口放行独立成章,见网关管理。

内存档位 ​

面板提供三个预设档位,会批量调整服务内存上限和 JVM 类型:

档位推荐宿主内存合计占用JVM 默认适用场景
compact≥ 4 GB约 3.1 GBOpenJ9低配服务器或测试
standard(推荐)≥ 8 GB约 6.3 GBHotSpot常规生产
enhanced≥ 16 GB约 12.9 GBHotSpot高并发生产

面板会根据宿主机内存自动推荐档位,并保留约 512 MB 容差。应用档位只修改配置,必须重新部署受影响的服务才会改变容器限制。单服务手工修改后会标记为“自定义”,重新应用预设档可以恢复统一配置。

运行时配置 ​

部署模式、沙箱、日志级别等业务运行参数统一在面板维护:进入「运维管理 → 业务环境」,在主应用卡片的「应用配置」抽屉中调整。

配置项说明
部署模式DEV 联调模式;PROD 生产模式
沙箱环境沙箱开关,仅 DEV 有效,PROD 下不可开启
超级管理员超管开关,仅 DEV 有效,PROD 下不可开启
交易定时同步订单 / 退款对账的定时同步开关,生产通常建议开启
日志级别INFO / WARN / DEBUG,DEBUG 日志量大,仅排障时临时使用

保存后重启业务容器即可生效,不需要重新部署或重新构建镜像。部署模式对通道子应用同样生效,重启通道子应用容器后自动跟随主应用同值。正式上线前必须把部署模式切换到 PROD,沙箱与超管会随之强制关闭。

不要在服务器上手工编辑运行时配置

这些运行参数由面板统一托管并注入容器,手工编辑面板生成的配置文件会在下次保存配置时被覆盖。PostgreSQL / Redis / Artemis 密码也不在其中维护:正确入口是「运维管理 → 基础环境」对应服务卡片的「修改密码」,面板会同步修改中间件本体,手工改文件只会导致业务容器认证失败、反复重启。

端口暴露 ​

除网关外,基础环境和业务容器默认不发布端口到宿主机,所有服务通过 Docker 网络互通并由网关代理。

模式行为适用场景
off(默认)不发布宿主机端口生产环境
local绑定 127.0.0.1本机调试或 SSH 隧道
public绑定 0.0.0.0特殊场景,必须配合防火墙

切换端口映射后需要重新部署对应容器。除非明确需要,否则不要使用 public,避免数据库、缓存或后端调试端口直接暴露到公网。

生效方式判断 ​

变更类型生效方式
「应用配置」抽屉中的业务运行参数重启对应业务容器
内存档位、运行形态、镜像版本重新部署对应容器
单服务的端口暴露、资源上限、暴露模式drift 横幅出现「重新部署 <该服务>」按钮,仅重建该容器
网关域名、接入模式、接口开关应用网关配置;必要时重新部署网关
Docker 引擎配置按提示重启 Docker
面板账号、安全入口保存后立即生效,入口变更会使旧地址失效

故障排查 ​

安装阶段 ​

在线下载失败或 SHA256 校验失败

确认服务器能访问下载源,重新获取匹配版本的 install.sh 和压缩包。也可以指定镜像源,或改用离线安装。不要跳过 SHA256 校验。

xz 缺失

bash
# RHEL 系
dnf install -y xz
# Debian 系
apt-get install -y xz-utils

安装完成后重新执行安装脚本。

离线安装没有识别安装包

确认 install.sh 与 .xz 文件在同一目录,并使用 bash install.sh 或授权后的 ./install.sh 执行。脚本不检查 $PWD 中的文件。

登录阶段 ​

打开面板返回 404

安全入口开启时,不带入口路径访问 IP 和端口会返回 404。执行:

bash
daxpay entrance show

忘记初始密码

bash
daxpay info
cat /opt/daxpay/installer-initial-password.txt

登录失败被锁定

连续输错密码会触发锁定,执行:

bash
daxpay unlock

开了域名限制或 IP 白名单后面板打不开

从新网络 / 新 IP 访问会被拒绝或伪装 404。执行以下命令查看当前限制,必要时关闭:

bash
daxpay domain show
daxpay ipallow show

两步验证的验证器不可用

验证器丢失且恢复码耗尽时,在服务器执行 daxpay twofactor disable 关闭后重新绑定。全部锁死场景的恢复通道见面板安全 - 锁死恢复通道汇总。

运行阶段 ​

端口冲突

确认 8060 与 80 是否被其他进程占用。面板可以用 --port 更换端口,网关端口则需要停止占用服务或调整网关规划。总览页会列出网关与业务服务的端口冲突(面板自身端口不在检测范围)。

业务后端 unhealthy 或反复重启

优先查看业务容器日志和任务终端:日志提示数据库 / Redis / Artemis 认证失败时,在「运维管理 → 基础环境」对应服务卡片执行「修改密码」重新对齐并重启业务容器;再检查磁盘、内存和运行时配置。

小程序/APP 无法登录

打开「网关管理 → 对外接口」,看「小程序 / APP API」卡片底部的状态行定位当前接入路线:显示失联时,重新开启该开关(兼容方式),或绑定移动端 API 域名并让小程序构建时填入该地址(专用入口);修改后点击「应用网关配置」生效。已发布的小程序更新有存活期,开关或域名变更后存量端需等版本更新覆盖。

页面出现 drift 横幅

提示条按服务精准分流:

  • 「重新部署 <某服务>」:该服务的端口暴露、资源上限或暴露模式已改但尚未同步到容器,点击仅重建这一个容器,其他服务不受影响;
  • 「重新部署」(整栈,附影响面说明):版本、JVM 类型、内存档位等栈级变更影响全部服务,需要重建所有已启用容器、全部服务短暂中断;
  • 「应用网关配置」:网关配置已保存但 nginx 尚未 reload,点击应用即可。

面板显示未部署但容器实际运行

面板依据运行时容器探测和部署快照判断状态。手动启动的容器可能没有快照,先刷新面板;仍未识别时到对应页面执行一次部署,让面板接管当前环境。

获取诊断信息 ​

面板无法访问时,执行以下命令收集状态和日志:

bash
daxpay status
daxpay logs --installer
daxpay logs -f

同时记录操作系统和架构、面板版本、daxpay status 输出、失败任务的完整日志、相关容器状态以及最近一次配置变更。涉及密码、私钥和 token 的日志发给他人前必须脱敏。