主题
手动 / 离线安装
适用于：服务器不能直连外网、需要人工审包、或由运维分步执行的场景。 整套安装逻辑都在发布包的 deploy.sh 里，手动安装就是跳过引导脚本、自己把它跑起来。
步骤
1. 取得发布包
从能上网的机器下载（版本包名见 latest.txt 的 file=）：
bash
curl -fsSL https://docs.sino.aimeld.top/latest.txt # 查看当前版本与 md5
curl -O https://docs.sino.aimeld.top/order-mgmt-v0.0.1-<版本日期>.tar.gz
curl -O https://docs.sino.aimeld.top/order-mgmt-v0.0.1-<版本日期>.tar.gz.md5也可以由服务商直接提供安装包（U 盘 / 内网共享 / 邮件均可）。
2. 传到目标服务器并校验
bash
scp order-mgmt-v0.0.1-<版本日期>.tar.gz* root@<服务器IP>:/root/在目标服务器上：
bash
cd /root
md5sum -c order-mgmt-v0.0.1-<版本日期>.tar.gz.md5 # 必须显示 OK校验值可以另渠道核对
如需更强的校验保障，可向服务商索取 latest.txt 中的 md5 值，与本地 md5sum 结果手工比对。
3. 解包并先演练
bash
tar xzf order-mgmt-v0.0.1-<版本日期>.tar.gz
cd order-mgmt
bash deploy.sh --dry-run # 只打印将执行的命令，不写文件、不改配置、不启停服务确认将要执行的内容无误后再正式安装。
4. 正式安装
bash
bash deploy.sh安装过程共 16 步：环境自检 → 目录准备 → 依赖安装 → 主库初始化 → 分片实例初始化 → 建库 → 导入表结构 → 导入基础数据 → 生成配置 → 应用文件落位 → 安装 IP 库 → 安装 systemd 服务 → 启动服务 → 许可注册 → 自检 → 完成。
依赖已经装好了怎么办
如果服务器上已经准备好 MariaDB（12.3）与 Redis，可以跳过依赖安装：
bash
bash deploy.sh --skip-deps脚本会跳过 apt 安装，只做检查与后续步骤。版本需与生产一致（MariaDB 12.3）， 否则可能缺少性能相关配置项。
服务器需要能访问软件源
首次安装时脚本需要联网安装 MariaDB 与 Redis（走操作系统软件源）。 如果服务器完全无法联网，请先由运维按下面的要求准备好依赖，再用 --skip-deps 安装：
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| MariaDB Server | 12.3 | 需与生产版本一致 |
| Redis Server | 8.x | |
| rsync | 任意 | 数据库目录迁移与静态文件同步必需 |
（如需离线依赖包或协助准备，请联系服务商。）
指定参数
手动安装时同样可以带参数，例如自定义端口/目录/许可服务地址：
bash
bash deploy.sh --port-admin 8668 --port-agent 8222 --port-openapi 8911 \
--data-dir /www --app-dir /www/order-mgmt \
--license-center http://<许可服务地址>完整参数见安装参数（deploy.sh）。
装完怎么用
与一键安装相同，见一键安装。
装完先做两件事
- 登录管理端后立即修改 admin 口令，然后删除初始口令文件。
- 云安全组只放行必要来源；数据库与 Redis 默认只监听
127.0.0.1。
重跑与幂等
重复执行 bash deploy.sh 是安全的：已存在的 config.yaml 会被复用（不会覆盖已改过的 口令/配置），表结构与基础数据按「已存在则跳过」导入。不要随手加 --force-config， 那会重新生成 config.yaml（口令随之变化）。