部署手册

环境要求

项目	要求
操作系统	Linux（建议 Ubuntu 22.04+）
权限	root 或 sudo
最低配置	4 核 CPU / 8 GB 内存
网络	需要外网访问以下载安装包和系统依赖

安装

curl -fSL https://voms.install.iluwen.cn/install.sh | sudo bash

执行后，脚本自动下载、解压并启动 Web 部署向导。

Web 部署向导详解

向导启动后，终端会输出浏览器访问地址（通常为 http://<服务器IP>:9090）。打开该地址，按步骤操作：

第 1 步：环境检测

系统自动检测当前服务器的操作系统、CPU 架构以及已安装的依赖服务，无需手动操作。

第 2 步：依赖安装

向导会列出需要安装的基础服务：

• PostgreSQL — 数据库
• Redis — 缓存
• NATS — 消息队列
• Nginx — Web 服务器与反向代理

勾选需要安装的组件，点击安装即可。如果服务器上已有对应服务，可跳过。

第 3 步：参数配置

在页面上填写以下信息：

• 数据库连接（地址、端口、用户名、密码、数据库名）
• Redis 连接
• NATS 连接
• JWT 密钥
• 管理员账号和密码
• 前端访问地址（域名或 IP）
• 服务端口

每项配置填写后可点击 连接测试 验证是否正确。

第 4 步：确认部署

检查所有配置无误后，点击 确认部署。系统将自动执行：

• 安装后端服务到 /opt/voms/
• 运行数据库迁移
• 生成生产配置文件
• 注册 systemd 服务并启动
• 配置 Nginx 反向代理
• 部署前端静态文件

第 5 步：部署完成

向导显示健康检查结果和管理员登录凭据。请妥善保存这些凭据。

部署结果

部署完成后，系统会自动创建并启用以下内容：

文件 / 服务	说明
/opt/voms/configs/config.production.json	生产配置文件
voms-server systemd 服务	后端 API 服务
voms-worker-consumer systemd 服务	异步任务消费
voms-worker-scheduler systemd 服务	定时任务调度
/etc/nginx/sites-available/voms	Nginx 站点配置
/var/www/voms	前端静态文件

验证

# 检查后端健康
curl -s http://localhost:8181/api/v1/public/system/health | jq .

# 检查服务状态
systemctl status voms-server --no-pager
systemctl status voms-worker-consumer --no-pager
systemctl status voms-worker-scheduler --no-pager

升级

收到新版本通知后，重新执行安装命令即可：

curl -fSL https://voms.install.iluwen.cn/install.sh | sudo bash

TIP

安装脚本会自动使用 --force 模式覆盖现有部署，重新执行向导完成升级。

回滚

如果新版本出现问题，可指定旧版本号回滚：

VOMS_VERSION=v1.0.0 curl -fSL https://voms.install.iluwen.cn/install.sh | sudo bash

注意事项

• 如需手动调整配置，编辑 /opt/voms/configs/config.production.json 后重启服务即可。
• 部署完成后会在安装目录生成 .deploy.lock 锁文件，防止意外重复部署。