安装、升级与卸载
本页说明如何把 DaxPay 运维面板安装到 Linux 服务器，以及安装后的托管、升级、卸载和目录结构。首次部署业务系统请继续阅读部署引导；只想快速完成一次部署，可直接看一键部署。
安装前提
| 项目 | 要求 | 说明 |
|---|---|---|
| 架构 | x86_64（amd64） | 当前安装包不支持 arm64 |
| 操作系统 | Ubuntu / Debian / CentOS / Rocky / RHEL / AlmaLinux / Fedora | 其他发行版仅提示警告，不一定阻断 |
| 磁盘 | 安装目录所在分区至少 500 MB | 业务镜像和数据还需要额外空间 |
| 权限 | root 或 sudo | 需要安装依赖、操作 Docker 和绑定端口 |
| 必需依赖 | xz、sha256sum | 缺失的 xz 会按发行版尝试自动安装 |
| 在线安装依赖 | curl 或 wget | 用于下载脚本和安装包 |
建议生产服务器使用 Ubuntu 22.04 及以上版本、8 GB 以上内存，并提前确认 8060、80、443 端口没有被其他服务占用。
在线安装
在线安装会下载脚本和 amd64 安装包，完成 SHA256 校验、解压、安装和启动：
curl -fsSL https://download.daxpay.top/open/script/install.sh | sudo bash
# 或
wget -qO- https://download.daxpay.top/open/script/install.sh | sudo bash脚本执行流程如下：
- 检查架构、发行版、磁盘和运行权限。
- 检查或安装 xz，并确认 curl、sha256sum 可用。
- 下载压缩包并执行强制 SHA256 校验。
- 安装到 /opt/daxpay，创建 daxpay 命令软链。
- 按选择生成 systemd 服务，或使用后台进程模式启动。
- 启动面板并打印带安全入口的完整访问地址和初始管理员密码。
安装完成后不要只保存 IP 和端口，必须保存完整地址，例如：
http://192.168.1.10:8060/k3x9m2qp4w7nbd5e其中最后一段是随机安全入口。直接访问 IP 和端口返回 404 属于正常防护；忘记入口时执行 daxpay entrance show。
SHA256 校验失败
校验失败时安装会直接终止，不会跳过校验强行安装。常见原因是下载不完整、脚本和压缩包版本不匹配或下载源异常。重新获取同一版本的 install.sh 与安装包后再试；网络受限时使用离线安装。
离线安装
离线安装适合服务器访问不了下载源的场景。它只解决安装包传输问题，DaxPay 后续拉取 Docker 镜像、安装依赖和访问支付渠道仍然需要网络。
准备以下两个文件并放到同一目录：
| 文件 | 作用 |
|---|---|
| install.sh | 安装脚本，内置对应安装包的 SHA256 |
| dax-pay-installer-linux-amd64.xz | 运维面板压缩包 |
在目标服务器执行：
sudo bash install.sh或：
chmod +x install.sh
sudo ./install.sh脚本只检查脚本自身所在目录的 .xz 文件，不检查当前工作目录。两个文件缺一不可，也必须来自同一版本，否则会因 SHA256 不匹配而终止。
systemd 与后台模式
安装器会自动判断当前环境是否支持 systemd。普通 Linux 服务器通常使用 systemd；容器、WSL 等环境没有可用 systemd 时会退回后台进程模式。
| 项目 | systemd 可用 | systemd 不可用（容器 / WSL） |
|---|---|---|
| 开机自启 | 支持 | 不支持 |
| 崩溃拉起 | Restart=on-failure | 不支持 |
| 启停命令 | systemctl start daxpay-panel | daxpay start / daxpay stop |
| 端口 | 默认 8060 | 可用 --port 自定义 |
| 日志 | journalctl -u daxpay-panel | <workdir>/logs/installer-stdout.log |
服务单元位于 /etc/systemd/system/daxpay-panel.service，服务名为 daxpay-panel。安装时使用 --yes 会采用默认选项并跳过交互确认。
升级
升级会保留工作目录和业务数据。需要强制重新下载并覆盖当前面板时使用 --force：
# 在线升级
curl -fsSL https://download.daxpay.top/open/script/install.sh | sudo bash -s -- install --force
# 离线升级：用同一版本的两个文件覆盖旧文件后执行
sudo bash install.sh --force覆盖前旧二进制会备份为 <二进制>.bak。升级后用以下命令确认面板正常：
daxpay status
daxpay entrance show升级面板不会自动重建 DaxPay 业务容器。业务版本切换、镜像构建和业务重部署请进入面板的「部署引导」或「运维管理 → 业务环境」。
卸载
默认卸载只移除面板程序、软链、脚本和 systemd 单元，保留工作目录与业务数据：
daxpay uninstall彻底清理面板工作目录需要显式使用 --purge，并经过两次确认：
daxpay uninstall --purgeuninstall 不会自动停止或删除已部署的业务容器。若确认要清理业务环境，需另行执行：
cd /opt/daxpay
docker compose -f docker-compose.biz.yml down -v
docker compose -f docker-compose.yml down -v
docker compose -f docker-compose.gateway.yml down -v安装目录
默认工作目录为 /opt/daxpay：
/opt/daxpay/
├── installer-state.json 面板状态、账号凭据与部署快照
├── installer.db 操作审计日志（SQLite）
├── installer-initial-password.txt 首次启动生成的初始密码
├── dax-pay-installer 面板二进制
├── install.sh 管理脚本
├── docker-compose.yml 基础环境
├── .env 基础环境凭据
├── docker-compose.biz.yml 业务系统
├── .env.biz 业务系统配置
├── docker-compose.gateway.yml 网关
├── .env.gateway 网关配置
├── logs/
│ ├── installer.log 面板访问日志
│ └── installer-stdout.log 后台启动输出
└── data/ 数据卷
├── postgresql/ redis/ artemis/ 基础环境数据
├── biz/ 业务数据与运行时配置
└── nginx/ 网关配置、证书与日志