在线安装

在线安装会下载安装包和工具包，准备容器镜像与 CLI 工具，初始化环境并启动服务，支持 Podman 与 Docker 容器运行时。

前提条件

要求	说明
部署用户	专用非 root 用户（如 `mopheus`），Mopheus 禁止使用 root 运行部署脚本
容器运行时	Podman 4.0+（推荐）或 Docker Engine (docker-ce) 20.10+，以非 root 用户权限可用
Compose 工具	`podman compose`、`podman-compose`、`docker compose` 或 `docker-compose` 可用
网络	可访问 `swr.cn-north-4.myhuaweicloud.com`（华为云镜像仓库）

提示：若您的系统（如 RHEL / CentOS / Rocky Linux / OpenEuler）已预装 Podman，可直接使用 Podman，无需卸载 Podman 或额外安装 Docker。

快速部署

1. 安装包

# 标准安装
curl -fsSL https://mopheus.obs.cn-north-4.myhuaweicloud.com/install-online.sh | bash -s -- --dir /app/mopheus

安装流程

只需执行一次在线安装脚本。脚本会下载安装包和 CLI 工具包，然后自动安装镜像和 CLI 工具、初始化环境并启动服务。

安装失败后的处理

如果在线安装脚本在安装包解压后失败，请进入安装目录，手动补执行以下步骤：

cd /app/mopheus
./setup.sh install
./mopheus.sh init-env
./mopheus.sh start-server

如果 .env 已经创建，init-env 会保留现有配置。

2. 编辑配置

安装完成后如需修改配置，请编辑 .env 并重启服务。主要配置项说明：

变量	默认值	说明
`FRONTEND_PORT`	`3000`	前端端口
`BACKEND_PORT`	`8080`	后端端口
`POSTGRES_PORT`	`5432`	PostgreSQL 数据库端口
`SWISSQL_PORT`	`18080`	SwissQL 端口
`FRONTEND_ORIGIN`	—	前端访问地址，需修改为实际 IP
`ADMIN_PASSWORD`	自动生成	管理员密码
`JWT_SECRET`	自动生成	JWT 密钥

3. 端口与目录

部署完成后，前端（3000）、后端（8080）、PostgreSQL（5432）、SwissQL（18080）分别占用一个端口，所有持久化数据都保存在安装目录的 data/ 下。

完整的端口清单（含对外暴露建议）和安装目录结构说明参见端口与目录说明。

容器用户与文件属主

后端守护进程（mopheusd）在容器内以专用非 root 用户 mopheus（UID/GID 10001）运行。容器仍以 root 启动：入口脚本先修正挂载数据目录的属主、以 root 身份执行数据库迁移，再通过 su-exec 降权后启动守护进程——因此长时间运行的进程（及其派生的所有 agent 子进程）都是非特权的。

对宿主机挂载目录（data/uploads、tools）的影响：