详细指导¶

本文档面向最终用户、实施人员、运维人员，介绍私有部署的完整流程、支持范围、常用命令与常见问题。

文档概要¶

本指南用于在全新 Linux 服务器上部署整套系统：

• IAM（认证与用户中心）
• EZtCloud
• EZtView（可选）

前置条件¶

请先阅读并确认：

• 前置条件

一次性下载安装并启动部署向导¶

mkdir -p /workspace
cd /workspace
rm -rf /workspace/isw-helper

git clone https://gitee.com/hotanzn/isw-helper.git
cd /workspace/isw-helper

python3 deploy_all.py

执行后，会启动交互式部署向导：

1. 自动探测服务器可用 IP 并供您选择。
2. 检查并自动安装基础依赖。
3. 准备必要目录和凭证文件。
4. 启动或安装 PostgreSQL 15 容器。
5. 拉取 IAM / EZtCloud / EZtView 的运行时代码。
6. 调用各项目的 deploy/install.py 完成容器编排与初始化。
7. 自动创建 IAM OAuth2 客户端并写入凭证文件。

如需无人值守，可使用 --assume-yes。

deploy_all.py 常用方式¶

全自动部署¶

cd /workspace/isw-helper
python3 deploy_all.py --assume-yes

指定部署 IP¶

python3 deploy_all.py --ip 192.168.1.100 --assume-yes

只部署 IAM + EZtCloud（不安装 EZtView）¶

python3 deploy_all.py --only-iam-eztcloud --assume-yes

自动模式下跳过 EZtView¶

python3 deploy_all.py --skip-mcq --assume-yes

凭证文件说明¶

部署过程中会生成凭证文件：

• 路径：/workspace/isw-helper/output/deploy_credentials.json
• 权限：600（仅 root 可读写）

建议部署后将该文件备份到安全位置并严格控制访问权限。

完全清理环境（cleanup_all.py）¶

如需完全卸载并回到初始状态：

cd /workspace/isw-helper
python3 cleanup_all.py

非交互清理（危险）：

python3 cleanup_all.py --assume-yes

额外删除镜像：

python3 cleanup_all.py --remove-images

常见问题¶

提示不是 root 用户¶

请先执行：

sudo -i

CentOS 7 yum 源异常（如 mirrorlist/baseurl 错误）¶

可执行修复脚本：

cd /workspace/isw-helper
bash fix_centos7_yum_repos.sh

若仍异常，请切换到可用镜像源（阿里云 / 腾讯云 / 内网镜像 / vault）后重试。

如在使用过程中遇到其他问题，请保留实际步骤与报错信息，并联系技术支持。