配置与排障
本页集中说明不会每天修改、但会直接影响部署安全性和运行稳定性的配置。配置变更后要区分“重启服务”“重新部署容器”和“应用网关配置”三种生效方式。网关的域名绑定、CDN 外层接入与对外接口放行独立成章,见网关管理。
内存档位
面板提供三个预设档位,会批量调整服务内存上限和 JVM 类型:
| 档位 | 推荐宿主内存 | 合计占用 | JVM 默认 | 适用场景 |
|---|---|---|---|---|
| compact | ≥ 4 GB | 约 3.1 GB | OpenJ9 | 低配服务器或测试 |
| standard(推荐) | ≥ 8 GB | 约 6.3 GB | HotSpot | 常规生产 |
| enhanced | ≥ 16 GB | 约 12.9 GB | HotSpot | 高并发生产 |
面板会根据宿主机内存自动推荐档位,并保留约 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 缺失
# RHEL 系
dnf install -y xz
# Debian 系
apt-get install -y xz-utils安装完成后重新执行安装脚本。
离线安装没有识别安装包
确认 install.sh 与 .xz 文件在同一目录,并使用 bash install.sh 或授权后的 ./install.sh 执行。脚本不检查 $PWD 中的文件。
登录阶段
打开面板返回 404
安全入口开启时,不带入口路径访问 IP 和端口会返回 404。执行:
daxpay entrance show忘记初始密码
daxpay info
cat /opt/daxpay/installer-initial-password.txt登录失败被锁定
连续输错密码会触发锁定,执行:
daxpay unlock开了域名限制或 IP 白名单后面板打不开
从新网络 / 新 IP 访问会被拒绝或伪装 404。执行以下命令查看当前限制,必要时关闭:
daxpay domain show
daxpay ipallow show两步验证的验证器不可用
验证器丢失且恢复码耗尽时,在服务器执行 daxpay twofactor disable 关闭后重新绑定。全部锁死场景的恢复通道见面板安全 - 锁死恢复通道汇总。
运行阶段
端口冲突
确认 8060 与 80 是否被其他进程占用。面板可以用 --port 更换端口,网关端口则需要停止占用服务或调整网关规划。总览页会列出网关与业务服务的端口冲突(面板自身端口不在检测范围)。
业务后端 unhealthy 或反复重启
优先查看业务容器日志和任务终端:日志提示数据库 / Redis / Artemis 认证失败时,在「运维管理 → 基础环境」对应服务卡片执行「修改密码」重新对齐并重启业务容器;再检查磁盘、内存和运行时配置。
小程序/APP 无法登录
打开「网关管理 → 对外接口」,看「小程序 / APP API」卡片底部的状态行定位当前接入路线:显示失联时,重新开启该开关(兼容方式),或绑定移动端 API 域名并让小程序构建时填入该地址(专用入口);修改后点击「应用网关配置」生效。已发布的小程序更新有存活期,开关或域名变更后存量端需等版本更新覆盖。
页面出现 drift 横幅
提示条按服务精准分流:
- 「重新部署 <某服务>」:该服务的端口暴露、资源上限或暴露模式已改但尚未同步到容器,点击仅重建这一个容器,其他服务不受影响;
- 「重新部署」(整栈,附影响面说明):版本、JVM 类型、内存档位等栈级变更影响全部服务,需要重建所有已启用容器、全部服务短暂中断;
- 「应用网关配置」:网关配置已保存但 nginx 尚未 reload,点击应用即可。
面板显示未部署但容器实际运行
面板依据运行时容器探测和部署快照判断状态。手动启动的容器可能没有快照,先刷新面板;仍未识别时到对应页面执行一次部署,让面板接管当前环境。
获取诊断信息
面板无法访问时,执行以下命令收集状态和日志:
daxpay status
daxpay logs --installer
daxpay logs -f同时记录操作系统和架构、面板版本、daxpay status 输出、失败任务的完整日志、相关容器状态以及最近一次配置变更。涉及密码、私钥和 token 的日志发给他人前必须脱敏。