离线安装
通过离线安装包部署 Mopheus 平台，适合无法访问外网的环境。
离线安装
离线安装通过预下载的安装包部署，适合无法访问外网的环境。
前提条件
| 要求 | 说明 |
|---|---|
| 部署用户 | 专用非 root 用户（如 mopheus），Mopheus 禁止使用 root 运行部署脚本 |
| 容器运行时 | Podman 4.0+（推荐）或 Docker Engine (docker-ce) 20.10+，需要预先安装（参考 容器运行时离线安装） |
| Compose 工具 | podman compose、podman-compose、docker compose 或 docker-compose 可用 |
| 安装包 | 从发布渠道获取离线安装包 mopheus-install-<version>-linux-<arch>.tar.gz |
提示：若服务器已预装 Podman（如 RHEL / CentOS / Rocky Linux / OpenEuler），可直接使用 Podman，无需卸载 Podman 或额外安装 Docker。
安装步骤
1. 上传并解压安装包
# 以 root 身份创建安装目录并授权
mkdir -p /app/mopheus
chown mopheus:mopheus /app/mopheus
# 上传安装包到服务器（假设上传到 /tmp）
# 将 mopheus-install-<version>-linux-<arch>.tar.gz 上传至 /tmp
# 切换至 mopheus 用户解压
su - mopheus
tar -zxvf /tmp/mopheus-install-<version>-linux-<arch>.tar.gz -C /app/mopheus2. 安装镜像和 CLI 工具
cd /app/mopheus
./setup.sh install该命令有离线镜像时导入镜像，没有离线镜像时从配置的仓库拉取镜像，并安装、配置安装包中的 CLI 工具。该命令不会启动服务。
3. 初始化环境
# 初始化环境（创建 .env、数据目录、检查网络配置）
./mopheus.sh init-env4. 编辑配置
vi .env主要配置项说明：
| 变量 | 默认值 | 说明 |
|---|---|---|
FRONTEND_PORT | 3000 | 前端端口 |
BACKEND_PORT | 8080 | 后端端口 |
POSTGRES_PORT | 5432 | PostgreSQL 数据库端口 |
SWISSQL_PORT | 18080 | SwissQL 端口 |
FRONTEND_ORIGIN | — | 前端访问地址，需修改为实际 IP |
ADMIN_PASSWORD | 自动生成 | 管理员密码 |
JWT_SECRET | 自动生成 | JWT 密钥 |
MOPHEUS_IMAGE_TAG | — | 镜像版本标签 |
5. 启动服务
# 加载离线镜像并启动服务
./mopheus.sh start-server脚本会自动完成：
- 从
images/目录加载容器镜像 - 启动所有服务（前端、后端、数据库、SwissQL）
6. 端口与目录
部署完成后，前端（3000）、后端（8080）、PostgreSQL（5432）、SwissQL（18080）分别占用一个端口，所有持久化数据都保存在安装目录的 data/ 下。
完整的端口清单（含对外暴露建议）和安装目录结构说明参见端口与目录说明。
7. 检查状态
./mopheus.sh status8. 首次登录
系统初次启动时默认仅创建管理员账号：
| 账号 | 邮箱 | 密码 | 说明 |
|---|---|---|---|
| 管理员 | admin@mopheus.dev | 查看 .env 中的 ADMIN_PASSWORD | 系统最高管理权限 |
如果使用
mopheus.sh init-env初始化，脚本会自动生成随机密码并写入.env，请查看.env中的实际值。
工作区新手引导
创建工作区后，所有者在工作区仪表盘完成引导流程：
- 连接可用运行时。
- 创建或选择盘古智能体，并为其绑定运行时。
- 创建 reporter 技能。该技能不会分配给盘古。
- 服务端自动创建七张本地化引导工单。由于运行时绑定已完成，工单 01 可直接标记为 Done；完成后会解锁下一张工单。
如果工作区不需要引导，所有者可以选择并确认“跳过引导”。该操作会永久隐藏此工作区的引导，并且不会创建任何引导资源。
授权许可
Mopheus 使用专有许可证（Proprietary License），由 Enmotech 拥有所有权利。
默认许可证
系统首次启动时会自动启用内置的默认许可证，无需额外配置即可使用。默认许可证包含以下配额限制：
| 资源 | 限制 |
|---|---|
| 工作区数量 | 2 |
| 用户数量 | 5 |
| 每个工作区智能体数 | 5 |
| 每个工作区团队数 | 2 |
| 每个工作区记忆数 | 50 |
导入正式许可证
如需扩展配额或启用高级功能，可从管理后台导入正式许可证文件：
- 登录管理后台（管理员账号）
- 进入 管理 → 授权许可
- 点击 导入许可证
- 上传许可证文件或粘贴许可证代码
许可证导入后立即生效，系统会自动刷新配额限制。
许可证查询
如需获取正式许可证，请联系：
容器运行时离线安装
如果服务器尚未安装容器运行时，推荐优先安装 Podman，亦可安装开源版 Docker Engine (docker-ce)。
提示：若服务器已安装 Podman，可直接使用，无需卸载 Podman 或额外安装 Docker。
Docker 离线安装
CentOS / RHEL
# 上传 Docker 离线安装包
tar -zxvf docker-<version>.tar.gz
# 以 root 身份安装
cd docker
sudo rpm -ivh *.rpm
# 启动 Docker 并将 mopheus 用户加入 docker 组
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker mopheus
# 验证
docker --versionUbuntu / Debian
# 上传 Docker 离线安装包
tar -zxvf docker-<version>.tar.gz
# 以 root 身份安装
cd docker
sudo dpkg -i *.deb
# 启动 Docker 并将 mopheus 用户加入 docker 组
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker mopheus
# 验证
docker --versionPodman 离线配置
Podman 支持 rootless（非 root）模式运行：
# 解压 Podman 静态包（以 root 身份）
tar -zxvf podman-linux-amd64.tar.gz -C / --strip-components=1
# 切换至 mopheus 用户并启用用户 socket
su - mopheus
systemctl --user enable --now podman.socket
# 验证
podman --version